查询结果

轮询 Buble 生成任务并读取图片、视频或音频结果。

查询结果

生成任务是异步的。创建任务后,需要持续轮询,直到状态变为 successfailed

Endpoint

GET /api/v1/generations/[id]

请求

curl https://buble.ai/api/v1/generations/YOUR_GENERATION_ID \
  -H "Authorization: Bearer $BUBLE_API_KEY"

状态值

状态含义
pending任务已接收,等待执行。
processing模型提供方正在生成结果。
success生成成功。
failed生成失败,请查看 error
canceled任务已取消。

图片结果示例

{
  "data": {
    "id": "task_id",
    "status": "success",
    "model": "google/nano-banana-pro",
    "media_type": "image",
    "mode": "text_to_image",
    "cost_credits": 2,
    "created_at": "2026-05-11T00:00:00.000Z",
    "updated_at": "2026-05-11T00:01:00.000Z",
    "result": {
      "images": [{ "url": "https://..." }]
    }
  }
}

视频结果示例

{
  "data": {
    "id": "task_id",
    "status": "success",
    "model": "google/veo3.1-fast",
    "media_type": "video",
    "mode": "frames_to_video",
    "cost_credits": 40,
    "result": {
      "videos": [
        {
          "url": "https://...",
          "preview_url": "https://...",
          "thumbnail_url": "https://...",
          "duration": 8
        }
      ]
    }
  }
}

失败任务示例

{
  "data": {
    "id": "task_id",
    "status": "failed",
    "model": "google/nano-banana-pro",
    "media_type": "image",
    "mode": "text_to_image",
    "cost_credits": 2,
    "result": null,
    "error": {
      "code": "generation_failed",
      "message": "Generation failed."
    }
  }
}