API
Seedream 5.0 Pro API
图片Seedream 5.0 Pro API 支持文生图和参考图片编辑，提供灵活的宽高比以及 1K、2K 输出。
Body
application/jsonmodelstring必填seedream-5-0-proinput.promptstring必填描述您希望生成的图片，或需要对参考图片进行的修改。首尾空白字符会被自动移除。
input.imagesstring[]可选可选参考图片 URL 列表。仅支持可公开访问的 HTTPS 图片链接。文生图时可省略。
最多 16 项。
input.aspect_ratiostring可选输出图片的宽高比，默认为 1:1。
默认值: 1:1
1:116:99:163:22:33:44:321:9
input.resolutionstring可选输出图片分辨率。使用小写值 1k 或 2k，默认为 1k。
默认值: 1k
1k2k
请求示例
POST /api/v1/createcurl -X POST https://nanobanana.io/api/v1/create \
-H "Authorization: Bearer sk_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream-5-0-pro",
"input": {
"prompt": "一张未来感香蕉造型相机的电影级产品摄影",
"aspect_ratio": "1:1",
"resolution": "1k"
}
}'POST /api/v1/create · HTTP 201{
"data": {
"task_id": "task_example",
"model": "seedream-5-0-pro",
"status": "processing",
"credits": 50
}
}使用返回的任务 ID 轮询此 Endpoint，直到任务完成或失败。建议每 5 秒轮询一次，以获取最新任务状态。
POST /api/v1/check{
"task_id": "task_example"
}响应
POST /api/v1/check 返回的任务状态。以下 ID、URL 和时间戳仅用于示例。
idstring必填data.id 为任务标识，与查询请求中的 task_id 一致。
statusstring必填completed 表示生成成功，data.data 包含生成结果；其他状态下 data.data 为 null。
failed_reasonstring可选仅当 status 为 failed 时返回，用于说明失败原因。completed 和 processing 状态不包含此字段。
已完成 · completed
下载链接位于 data.data.results。
POST /api/v1/check · HTTP 200{
"data": {
"id": "task_example",
"created_at": 1791244800,
"model": "seedream-5-0-pro",
"status": "completed",
"data": {
"results": [
"https://example.com/generated.png"
],
"processing_time": 18
}
}
}其他状态
processing 或 failed 状态下，data.data 为 null。以下以 failed 为例：只有 failed 才包含 failed_reason。processing 时继续轮询，failed 时停止轮询。
POST /api/v1/check · HTTP 200{
"data": {
"id": "task_example",
"created_at": 1791244800,
"model": "seedream-5-0-pro",
"status": "failed",
"data": null,
"failed_reason": "Generation failed."
}
}积分消耗
以下积分按单次请求生成一张图片计算。
| 分辨率 | 1K | 2K |
|---|---|---|
| 单张图片 | 50 | 100 |
省略可选参数: 50 积分
请显式传入表格列出的 input 参数，以使用对应档位。一次生成多张图片时，积分消耗可能增加。
POST /api/v1/create 响应中的 credits 字段为该任务实际扣除的积分。