API Documentation

All 501 models on sale are available through one Bearer-token endpoint. The API is compatible with kie.ai paths — existing code keeps working if you change the host.

Authentication

Every call requires a Bearer token from your dashboard.

Authorization: Bearer sk-aig-YOUR_KEY

Base URL

All endpoints are served from https://aimarcusimage.eu/api/v1/

Every image, video and music model uses the same create-task request: the catalog slug goes in model, the model's fields go in input. The slug and its price are on each model page in the catalog.

Image generation (Flux, Nano Banana, GPT Image)

curl https://aimarcusimage.eu/api/v1/jobs/createTask \
  -H "Authorization: Bearer sk-aig-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-kontext-pro",
    "input": { "prompt": "A red fox sitting in snow, golden hour", "aspect_ratio": "16:9" }
  }'

# Response: { "code": 200, "data": { "taskId": "..." } }
# Then poll the status endpoint (see Task status).

Video generation (Veo, Runway, Seedance)

curl https://aimarcusimage.eu/api/v1/jobs/createTask \
  -H "Authorization: Bearer sk-aig-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google-google-veo-3-1-text-to-video-fast-1080p",
    "input": { "prompt": "A golden retriever running through autumn leaves", "aspect_ratio": "16:9" }
  }'

Music generation (Suno)

curl https://aimarcusimage.eu/api/v1/jobs/createTask \
  -H "Authorization: Bearer sk-aig-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-suno-generate-music",
    "input": { "prompt": "upbeat synthwave, driving bass, retro vibes" }
  }'

Task status

Long-running tasks (video, music, image) return a taskId. Poll the status endpoint every 3-5 seconds until the result is ready, or add callBackUrl next to model in the create-task body to get a POST when the task finishes (details).

curl "https://aimarcusimage.eu/api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID" \
  -H "Authorization: Bearer sk-aig-..."

Credits & billing

Each call consumes credits based on the model's price. The charged amount is returned in the X-AI-Credits-Charged response header and the remaining balance in X-AI-Credits-Balance.

Error codes

Code	Meaning
401 missing_api_key	No Bearer token in Authorization header.
401 invalid_api_key	The key was revoked or doesn't exist.
402 insufficient_credits	Not enough credits to complete the call. Top up.
429 rate_limited	Too many requests (limit: 20 / 10 seconds per key).
502 upstream_error	Provider returned an error. Check logs in dashboard.

Rate limits

20 new generation requests per 10 seconds per API key. Polling task status does not count against the limit.

Price guides

Comparisons built from the live price list, so the numbers match what the API charges today.