异步图片获取

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

接口概览

接口地址: 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

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"

Python

python

复制

import requests
 
API_URL = "https://api.senseaudio.cn/v1/image/pending"
HEADERS = {
    "Authorization": "Bearer SENSEAUDIO_API_KEY",
    "Content-Type": "application/json"
}
 
def pending(task_id):
    resp = requests.get(API_URL + "?task_id=" + task_id, headers=HEADERS)
    if resp.status_code == 200:
        return resp.json()
    return None
 
result = pending("6480d868-285c-44f2-945b-2d8b5146f486")

JavaScript

javascript

复制

const axios = require('axios');
 
const API_URL = 'https://api.senseaudio.cn/v1/image/pending';
const HEADERS = {
    'Authorization': 'Bearer SENSEAUDIO_API_KEY',
    'Content-Type': 'application/json'
};
 
async function pending(task_id) {
    try {
        const res = await axios.get(API_URL + "?task_id=" + task_id, { headers: HEADERS });
        return res.data;
    } catch (err) {
        console.error('请求失败:', err.message);
        return null;
    }
}
 
pending("6480d868-285c-44f2-945b-2d8b5146f486").then(result => console.log(result));