Bring Yollomi image and video models into your own creative tools.

API Documentation

Use your API key to integrate AI image and video generation into your applications. All models use a single unified endpoint.

Authentication

All API requests require authentication. Include your API key in one of these ways:

1. Authorization header (recommended)

Authorization: Bearer YOUR_API_KEY

2. X-API-Key header

X-API-Key: YOUR_API_KEY

Create and manage your API keys in the

Unified Endpoint

Single endpoint for all models. Set type to "image" or "video" and modelId to the model name.

POST https://yollomi.com/api/v1/generate
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "type": "image",
  "modelId": "flux",
  "prompt": "A magical forest with glowing mushrooms",
  "aspectRatio": "1:1",
  "numOutputs": 1
}

Common parameters:

type (required): "image" or "video"
modelId (required): Model identifier (see list below)
aspectRatio: 1:1, 16:9, 9:16
Other params: prompt, imageUrl, numOutputs, outputFormat, etc.

Response (image):

{ "images": ["https://..."], "remainingCredits": 96 }

Response (video):

{ "video": "https://...", "remainingCredits": 91 }

Get available models: GET https://yollomi.com/api/v1/models

Recoverable generation requests

Use a new Idempotency-Key for each generation. Retries must reuse the same key and settings.

Send Prefer: respond-async to receive a saved task immediately. HTTP 202 means processing, not a finished file.

POST /api/v1/generate
Authorization: Bearer YOUR_API_KEY
Idempotency-Key: 87e2af90-40bc-4a61-a190-8a90050e9191
Prefer: respond-async
Content-Type: application/json

{"type":"image","modelId":"flux-schnell","prompt":"A studio product photo"}

HTTP 202
{"jobId":"TASK_UUID","status":"processing","statusUrl":"/api/generation/jobs/TASK_UUID"}

POST /api/generation/jobs/TASK_UUID
Authorization: Bearer YOUR_API_KEY

HTTP 200
{"images":["https://your-media-domain/result.png"],"remainingCredits":8,"jobId":"TASK_UUID"}

Without this header, the API waits up to three minutes, then returns 202 if still processing.

POST the returned statusUrl with the same authentication to advance and query the task. GET only reads status. HTTP 200 contains images or video.

Task records and keys remain for 90 days after completion; creations are stored separately. For 409 GENERATION_NEEDS_REVIEW, contact support without submitting another task.

yollomi tasks
yollomi task TASK_UUID
# Reuse a request ID when retrying an interrupted initial submission:
YOLLOMI_REQUEST_ID=87e2af90-40bc-4a61-a190-8a90050e9191 yollomi image "A studio product photo"

Available API models

These costs use the default request settings. Output count, quality, duration, resolution, audio and video inputs may change the total. Models marked unavailable are excluded from this list.

Image models · 25

modelId	Default credits
`flux`	4 · Varies with settings
`flux-schnell`	2 · Varies with settings
`remove-bg`	0
`flux-2-pro`	15 · Varies with settings
`flux-kontext-pro`	4
`nano-banana`	4
`nano-banana-pro`	15
`nano-banana-2`	7
`gpt-image-2`	25 · Varies with settings
`gpt-image-2-5-flare`	50 · Varies with settings
`gpt-image-2-5-sunburst`	50 · Varies with settings
`z-image-turbo`	1
`imagen-4-ultra`	6
`image-4-fast`	3
`ideogram-v3-turbo`	3
`stable-diffusion-3-5-large`	7 · Varies with settings
`seedream-4-5`	4
`seedream-5-lite`	4
`object-remover`	3
`image-upscaler`	1
`photo-restoration`	4
`qwen-image-edit`	3
`qwen-image-edit-plus`	3
`virtual-try-on`	3
`ai-background-generator`	5

Video models · 16

modelId	Default credits
`openai-sora-2`	50 · Varies with settings
`google-veo-3-1`	240 · Varies with settings
`kling-2-1`	9
`minimax-hailuo-2-3`	60 · Varies with settings
`minimax-hailuo-2-3-fast`	9
`bytedance-seedance-1-pro-fast`	40 · Varies with settings
`google-veo-3-fast`	110 · Varies with settings
`google-veo-3`	250 · Varies with settings
`google-veo-3-1-fast`	120 · Varies with settings
`runway-gen4-turbo`	30 · Varies with settings
`pixverse-5`	40 · Varies with settings
`wan-2-5-i2v`	60 · Varies with settings
`wan-2-6-i2v`	80 · Varies with settings
`wan-2-5-t2v`	9
`wan-2-6-t2v`	29 · Varies with settings
`kling-v2-6-motion-control`	70 · Varies with settings

Error Responses

Common HTTP status codes

401 – Invalid or missing API key

402 – Insufficient credits

400 – Invalid request (missing modelId, invalid params)

500 – Server error