Operations

查询视频生成任务

GET

/v1/contents/generations/tasks/{id}

const url = 'https://coder.api.visioncoder.cn/v1/contents/generations/tasks/example';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://coder.api.visioncoder.cn/v1/contents/generations/tasks/example \
  --header 'Authorization: Bearer <token>'

根据任务 ID 查询视频生成状态和结果。

Authorizations

BearerAuth

Parameters

Path Parameters

required

string

创建视频生成任务时返回的任务 ID。

Responses

200

任务状态查询成功。

application/json

ArkVideoResp

object

required

任务 ID。

string

model

required

执行任务的模型 ID。

string

status

required

任务状态。

string

Allowed values: queued running succeeded failed

content

ArkVideoResult

object

video_url

生成成功后返回的成品视频地址。

string

error

任务失败原因。status 为 failed 时可能返回。

string

created_at

required

任务创建时间，Unix 秒。

integer format: int64

updated_at

required

任务更新时间，Unix 秒。

integer format: int64

Example

{
  "id": "task_01JVIDEO9Q2W7X4K8",
  "model": "seedance-1-5-pro",
  "status": "queued",
  "content": {
    "video_url": "https://cdn.visioncoder.cn/videos/task_01JVIDEO/result.mp4"
  },
  "created_at": 1783742400,
  "updated_at": 1783742400
}

401

API Key 缺失或无效。

403

当前账户或 API Key 无权执行请求。

404

任务不存在。

429

请求频率超过限制。

500

服务或上游处理失败。