查询视频生成状态

查询视频生成任务的当前状态和进度。

接口概览

接口地址: https://api.senseaudio.cn/v1/video/status
请求方式: 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)

参数名	类型	必填	描述
id	string	是	任务 ID（必填）

响应结构

参数名	类型	描述
id	string	ID
model	string	模型名称
task_id	string	任务 ID
status	string	状态
progress	int64	进度百分比
video_url	string	视频 URL
duration	int64	实际时长（秒）
is_new	boolean	是否为新视频
error_message	string	错误信息
created_at	int64	创建时间戳
completed_at	int64	完成时间戳
prompt	string	提示词
resolution	string	分辨率，如 "1080p"
ratio	string	宽高比，如 "16:9", "9:16"
content	array	描述视频的文字或图片
provider_specific	object	模型特殊参数

状态说明

状态值	说明
pending	等待处理
processing	处理中
completed	已完成
failed	失败

响应示例

json

复制

{
    "id": "52e0c397-2f78-4c1f-8774-d51aba5e4e3c",
    "model": "SenseAudio-Video-1.0",
    "task_id": "c4666acd-60fa-4e1e-8c8b-72ae129f7a4d",
    "status": "pending",
    "progress": 0,
    "duration": 12,
    "is_new": true,
    "created_at": 1773822549,
    "prompt": "",
    "resolution": "720p",
    "content": [
        {
            "type": "text",
            "text": "小怪兽"
        }
    ],
    "ratio": "16:9",
}

代码示例

CURL

bash

复制

curl -X GET "https://api.senseaudio.cn/v1/video/status?id=task_1234567890" \
  -H "Authorization: Bearer SENSEAUDIO_API_KEY" \
  -H "Content-Type: application/json"

Python

python

复制

import requests
import time
 
API_URL = "https://api.senseaudio.cn/v1/video/status"
HEADERS = {
    "Authorization": "Bearer SENSEAUDIO_API_KEY",
    "Content-Type": "application/json"
}
 
def get_video_status(task_id):
    params = {"id": task_id}
    resp = requests.get(API_URL, headers=HEADERS, params=params)
    if resp.status_code == 200:
        return resp.json()
    return None
 
def poll_video_status(task_id, max_attempts=60):
    """轮询视频状态直到完成"""
    for _ in range(max_attempts):
        result = get_video_status(task_id)
        if result:
            status = result.get("status")
            progress = result.get("progress", 0)
            print(f"状态: {status}, 进度: {progress}%")
 
            if status == "completed":
                print(f"视频生成完成: {result.get('video_url')}")
                return result
            elif status == "failed":
                print(f"生成失败: {result.get('error_message')}")
                return result
 
        time.sleep(5)  # 每5秒查询一次
    return None
 
# 查询状态
result = poll_video_status("task_1234567890")

JavaScript

javascript

复制

const axios = require('axios');
 
const API_URL = 'https://api.senseaudio.cn/v1/video/status';
const HEADERS = {
    'Authorization': 'Bearer SENSEAUDIO_API_KEY',
    'Content-Type': 'application/json'
};
 
async function getVideoStatus(taskId) {
    try {
        const res = await axios.get(API_URL, {
            headers: HEADERS,
            params: { id: taskId }
        });
        return res.data;
    } catch (err) {
        console.error('请求失败:', err.message);
        return null;
    }
}
 
async function pollVideoStatus(taskId, maxAttempts = 60) {
    for (let i = 0; i < maxAttempts; i++) {
        const result = await getVideoStatus(taskId);
        if (result) {
            const { status, progress } = result;
            console.log(`状态: ${status}, 进度: ${progress}%`);
 
            if (status === 'completed') {
                console.log(`视频生成完成: ${result.video_url}`);
                return result;
            } else if (status === 'failed') {
                console.log(`生成失败: ${result.error_message}`);
                return result;
            }
        }
        await new Promise(resolve => setTimeout(resolve, 5000)); // 每5秒查询一次
    }
    return null;
}
 
pollVideoStatus('task_1234567890').then(result => {
    console.log(result);
});

注意事项

轮询建议：视频生成需要时间，建议每 5-10 秒查询一次状态
超时处理：如果长时间处于 processing 状态，可能需要重新创建任务
错误处理：当 status 为 failed 时，查看 error_message 了解失败原因