跳转到主要内容
GET
/
v1
/
video
/
status
查询视频生成状态
curl --request GET \
  --url https://api.senseaudio.cn/v1/video/status \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "model": "<string>",
  "task_id": "<string>",
  "status": "pending",
  "progress": 123,
  "video_url": "<string>",
  "duration": 123,
  "is_new": true,
  "error_message": "<string>",
  "created_at": 123,
  "completed_at": 123,
  "prompt": "<string>",
  "resolution": "<string>",
  "ratio": "<string>",
  "content": [
    {
      "type": "text",
      "text": "<string>",
      "url": "<string>",
      "role": "first_frame",
      "audio_url": "<string>",
      "video_url": "<string>"
    }
  ],
  "provider_specific": {
    "generate_audio": true,
    "camera_fixed": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.senseaudio.cn/llms.txt

Use this file to discover all available pages before exploring further.

说明

根据任务 ID 查询视频生成任务的当前状态、进度与最终结果。
视频生成为异步任务,建议创建任务后每 5–10 秒轮询一次状态,直到返回 completedfailed

接口概览

项目
接口地址https://api.senseaudio.cn/v1/video/status
请求方式GET
Content-Typeapplication/json
鉴权方式Bearer Token

请求头

参数名必填说明示例
Authorization鉴权 Token,格式 Bearer SENSEAUDIO_API_KEYBearer sk-123456...
Content-Type固定为 application/jsonapplication/json

请求参数(Query)

参数名类型必填描述
idstring创建任务时返回的任务 ID

响应结构

参数名类型描述
idstring记录 ID
modelstring模型名称
task_idstring任务 ID
statusstring任务状态,见下表
progressint64进度百分比
video_urlstring视频 URL(completed 后返回)
durationint64实际视频时长(秒)
is_newboolean是否为新视频
error_messagestring错误信息(failed 时返回)
created_atint64创建时间戳
completed_atint64完成时间戳
promptstring提示词
resolutionstring分辨率,如 720p
ratiostring宽高比,如 16:99:16
contentarray描述视频的文字或图片
provider_specificobject模型特殊参数

状态说明

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

响应示例

{
  "id": "52e0c397-2f78-4c1f-8774-d51aba5e4e3c",
  "model": "Seedance-2.0",
  "task_id": "c4666acd-60fa-4e1e-8c8b-72ae129f7a4d",
  "status": "pending",
  "progress": 0,
  "duration": 10,
  "is_new": true,
  "created_at": 1773822549,
  "prompt": "",
  "resolution": "720p",
  "content": [
    {
      "type": "text",
      "text": "黄昏海边,海浪轻轻拍打礁石,镜头缓慢推进"
    }
  ],
  "ratio": "16:9"
}

代码示例

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

注意事项

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

授权

Authorization
string
header
必填

格式:Bearer <API_KEY>

查询参数

id
string
必填

响应

200 - application/json

成功

id
string

记录 ID

model
string

模型名称

task_id
string

任务 ID

status
enum<string>

任务状态

可用选项:
pending,
processing,
completed,
failed
progress
integer<int64>

进度百分比

video_url
string

视频 URL(completed 后返回)

duration
integer<int64>

实际视频时长(秒)

is_new
boolean

是否为新视频

error_message
string

错误信息(failed 时返回)

created_at
integer<int64>

创建时间戳

completed_at
integer<int64>

完成时间戳

prompt
string

提示词

resolution
string

分辨率,如 720p、1080p

ratio
string

宽高比,如 16:9、9:16

content
object[]

描述视频的文字、图片、音频或视频

provider_specific
object

厂商特定参数