Подключите модели изображений и видео Yollomi к своим творческим инструментам.

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

Возобновляемые запросы

Для новой генерации используйте новый Idempotency-Key. При повторе сохраняйте тот же ключ и параметры.

Prefer: respond-async позволяет сразу получить сохранённую задачу. 202 означает обработку.

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"}

Без этого заголовка API ждёт до трёх минут и возвращает 202, если задача ещё выполняется.

Отправьте POST на statusUrl с прежней авторизацией для продолжения и проверки задачи. GET только читает статус. 200 содержит images или video.

Задачи и ключи хранятся 90 дней после завершения. Работы сохраняются отдельно. При 409 GENERATION_NEEDS_REVIEW обратитесь в поддержку без повторной отправки.

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"

Доступные модели API

Стоимость рассчитана для настроек по умолчанию. Количество, качество, длительность, разрешение, звук и входное видео могут изменить итог. Недоступные модели не включены.

Модели изображений · 25

modelId	Кредиты по умолчанию
`flux`	4 · Зависит от настроек
`flux-schnell`	2 · Зависит от настроек
`remove-bg`	0
`flux-2-pro`	15 · Зависит от настроек
`flux-kontext-pro`	4
`nano-banana`	4
`nano-banana-pro`	15
`nano-banana-2`	7
`gpt-image-2`	25 · Зависит от настроек
`gpt-image-2-5-flare`	50 · Зависит от настроек
`gpt-image-2-5-sunburst`	50 · Зависит от настроек
`z-image-turbo`	1
`imagen-4-ultra`	6
`image-4-fast`	3
`ideogram-v3-turbo`	3
`stable-diffusion-3-5-large`	7 · Зависит от настроек
`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

Видеомодели · 16

modelId	Кредиты по умолчанию
`openai-sora-2`	50 · Зависит от настроек
`google-veo-3-1`	240 · Зависит от настроек
`kling-2-1`	9
`minimax-hailuo-2-3`	60 · Зависит от настроек
`minimax-hailuo-2-3-fast`	9
`bytedance-seedance-1-pro-fast`	40 · Зависит от настроек
`google-veo-3-fast`	110 · Зависит от настроек
`google-veo-3`	250 · Зависит от настроек
`google-veo-3-1-fast`	120 · Зависит от настроек
`runway-gen4-turbo`	30 · Зависит от настроек
`pixverse-5`	40 · Зависит от настроек
`wan-2-5-i2v`	60 · Зависит от настроек
`wan-2-6-i2v`	80 · Зависит от настроек
`wan-2-5-t2v`	9
`wan-2-6-t2v`	29 · Зависит от настроек
`kling-v2-6-motion-control`	70 · Зависит от настроек

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