Intégrez les modèles d’image et de vidéo Yollomi à vos outils de création.

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

Requêtes récupérables

Utilisez une nouvelle Idempotency-Key par génération. Réutilisez la même clé et les mêmes paramètres lors des nouvelles tentatives.

Envoyez Prefer: respond-async pour recevoir la tâche enregistrée. 202 indique un traitement en cours.

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

Sans cet en-tête, l’API attend au maximum trois minutes, puis renvoie 202 si nécessaire.

Envoyez POST à statusUrl avec la même authentification pour avancer et consulter la tâche. GET lit le statut. 200 contient images ou video.

Les tâches et clés sont conservées 90 jours après leur fin ; les créations sont stockées séparément. Pour 409 GENERATION_NEEDS_REVIEW, contactez le support sans créer de doublon.

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"

Modèles API disponibles

Coûts calculés avec les paramètres par défaut. Quantité, qualité, durée, résolution, audio et vidéo source peuvent changer le total. Les modèles indisponibles sont exclus.

Modèles d’image · 25

modelId	Crédits par défaut
`flux`	4 · Variable selon les paramètres
`flux-schnell`	2 · Variable selon les paramètres
`remove-bg`	0
`flux-2-pro`	15 · Variable selon les paramètres
`flux-kontext-pro`	4
`nano-banana`	4
`nano-banana-pro`	15
`nano-banana-2`	7
`gpt-image-2`	25 · Variable selon les paramètres
`gpt-image-2-5-flare`	50 · Variable selon les paramètres
`gpt-image-2-5-sunburst`	50 · Variable selon les paramètres
`z-image-turbo`	1
`imagen-4-ultra`	6
`image-4-fast`	3
`ideogram-v3-turbo`	3
`stable-diffusion-3-5-large`	7 · Variable selon les paramètres
`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

Modèles vidéo · 16

modelId	Crédits par défaut
`openai-sora-2`	50 · Variable selon les paramètres
`google-veo-3-1`	240 · Variable selon les paramètres
`kling-2-1`	9
`minimax-hailuo-2-3`	60 · Variable selon les paramètres
`minimax-hailuo-2-3-fast`	9
`bytedance-seedance-1-pro-fast`	40 · Variable selon les paramètres
`google-veo-3-fast`	110 · Variable selon les paramètres
`google-veo-3`	250 · Variable selon les paramètres
`google-veo-3-1-fast`	120 · Variable selon les paramètres
`runway-gen4-turbo`	30 · Variable selon les paramètres
`pixverse-5`	40 · Variable selon les paramètres
`wan-2-5-i2v`	60 · Variable selon les paramètres
`wan-2-6-i2v`	80 · Variable selon les paramètres
`wan-2-5-t2v`	9
`wan-2-6-t2v`	29 · Variable selon les paramètres
`kling-v2-6-motion-control`	70 · Variable selon les paramètres

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