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

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

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', 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"

	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))

}
{
  "total": 1,
  "items": [
    {
      "id": "task_01k5example",
      "model": "doubao-seedance-2-5-260628",
      "status": "succeeded",
      "content": {
        "video_url": "https://media.suanwuyou.com.cn/videos/result.mp4"
      },
      "created_at": 1784246400,
      "updated_at": 1784246700,
      "resolution": "1080p",
      "ratio": "16:9",
      "duration": 10,
      "generate_audio": true,
      "output_format": "mp4"
    }
  ]
}
{
  "error": {
    "message": "请求参数不正确",
    "type": "invalid_request_error",
    "code": "invalid_parameter"
  }
}
{
  "error": {
    "message": "invalid api key",
    "type": "invalid_request_error",
    "code": "unauthorized"
  }
}
查询当前用户最近 3 天创建的 Seedance 视频任务。列表按任务记录倒序返回，并支持按状态、任务 ID、模型和服务等级筛选。
列表只返回当前算无忧用户自己的任务，不会暴露其他用户或上游渠道的内部任务 ID。上游接口可参考火山方舟查询视频生成任务列表。

​
参数说明

参数类型必填默认值说明
page_numinteger否1页码，从 1 开始。
page_sizeinteger否20每页数量，最大 500；超过 500 时按 500 处理。
filter.statusstring / array否-状态筛选：queued、running、succeeded、failed、cancelled 或 canceled。
filter.task_idsstring / array否-任务 ID 筛选。推荐重复传入同名参数，也兼容英文逗号分隔。
filter.modelstring否-按模型 ID 精确筛选。
filter.service_tierstring否-按服务等级精确筛选。
多个任务 ID 的推荐写法是重复同名参数： 
?filter.task_ids=task_a&filter.task_ids=task_b
不要传成 JSON 数组字符串，也不要把参数名写成 filter.task_ids[]。

​
请求示例

curl --get \
  'https://suanwuyou.com.cn/v1/api/v3/contents/generations/tasks' \
  --header 'Authorization: Bearer sk-请输入算无忧令牌' \
  --data-urlencode 'page_num=1' \
  --data-urlencode 'page_size=20' \
  --data-urlencode 'filter.status=succeeded' \
  --data-urlencode 'filter.model=doubao-seedance-2-5-260628'

​
返回示例

{
  "total": 1,
  "items": [
    {
      "id": "task_01k5example",
      "model": "doubao-seedance-2-5-260628",
      "status": "succeeded",
      "content": {
        "video_url": "https://media.suanwuyou.com.cn/videos/result.mp4"
      },
      "created_at": 1784246400,
      "updated_at": 1784246700,
      "resolution": "1080p",
      "ratio": "16:9",
      "duration": 10,
      "generate_audio": true,
      "output_format": "mp4"
    }
  ]
}

Authorizations

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

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

Query Parameters

​
page_num
integer
default:1

页码，从 1 开始。

Required range: x >= 1
​
page_size
integer
default:20

每页数量，默认 20，最大 500。

Required range: 1 <= x <= 500
​
filter.status
enum<string>[]

任务状态。支持重复传参或使用英文逗号分隔多个状态。

Available options:
queued,
running,
succeeded,
failed,
cancelled,
canceled
​
filter.task_ids
string[]

任务 ID。推荐重复传入同名参数，也兼容英文逗号分隔。

​
filter.model
string

按模型 ID 精确筛选。

Example:

"doubao-seedance-2-5-260628"

​
filter.service_tier
string

按服务等级精确筛选。

Example:

"default"

Response

任务列表。

​
total
integer
required

符合筛选条件的任务总数。

​
items
object[]
required