Image API - 图片 & 视频生成

余额查询

稳定性查询

查看各模型近期成功率、失败率、平均耗时和历史状态

点击查询加载数据

调用流程

提交任务POST /v1/generate
POST /v1/video/generate

→

获取 task_id返回任务 ID
费用已冻结

→

轮询状态GET /v1/status/{id}
POST /v1/video/status

→

获取结果file.kagu.one 图片
file.kagu.one 视频

接口文档

所有接口需要 Authorization: Bearer sk-xxx 请求头

图片

POST/v1/generate文生图（JSON body）▶

参数	类型		说明
prompt	string	必填	图片描述
model	string	可选	banana-pro-1k/2k/4k、banana-2-1k/2k/4k、gpt-image-2-1k/2k/4k（image2_1k 是 gpt-image-2-1k 别名）
aspect_ratio	string	可选	官方支持值按模型校验；错误值会直接返回
size	string	可选	支持 auto、1K/2K/4K、比例值、以及官方像素尺寸；错误值会直接返回
reference_image_urls	string[]	可选	参考图 URL，可传多张；Banana 全系最多 14 张，Image2 最多 10 张

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

curl -X POST https://image.kagu.one/v1/generate \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"银发少女在樱花树下","model":"banana-2-2k","aspect_ratio":"1:1"}'

POST/v1/images/edits图生图（multipart/form-data）▶

参数	类型		说明
image	file	二选一	单张参考图
images	file[]	二选一	多张参考图；Banana 全系最多 14 张，Image2 最多 10 张
prompt	string	可选	图片描述，默认自动生成
model	string	可选	模型 ID，默认 banana-pro
aspect_ratio	string	可选	宽高比，默认 1:1

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

# 单张参考图
curl -X POST https://image.kagu.one/v1/images/edits \
  -H "Authorization: Bearer sk-xxx" \
  -F "[email protected]" \
  -F "prompt=提取人物" \
  -F "model=banana-2-2k"

# 多张参考图
curl -X POST https://image.kagu.one/v1/images/edits \
  -H "Authorization: Bearer sk-xxx" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "prompt=融合风格" \
  -F "model=banana-2-2k"

GET/v1/status/{task_id}图片任务状态▶

返回 status（pending / processing / completed / failed）
完成时包含 images 数组（每项含 b64_json、width、height）

curl https://image.kagu.one/v1/status/abc123def456 \
  -H "Authorization: Bearer sk-xxx"

视频

POST/v1/video/generate视频生成▶

参数	类型		说明
model	string	必填	seedance-2 / seedance-2-fast
prompt	string	必填	视频描述
enhance_prompt	bool	可选	AI 优化提示词
image	string	可选	参照图 media UUID（首帧图）

Seedance 2.0 / Fast — duration · ratio(16:9/9:16/1:1/21:9/4:3/3:4) · resolution(480p/720p) · generate_audio · last_frame_image · reference_images(最多9) · reference_image_urls(多图 URL)

curl -X POST https://image.kagu.one/v1/video/generate \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedance-2-fast","prompt":"猫在草地上奔跑","duration":5,"ratio":"16:9","resolution":"480p"}'

POST/v1/video/upload上传参考素材 → 返回 media UUID▶

multipart/form-data 上传文件（图片/视频/音频）
返回 {"id":"media-uuid"}，用于 video/generate 的 image 参数

curl -X POST https://image.kagu.one/v1/video/upload \
  -H "Authorization: Bearer sk-xxx" \
  -F "[email protected]"

POST/v1/video/status轮询视频任务▶

Body: {"task_ids":["uuid1","uuid2"]}
返回 {"tasks":[{"task_id":"...","status":"success","media_url":"/v1/media/xxx"}]}

curl -X POST https://image.kagu.one/v1/video/status \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{"task_ids":["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"]}'

GET/v1/media/{id}媒体代理（获取视频/图片）▶

无需鉴权，直接返回媒体内容（video/mp4 等），可在浏览器打开或下载

curl https://image.kagu.one/v1/media/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
  --output video.mp4

通用

GET/v1/balance查询余额▶

返回 {"balance": 4.96}

curl https://image.kagu.one/v1/balance \
  -H "Authorization: Bearer sk-xxx"

GET/v1/models图片模型列表▶

无需鉴权，返回图片模型列表及参数范围

curl https://image.kagu.one/v1/models

GET/v1/video/models视频模型列表▶

无需鉴权，返回视频模型列表

curl https://image.kagu.one/v1/video/models

GET/health健康检查▶

无需鉴权，返回服务状态和支持的模型列表

curl https://image.kagu.one/health