异步图片获取

使用异步方式生成图片任务后，使用此接口获取异步图片任务的状态和生成结果。

接口概览

接口地址: https://api.senseaudio.cn/v1/image/pending
请求方式: GET
Content-Type: application/json
鉴权方式: Bearer Token

请求配置

请求头 (Request Headers)

参数名	必填	说明	示例
Authorization	是	鉴权 Token。格式：Bearer SENSEAUDIO_API_KEY	Bearer sk-123456...
Content-Type	是	内容类型。固定为 application/json	application/json

请求参数 (Query Parameters)

参数名	类型	描述
task_id	string	异步图片生成任务 ID

响应结构

参数名	类型	描述
status	string	任务状态，可能为`completed`（生成成功）/`failed`（生成失败）/`pending`（正在生成）
url	string	如果状态为`completed`，此项存在并存储图片的 URL
error_message	string	如果状态为`failed`，此项存在并存储图片生成失败原因

响应示例

json

{
  "status": "completed",
  "url": "https://example.com/image.png"
}

代码示例

CURL

Python

JavaScript

bash

curl "https://api.senseaudio.cn/v1/image/pending?task_id=6480d868-285c-44f2-945b-2d8b5146f486" \
-H "Authorization: Bearer $SENSEAUDIO_API_KEY" \
-H "Content-Type: application/json"

异步图片获取

使用异步方式生成图片任务后，使用此接口获取异步图片任务的状态和生成结果。

接口概览

接口地址: https://api.senseaudio.cn/v1/image/pending
请求方式: GET
Content-Type: application/json
鉴权方式: Bearer Token

请求配置

请求头 (Request Headers)

参数名	必填	说明	示例
Authorization	是	鉴权 Token。格式：Bearer SENSEAUDIO_API_KEY	Bearer sk-123456...
Content-Type	是	内容类型。固定为 application/json	application/json

请求参数 (Query Parameters)

参数名	类型	描述
task_id	string	异步图片生成任务 ID

响应结构

参数名	类型	描述
status	string	任务状态，可能为`completed`（生成成功）/`failed`（生成失败）/`pending`（正在生成）
url	string	如果状态为`completed`，此项存在并存储图片的 URL
error_message	string	如果状态为`failed`，此项存在并存储图片生成失败原因

响应示例

json

{
  "status": "completed",
  "url": "https://example.com/image.png"
}

代码示例

CURL

Python

JavaScript

bash

curl "https://api.senseaudio.cn/v1/image/pending?task_id=6480d868-285c-44f2-945b-2d8b5146f486" \
-H "Authorization: Bearer $SENSEAUDIO_API_KEY" \
-H "Content-Type: application/json"