GET
/
v1
/
api
/
v3
/
contents
/
generations
/
tasks
/
{task_id}
查询视频
curl --request GET \
  --url https://suanwuyou.com.cn/v1/api/v3/contents/generations/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'
import requests

url = "https://suanwuyou.com.cn/v1/api/v3/contents/generations/tasks/{task_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://suanwuyou.com.cn/v1/api/v3/contents/generations/tasks/{task_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://suanwuyou.com.cn/v1/api/v3/contents/generations/tasks/{task_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
{
  "id": "task_01k5example",
  "model": "doubao-seedance-2-5-260628",
  "status": "succeeded",
  "content": {
    "video_url": "https://media.suanwuyou.com.cn/videos/result.mp4",
    "last_frame_url": "https://media.suanwuyou.com.cn/images/last-frame.png"
  },
  "usage": {
    "completion_tokens": 108900,
    "total_tokens": 108900
  },
  "created_at": 1784246400,
  "updated_at": 1784246700,
  "seed": 78674,
  "resolution": "1080p",
  "ratio": "16:9",
  "duration": 10,
  "framespersecond": 24,
  "service_tier": "default",
  "generate_audio": true,
  "output_format": "mp4"
}
{
  "error": {
    "message": "invalid api key",
    "type": "invalid_request_error",
    "code": "unauthorized"
  }
}
{
  "error": {
    "code": "task_not_found",
    "message": "任务不存在或已超过 3 天查询期限"
  }
}
查询当前算无忧用户创建的单个 Seedance 视频任务。任务完成后，成片地址位于 content.video_url。
默认仅允许查询最近 3 天的任务。该期限可由服务端配置调整，最终以接口返回为准。上游字段可参考火山方舟查询视频生成任务 API。

​
参数说明

参数位置类型必填说明
task_idPathstring是“创建视频”接口返回的算无忧公开任务 ID。
常见状态包括：
status说明
queued已进入队列，等待执行。
running正在生成。
succeeded生成成功，可读取成片地址。
failed生成失败，可查看 error。
cancelled任务已取消。

​
请求示例

curl --location --request GET \
  'https://suanwuyou.com.cn/v1/api/v3/contents/generations/tasks/task_01k5example' \
  --header 'Authorization: Bearer sk-请输入算无忧令牌'

​
返回示例

{
  "id": "task_01k5example",
  "model": "doubao-seedance-2-5-260628",
  "status": "succeeded",
  "content": {
    "video_url": "https://media.suanwuyou.com.cn/videos/result.mp4",
    "last_frame_url": "https://media.suanwuyou.com.cn/images/last-frame.png"
  },
  "usage": {
    "completion_tokens": 108900,
    "total_tokens": 108900
  },
  "created_at": 1784246400,
  "updated_at": 1784246700,
  "seed": 78674,
  "resolution": "1080p",
  "ratio": "16:9",
  "duration": 10,
  "framespersecond": 24,
  "service_tier": "default",
  "generate_audio": true,
  "output_format": "mp4"
}
视频结果地址可能存在有效期。任务成功后请及时下载或转存，不要把临时地址作为永久资源地址。

Authorizations

​
Authorization
string
header
default:Bearer sk-请输入算无忧令牌
required

填写完整的 Bearer 鉴权值，例如 Bearer sk-你的算无忧令牌。

Path Parameters

​
task_id
string
required

创建接口返回的算无忧公开任务 ID。

Example:

"task_01k5example"

Response

任务详情。

​
id
string
required

算无忧公开任务 ID。

​
status
enum<string>
required

任务状态。

Available options:
queued,
running,
succeeded,
failed,
cancelled
​
model
string
​
content
object
​
usage
object
​
created_at
integer

创建时间，Unix 秒级时间戳。

​
updated_at
integer

更新时间，Unix 秒级时间戳。

​
seed
integer
​
resolution
string
​
ratio
string
​
duration
integer
​
frames
integer
​
framespersecond
integer
​
service_tier
string
​
execution_expires_after
integer
​
generate_audio
boolean
​
draft
boolean
​
draft_task_id
string
​
output_format
string
​
priority
integer
​
error
object | null