Kagu

名称	密钥	分组	余额	已用	状态	操作

ID	用户名	分组	密钥数	余额	已用	状态	注册时间	操作

日志筛选

兑换码	金额	备注	状态	使用者	创建时间	操作

认证方式

登录使用 JWT token；API 请求使用用户自行生成的 API Key：

Authorization: Bearer sk-xxxxxxxxxxxxxxxx

OpenAI 兼容

POST/v1/images/generationsOpenAI 格式

curl -X POST {base}/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxx" \
  -d '{"prompt": "a cat", "model": "banana-pro", "size": "1024x1024", "response_format": "url", "reference_image_urls": ["https://your-image-url.jpg"]}'

Gemini Native 生图

POST/v1beta/models/{model}:generateContentGemini 原生格式

curl -X POST {base}/v1beta/models/gemini-3.1-flash-image-preview:generateContent   -H "Content-Type: application/json"   -H "Authorization: Bearer sk-xxx"   -d '{
    "contents": [{"role": "user", "parts": [{"text": "a cute cat"}]}],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {"aspectRatio": "1:1", "imageSize": "2K"}
    }
  }'

参数	类型	必填	说明
contents	array	是	Gemini 标准 contents 数组，parts 里 text 为提示词，inlineData 为参考图
generationConfig.responseModalities	array	否	默认 ["TEXT", "IMAGE"]
generationConfig.imageConfig.aspectRatio	string	否	1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 2:3 / 3:2 / auto 等
generationConfig.imageConfig.imageSize	string	否	1K / 2K / 4K，决定分辨率（默认 2K）

支持模型：gemini-3.1-flash-image-preview / gemini-3-pro-image-preview / gemini-2.0-flash-preview-image

鉴权：Authorization: Bearer sk-xxx 或 X-Goog-API-Key: sk-xxx

返回：

{"candidates": [{"content": {"parts": [{"text": "..."}], "role": "model"}, "finishReason": "STOP"}], "task_id": "xxx", "status": "processing", "poll_url": "/v1/status/xxx"}

轮询使用 GET /v1/status/{task_id}，结果与普通图片任务相同

图片生成

POST/v1/generate文生图（JSON）

curl -X POST {base}/v1/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxx" \
  -d '{
    "prompt": "a cute cat",
    "model": "banana-pro",
    "aspect_ratio": "1:1",
    "response_format": "base64"
  }'

参数	类型	必填	说明
prompt	string	是	提示词
model	string	是	见 /v1/models 返回的模型列表（banana-pro-1k / banana-pro-2k / gpt-image-2-2k 等；image2_1k 是 gpt-image-2-1k 别名）
aspect_ratio	string	否	1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3
resolution	string	否	可选，不传则根据模型自动选择（每个模型 ID 已包含分辨率后缀，如 banana-pro-2k→2K）
response_format	string	否	base64 / url，默认 base64；url 返回可直接访问的图片链接
reference_image_urls	array	否	参考图列表，支持自定义图片 URL 和上传返回的 UUID 混传

返回：{"task_id": "xxx", "status": "pending", "model": "...", "cost": 0.20}

图生图（Multipart）

POST/v1/images/edits上传参考图 + 提示词

curl -X POST {base}/v1/images/edits \
  -H "Authorization: Bearer sk-xxx" \
  -F "prompt=a cat wearing sunglasses" \
  -F "model=banana-pro" \
  -F "aspect_ratio=1:1" \
  -F "response_format=url" \
  -F "[email protected]"

参数	类型	必填	说明
prompt	string	是	提示词
model	string	否	模型 ID
image	file	二选一	单张参考图
images	file[]	二选一	多张参考图，最多 5 张
aspect_ratio	string	否	宽高比
response_format	string	否	base64 / url，默认 base64
reference_image_urls	array	否	参考图列表，支持自定义图片 URL 和上传返回的 UUID 混传

查询图片状态

GET/v1/status/{task_id}轮询生成结果

curl {base}/v1/status/{task_id} \
  -H "Authorization: Bearer sk-xxx"

成功：{"status":"completed","images":[{"b64_json":"..."}]} 或 {"images":[{"url":"..."}]}
失败：{"status":"failed","error":"..."}
排队/进行中：{"status":"pending"} / {"status":"processing"}

视频生成

POST/v1/video/generate视频生成（JSON）

# Seedance-2 / Seedance-2-Fast
curl -X POST {base}/v1/video/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxx" \
  -d '{
    "model": "seedance-2",
    "prompt": "a cat walking",
    "duration": 5,
    "ratio": "16:9",
    "resolution": "480p"
  }'

模型	专属参数
seedance-2 seedance-2-fast	duration (4-15秒, 默认5), ratio (16:9/9:16/1:1/21:9/4:3/3:4), resolution (480p/720p), image, last_frame_image, reference_images[], reference_videos[], reference_audios[]
sora-2	seconds (4/8/12秒, 默认4), size (16x9/9x16/1x1), image
grok-video	duration (3-15秒, 默认5), aspect_ratio, resolution (720p), image
veo-3.1	固定5秒, aspect_ratio (16:9/9:16), resolution (720p), image
happy-horse	duration (3-15秒, 默认3), ratio (16:9/9:16/1:1/4:3/3:4), resolution (720P/1080P), image (首帧图), reference_images[] (最多9张), video_url (参考视频), audio_setting (auto/origin)

image / reference_images 等字段传 media ID（通过 /v1/video/upload 获取）

视频文件上传

POST/v1/video/upload上传图片/视频获取 media ID

curl -X POST {base}/v1/video/upload \
  -H "Authorization: Bearer sk-xxx" \
  -F "[email protected]"

返回：{"id": "xxxxxxxx-xxxx-..."}

查询视频状态

POST/v1/video/status批量查询视频任务

curl -X POST {base}/v1/video/status \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxx" \
  -d '{"task_ids": ["task_id_1", "task_id_2"]}'

返回：{"tasks": [{"task_id":"...","status":"completed","media_url":"..."}]}

媒体下载

GET/v1/media/{media_id}下载生成的视频/图片

curl -O {base}/v1/media/{media_id} \
  -H "Authorization: Bearer sk-xxx"

余额查询

GET/v1/balance

curl {base}/v1/balance \
  -H "Authorization: Bearer sk-xxx"

{"balance":10.00,"used":2.50,"frozen":0.20}

模型列表

GET/v1/models

curl {base}/v1/models

{"models":[{"id":"banana-pro","type":"image",...}]}

稳定性查询

GET/v1/stability?hours=24模型成功率 / 失败率 / 平均耗时

curl {base}/v1/stability?hours=24

健康检查

GET/health

curl {base}/health

{"status":"ok","time":1234567890}

模型稳定性

加载中...

稳定性查询

按任务日志统计最近窗口内的模型成功率、失败率和平均耗时

模型	类型	状态	历史	成功率	平均耗时

密钥

模型

提示词

宽高比

返回格式

参考图（可选）

图片点击或拖拽上传参考图片

宽高比

时长

分辨率

起始帧（可选）

图片起始帧

结束帧（可选）

图片结束帧

cURL 请求

填写参数后自动生成 cURL 命令...

结果

等待生成...

创建 API 密钥

新建分组

编辑密钥

修改密码

批量生成兑换码

调整用户余额