跳转到内容

获取结果

请求

结果查询可以直接使用创建任务响应中的 response_url，也可以通过 BASE_URL、endpoint 和 request_id 拼接请求路径。

使用 response_url
按 request_id 查询结果

curl -sS "${RESPONSE_URL}" \
  "${COMMON_HEADERS[@]}"

curl -sS "${BASE_URL}/v1/queue/${ENDPOINT}/requests/${REQUEST_ID}/response" \
  "${COMMON_HEADERS[@]}"

响应

未完成响应

如果任务尚未进入终态，结果接口返回 HTTP 202，响应体与状态查询一致：

202

{
  "status": "IN_PROGRESS",
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://cloud.seaart.ai/model/v1/queue/nano_banana_2/requests/mmsu_01hxyz.../response"
}

完成响应

任务成功后，结果接口返回稳定结构：request_id、outputs 和 metadata。所有可下载或可展示的结果都放在 outputs 数组中，多个结果 URL 会按顺序返回多条记录。

{
  "request_id": "mmsu_01hxyz...",
  "outputs": [
    {
      "type": "image",
      "url": "https://example.com/image.png",
      "content_type": "image/png",
      "file_name": "image.png",
      "width": 1024,
      "height": 1024
    }
  ],
  "metadata": {
    "prompt": "a cinematic photo of a cat astronaut"
  }
}

{
  "request_id": "mmsu_01hxyz...",
  "outputs": [
    {
      "type": "image",
      "url": "https://example.com/image-1.png",
      "content_type": "image/png",
      "width": 1024,
      "height": 1024
    },
    {
      "type": "image",
      "url": "https://example.com/image-2.png",
      "content_type": "image/png",
      "width": 1024,
      "height": 1024
    }
  ],
  "metadata": {
    "prompt": "generate two product variations"
  }
}

{
  "request_id": "mmsu_01hxyz...",
  "outputs": [
    {
      "type": "video",
      "url": "https://example.com/video.mp4",
      "content_type": "video/mp4",
      "file_name": "video.mp4",
      "file_size": 123456,
      "duration": 5
    }
  ],
  "metadata": {
    "prompt": "camera slowly pushes in"
  }
}

{
  "request_id": "mmsu_01hxyz...",
  "outputs": [
    {
      "type": "audio",
      "url": "https://example.com/audio.mp3",
      "content_type": "audio/mpeg",
      "file_name": "audio.mp3",
      "duration": 10.5
    }
  ],
  "metadata": {
    "text": "你好，欢迎使用 SeaCloud。"
  }
}

{
  "request_id": "mmsu_01hxyz...",
  "outputs": [
    {
      "type": "model3d",
      "url": "https://example.com/model.glb",
      "content_type": "model/gltf-binary",
      "file_name": "model.glb",
      "file_size": 123456
    }
  ],
  "metadata": {
    "prompt": "a small stylized robot, game-ready asset"
  }
}

{
  "request_id": "mmsu_01hxyz...",
  "outputs": [
    {
      "type": "text",
      "text": "[Verse]\n晚风吹过海岸线\n我们把故事唱一遍"
    }
  ],
  "metadata": {
    "prompt": "写一首关于夏夜海边和朋友重逢的中文流行歌词"
  }
}

{
  "status": "COMPLETED",
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://cloud.seaart.ai/model/v1/queue/nano_banana_2/requests/mmsu_01hxyz.../response",
  "error": "Provider rejected request",
  "error_type": "REQUEST_INVALID"
}

`outputs` 字段

字段	类型	说明
`type`	string	结果类型，常见值为 `image`、`video`、`audio`、`model3d`、`text`、`file`
`url`	string	可下载或可访问的结果地址；文本结果可能没有该字段
`text`	string	文本类结果内容，例如歌词生成结果
`content_type`	string	资源 MIME 类型，例如 `image/png`、`video/mp4`
`file_name`	string	文件名；平台能推断时返回
`file_size`	number	文件大小，单位 byte；平台能获取时返回
`width` / `height`	number	图片宽高；平台能获取时返回
`duration`	number	音视频时长，单位秒；平台能获取时返回
`metadata`	object	单个输出的补充信息；没有补充信息时不返回