AutoFeed API

AI Image Generation API

Send a prompt and pick a model. AutoFeed runs it, stores the image and returns its URL, with the same credits and webhooks as every video type.

What the AI Image API returns

  • 33 image models from 11 makers
  • Vertical, square, horizontal and more, per model
  • Priced per image and quality, the same as the dashboard
  • One generation is one image at url

One Request

This exact body passes the live API schema and costs 135 credits, the same as making it in the dashboard.

Request
curl -X POST https://www.autofeed.ai/api/v1/videos \
-H "Authorization: Bearer $AUTOFEED_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "ai_image",
"input": {
"model": "nano-banana-2-1",
"prompt": "A cozy coffee shop on a rainy evening, warm light, photoreal",
"ratio": "9:16"
},
"webhookUrl": "https://example.com/webhooks/autofeed",
"idempotencyKey": "order-1042-ai-image"
}'
202 Accepted
{
"id": "1c9d6c3e-1f5b-4d2e-9c31-2b8b0f0f9a11",
"type": "ai_image",
"status": "processing",
"costInCredits": 135,
"createdAt": "2026-11-02T12:00:00.000Z"
}
Webhook: video.completed
{
"id": "1c9d6c3e-1f5b-4d2e-9c31-2b8b0f0f9a11",
"type": "ai_image",
"status": "completed",
"error": null,
"costInCredits": 135,
"createdAt": "2026-11-02T12:00:00.000Z",
"completedAt": "2026-11-02T12:03:41.000Z",
"url": "https://.../1c9d6c3e-1f5b-4d2e-9c31-2b8b0f0f9a11.mp4"
}

Every Input Field

Read from the API's own schema. Unknown fields are rejected with a 400, never silently dropped.

FieldTypeDefaultNotes
modelrequiredone of 33 values-The model id, exactly as listed in aiImageModels from GET /v1/types.
promptrequiredstring (max 4000)-What the image shows. Up to 4000 characters.
ratiostring (max 16)-One of the model's ratios. Defaults to its first.
qualitystring (max 32)-One of the model's qualities (a resolution or a quality level). Price-bearing. Defaults to the one the dashboard starts on.

What It Costs

The API is included with Ultimate and spends the same credits as the dashboard. Ultimate's 180k monthly credits cover about 1,333 requests like the one above. Rendered files are kept for 14 days.

See every Ultimate size →

AI Image API Questions

How do I get several images?

Send one request per image. Each is its own generation with its own id, price and webhook, so one refused prompt fails only that image.

What if the model refuses my prompt?

The generation fails with an error saying so, and its credits are refunded automatically.

How is an AI image billed?

From the same credit balance as the dashboard, at the same price per video. The cost is in the 202 response before any work starts, and a failed render refunds it.

Other Video Types in the API