Integra los modelos de imagen y vídeo de Yollomi en tus herramientas creativas.

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

Solicitudes recuperables

Usa una nueva Idempotency-Key por generación. Reutiliza la misma clave y parámetros al reintentar.

Envía Prefer: respond-async para recibir la tarea guardada. 202 significa que sigue procesándose.

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

Sin esta cabecera, la API espera hasta tres minutos y devuelve 202 si no ha terminado.

Envía POST a statusUrl con la misma autenticación para avanzar y consultar la tarea. GET solo lee el estado. 200 contiene images o video.

Las tareas y claves se conservan 90 días tras finalizar; las creaciones se guardan aparte. Ante 409 GENERATION_NEEDS_REVIEW, contacta con soporte sin duplicar la solicitud.

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"

Modelos API disponibles

Costes con los parámetros predeterminados. Cantidad, calidad, duración, resolución, audio y vídeo de entrada pueden cambiar el total. Se excluyen los modelos no disponibles.

Modelos de imagen · 25

modelId	Créditos por defecto
`flux`	4 · Varía según los parámetros
`flux-schnell`	2 · Varía según los parámetros
`remove-bg`	0
`flux-2-pro`	15 · Varía según los parámetros
`flux-kontext-pro`	4
`nano-banana`	4
`nano-banana-pro`	15
`nano-banana-2`	7
`gpt-image-2`	25 · Varía según los parámetros
`gpt-image-2-5-flare`	50 · Varía según los parámetros
`gpt-image-2-5-sunburst`	50 · Varía según los parámetros
`z-image-turbo`	1
`imagen-4-ultra`	6
`image-4-fast`	3
`ideogram-v3-turbo`	3
`stable-diffusion-3-5-large`	7 · Varía según los parámetros
`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

Modelos de vídeo · 16

modelId	Créditos por defecto
`openai-sora-2`	50 · Varía según los parámetros
`google-veo-3-1`	240 · Varía según los parámetros
`kling-2-1`	9
`minimax-hailuo-2-3`	60 · Varía según los parámetros
`minimax-hailuo-2-3-fast`	9
`bytedance-seedance-1-pro-fast`	40 · Varía según los parámetros
`google-veo-3-fast`	110 · Varía según los parámetros
`google-veo-3`	250 · Varía según los parámetros
`google-veo-3-1-fast`	120 · Varía según los parámetros
`runway-gen4-turbo`	30 · Varía según los parámetros
`pixverse-5`	40 · Varía según los parámetros
`wan-2-5-i2v`	60 · Varía según los parámetros
`wan-2-6-i2v`	80 · Varía según los parámetros
`wan-2-5-t2v`	9
`wan-2-6-t2v`	29 · Varía según los parámetros
`kling-v2-6-motion-control`	70 · Varía según los parámetros

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