Nano Banana 2
通过异步媒体任务，使用 Nano Banana 2 生成或转换图片。
Nano Banana 2 支持文生图和最多 14 张参考图的图生图任务，并提供 fast / pro 两种模式。
模型信息
| 项目 | 值 |
|---|---|
| 模型 ID | nano-banana-2 |
| 端点 | POST /v1/router/task/create |
| 任务类型 | Txt2Img、Img2Img |
| 调用方式 | 异步创建任务，随后轮询结果 |
异步任务流程
- 准备输入素材。图生图输入必须是公网可访问的 HTTPS 直链，最多传入 14 张 jpeg/png/webp 图片，每张不超过 30MB。本地文件、Base64 / Data URL 或已有远程 URL，可以通过 U-Token 通用币 文件上传转为公开
fileUrl。不得直接传入asset://、s3://、file://或内网地址。 - 创建任务。将下文说明的
task、model、mode和input字段发送到POST /v1/router/task/create。响应只保证返回tsk_*格式的平台task_id；其他成功字段来自当前上游，不能作为固定结构依赖。可选的callback_url会在任务结束时接收签名回调，见媒体任务回调。这个地址不会转发给上游。 - 轮询或取消。保存
task_id，每 3–5 秒调用一次GET /v1/router/tasks/{task_id}。如需停止排队中或处理中的任务，将{"task_id":"tsk_..."}发送到POST /v1/router/task/stop。API Key 只能查询或取消同一买家创建的任务。 - 读取结果。持续轮询，直到任务进入终态：
| 状态 | 含义 |
|---|---|
0 | 排队中——已提交，等待调度 |
1 | 处理中——模型正在生成 |
2 | 已完成——结果通常位于 results[].urls，cost 为你的价格（积分） |
3 | 失败——占用金额会释放，不会结算扣费 |
4 | 已取消——占用金额会释放，不会结算扣费 |
失败响应统一为中性错误，不暴露上游详情。请使用 Provider error (request id: aitk-...) 中的 request id 关联服务端日志；不要依赖 error_message、fail_reason 或 message 获取上游诊断。下方固定价格会在创建任务时锁定，并在请求上游前从可用余额中暂时占用。只有任务成功后才会结算；失败或取消只释放占用金额，不会扣费。上游真实成本不决定买家价格。
结果链接有效期约 24 小时，请及时下载保存。
Txt2Img 和 Img2Img 都使用 model="nano-banana-2"。顶层 mode 支持 fast 或 pro，省略时默认 pro，并原样透传上游。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
task | string | 是 | 文生图用 Txt2Img，图生图用 Img2Img |
model | string | 是 | 固定为 nano-banana-2 |
mode | string | 否 | fast 或 pro，默认 pro |
input.prompt | string | 是 | 图片生成或编辑提示词 |
input.images | string[] | 图生图是 | 1–14 个公网 HTTPS 图片 URL |
input.aspect_ratio | string | 是 | 从下方支持列表中选择，不支持 auto |
input.resolution | string | 是 | fast：2K / 4K；pro：1K / 2K / 4K |
input.output_format | string | 否 | jpg 或 png |
callback_url | string | 否 | 可选的公网 HTTPS 回调地址。见媒体任务回调。 |
aspect_ratio 支持以下值：
1:1、1:4、1:8、2:3、3:2、3:4、4:1、4:3、4:5、5:4、8:1、9:16、16:9、21:9
fast 支持 2K、4K，pro 支持 1K、2K、4K。output_format 支持 jpg、png。图生图 images 最多接受 14 个公网 HTTPS URL。
固定价格
官方价格单位为积分 / 任务；实际扣费为表价 × 你的配置系数。
| 模式 | 任务 | 1K | 2K | 4K |
|---|---|---|---|---|
fast | Txt2Img / Img2Img | 不支持 | 5 | 8 |
pro | Txt2Img | 7 | 10 | 15 |
pro | Img2Img | 7 | 11 | 16 |
请求示例
# 文生图
curl https://u-token.ai/v1/router/task/create \
-H "Authorization: Bearer sk-你的KEY" -H "content-type: application/json" \
-d '{"task":"Txt2Img","model":"nano-banana-2","mode":"fast",
"input":{"prompt":"a red apple on a white background","aspect_ratio":"1:1","resolution":"2K","output_format":"jpg"}}'# 图生图（转换 / 参考）
curl https://u-token.ai/v1/router/task/create \
-H "Authorization: Bearer sk-你的KEY" -H "content-type: application/json" \
-d '{"task":"Img2Img","model":"nano-banana-2","mode":"fast",
"input":{"prompt":"把材质改为透明玻璃","images":["https://输入图.png"],"aspect_ratio":"1:1","resolution":"2K","output_format":"png"}}'创建响应
当前上游成功响应示例：
{
"code": 200,
"message": "task created",
"task_id": "tsk_01H..."
}网关会保留上游成功响应的其他字段，但只保证把 task_id 改写为平台 tsk_* ID。请保存 task_id，并按上述流程轮询任务；成功结果通常位于 results[].urls。