本文档由云音工坊自动生成，如有疑问，请联系客服微信：yuntts ！

查询任务

开发中

GET

/nano/status

状态机说明

pending ──► submitted ──► processing ──► completed
                                    └─► failed  （自动退款）

提交成功即 submitted；查询到 pending/processing → 本地 processing；

completed 时返回 result_images；failed 时返回 error_message 且 billing.refunded=true；

客户端停止轮询后，服务端每 5 分钟兜底同步一次（超 24 小时未完成、或提交中断超 10 分钟，均自动失败并退款）。

请求参数

Query 参数

Header 参数

Body 参数application/json必填

示例

{}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff --request GET '/nano/status?task_id={task_id}' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

已完成进行中

{
    "code": 200,
    "message": "success",
    "data": {
        "task_id": "nano_rest_6512f0a1b2c3d",
        "model": "nano_pro",
        "status": "completed",
        "progress": 100,
        "prompt": "把背景换成海边日落",
        "image_size": "2K",
        "aspect_ratio": "16:9",
        "x_channel": "official",
        "created_at": "2026-10-12 18:20:01",
        "updated_at": "2026-10-12 18:20:56",
        "billing": {
            "charged_points": 0.54,
            "refunded": false
        },
        "result_images": [
            "https://cdn.example.com/gen/6512f0a1b2c3d.png?expires=1791779017&token=..."
        ]
    }
}

修改于 2026-10-12 05:44:45

Nano Banana Pro

Edge TTS语音合成

查询任务

状态机说明#

请求参数

请求示例代码

返回响应

状态机说明