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

不发送此请求头时，接口最多等待三分钟；仍未完成则返回 202。

使用相同鉴权对返回的 statusUrl 发送 POST，推进并查询任务。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