查询视频任务

正式环境

https://api.naoshengyun.com

GET

/v1/videos/{task_id}

查询视频生成任务。

请求参数

Path 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

TASK_ID="a1b2c3d4-5e6f-7890-abcd-ef1234567890"
TOKEN="sk-xxxxxxxxxxxxxxxx"

while true; do
  RESP=$(curl -s "https://your-gateway.com/v1/videos/$TASK_ID" \
    -H "Authorization: Bearer $TOKEN")
  STATUS=$(echo "$RESP" | jq -r '.status')
  echo "status=$STATUS progress=$(echo "$RESP" | jq -r '.progress')"
  case "$STATUS" in
    completed|failed) echo "$RESP"; break ;;
  esac
  sleep 5
done

返回响应

🟢200成功

application/json

查询成功。核心字段由 Host 覆写；插件补充失败 error，成功时补充 metadata.url 与上游 usage。

Bodyapplication/json

示例

{
    "id": "string",
    "object": "video",
    "model": "string",
    "status": "queued",
    "progress": 0,
    "created_at": 0,
    "completed_at": 0,
    "error": {
        "code": "string",
        "message": "string"
    },
    "metadata": {
        "url": "string"
    },
    "usage": {}
}

🟠401鉴权失败

🟠400任务不存在（网关返回 400）

修改于 2026-09-24 04:48:29

创建视频任务

火山原生创建视频任务