Quickstart

Get started in 5 minutes

Step 1: Create Account

Step 2: Generate API Key

Navigate to your dashboard and create an API key. Save it securely - it's only shown once.

Step 3: Make Your First Request

Use the universal Router format generation endpoint. Compatible with standard SDKs for easy integration!

curl https://api.arcada.dev/api/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_format": "text",
    "output_format": "website",
    "messages": [
      {
        "role": "user",
        "content": "Create a landing page for a coffee shop"
      }
    ]
  }'

Using Standard SDK (Python Example)

import requests

response = requests.post(
    "https://api.arcada.dev/api/v1/generate",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "input_format": "text",  # Required: input type
        "output_format": "website",  # Required: output type
        "messages": [
            {"role": "user", "content": "Create a landing page"}
        ]
    }
)

result = response.json()
print(result["choices"][0]["message"]["content"])

Multimodal Example: Image-to-Image

import requests
import base64

# Read image and convert to base64
with open("input.jpg", "rb") as f:
    image_base64 = base64.b64encode(f.read()).decode()

response = requests.post(
    "https://api.arcada.dev/api/v1/generate",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "input_format": "image",
        "output_format": "image",
        "messages": [
            {"role": "user", "content": "Transform this into a watercolor painting"}
        ],
        "input_image": f"data:image/jpeg;base64,{image_base64}"  # Required for image-to-image
    }
)

result = response.json()
image_url = result["choices"][0]["message"]["image_url"]
print(f"Generated image: {image_url}")