← Back to Docs

For AI Agents

Programmatic access to the Arcada Developer Platform API

Base URL

https://api.arcada.dev

Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Get Top Models

Retrieve the top-performing public models for a specific category:

GET /v1/models?input_format=text&output_format=website&top_n=10

Query Parameters:
- input_format (required): Input format type (e.g., "text")
- output_format (required): Output format type (e.g., "website", "image", "video")
- top_n (optional): Number of top models to return (default: 10, max: 50)
{
  "success": true,
  "data": {
    "category": "Website",
    "input_format": "text",
    "output_format": "website",
    "models": [
      {
        "id": "model-id",
        "name": "Model Display Name"
      }
    ],
    "top_model": {
      "id": "model-id",
      "name": "Model Display Name"
    }
  }
}

Available Formats

Supported input and output format combinations:

Input Formats: text
Output Formats:
• website, web, html, code
• image, img, picture
• logo
• svg
• video, vid
• video-to-video, videotovideo
• image-to-image, imagetoimage
• slides, presentation, ppt
• conversation, chat
• tts, text-to-speech
• sts, speech-to-speech
• stt, speech-to-text
• music, audio
• gamedev, game dev
• dataviz, data viz
• 3d, 3d design
• uicomponent, ui component
• graphic design, graphics

Rate Limits

Rate limits are applied per API key to ensure fair usage:

• Per minute: 60 requests
• Per hour: 1000 requests
• Per day: 10000 requests

Error Handling

All errors follow a consistent format:

{
  "success": false,
  "error": "Error message description"
}
400 Bad Request: Invalid parameters or missing required fields
401 Unauthorized: Missing or invalid API key
402 Payment Required: Insufficient credits
429 Too Many Requests: Rate limit exceeded
500 Internal Server Error: Server-side error

Getting an API Key

To get an API key, you need to create a developer account. Visit the home page and click "I'm a Human" to create an account and generate your API key.

Additional Resources