查询视频生成任务

查询视频生成任务

curl --request GET \
  --url https://xxx.wengaocloud.com/v1/videos/generations/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://xxx.wengaocloud.com/v1/videos/generations/{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://xxx.wengaocloud.com/v1/videos/generations/{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": "vidtask_3cb6299b32d24f93a82e8a74b3e06161",
  "object": "video.generation.task",
  "created": 1779782400,
  "created_at": 1779782400,
  "updated_at": 1779782400,
  "model": "seedance-2.0",
  "status": "queued",
  "billing_status": "frozen"
}

查询视频生成任务

curl --request GET \
  --url https://xxx.wengaocloud.com/v1/videos/generations/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://xxx.wengaocloud.com/v1/videos/generations/{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://xxx.wengaocloud.com/v1/videos/generations/{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": "vidtask_3cb6299b32d24f93a82e8a74b3e06161",
  "object": "video.generation.task",
  "created": 1779782400,
  "created_at": 1779782400,
  "updated_at": 1779782400,
  "model": "seedance-2.0",
  "status": "queued",
  "billing_status": "frozen"
}

查询异步视频生成任务的状态、视频结果和用量信息。

GET /v1/videos/generations/{id}
Authorization: Bearer <API_KEY>

id 为创建视频生成任务返回的任务 ID，格式通常以 vidtask_ 开头。

不要高频轮询。建议间隔 5–10 秒，最短不低于 3 秒。视频生成通常需要 30 秒至数分钟。

示例

curl "https://{your-domain}/v1/videos/generations/vidtask_3cb6299b32d24f93a82e8a74b3e06161" \
  -H "Authorization: Bearer $API_KEY"

响应字段

字段	类型	说明
`id`	string	平台任务 ID。
`object`	string	固定为 `video.generation.task`。
`created`	integer	任务创建时间，Unix 秒。
`created_at`	integer	任务创建时间，Unix 秒（同 `created`）。
`updated_at`	integer	任务状态最后更新时间，Unix 秒。
`model`	string	平台模型名称。
`status`	string	任务状态，见下方说明。
`billing_status`	string	平台账务状态，见下方说明。
`content`	object	视频生成结果，任务成功时返回。
`content.video_url`	string	生成视频 URL，请及时下载和转存，URL 有有效期。
`content.video_url_expires_at`	string	视频 URL 过期时间，RFC3339 格式。
`error`	object	失败任务的错误信息，`status=failed` 时返回。
`error.code`	string	错误码，例如 `OutputVideoSensitiveContentDetected`。
`error.message`	string	错误说明。
`usage`	object	Token 用量，任务完成后返回。
`usage.completion_tokens`	integer	输出 Token 数。
`usage.total_tokens`	integer	总 Token 数。
`seed`	integer	实际使用的随机种子，存在时返回。
`resolution`	string	实际生成视频的分辨率，存在时返回。
`ratio`	string	实际生成视频的宽高比，存在时返回。
`duration`	integer/string	实际生成视频时长（秒），存在时返回。
`frames`	integer	生成视频总帧数，存在时返回。
`framespersecond`	integer	生成视频帧率，存在时返回。
`generate_audio`	boolean	是否包含同步音频，存在时返回。
`service_tier`	string	任务服务等级，存在时返回。

任务状态

`status`	说明	下一步操作
`queued`	排队中，等待处理。	继续轮询
`running`	视频正在生成中。	继续轮询
`succeeded`	任务成功。	读取 `content.video_url` 并下载
`failed`	任务失败。	查看 `error` 字段排查原因
`cancelled`	任务已取消。	无需处理
`expired`	任务超时，已超过 `execution_expires_after`。	重新提交任务

账务状态

`billing_status`	说明
`frozen`	已冻结预估费用，任务尚未最终结算。
`settling`	结算处理中。
`settled`	已成功结算。
`refunded`	任务失败、取消或超时后已退款。
`settle_failed`	结算失败，请联系平台处理。
`refund_failed`	退款失败，请联系平台处理。

响应示例

{
  "id": "vidtask_3cb6299b32d24f93a82e8a74b3e06161",
  "object": "video.generation.task",
  "created": 1779782400,
  "created_at": 1779782400,
  "updated_at": 1779782400,
  "model": "seedance-2.0",
  "status": "queued",
  "billing_status": "frozen"
}

{
  "id": "vidtask_3cb6299b32d24f93a82e8a74b3e06161",
  "object": "video.generation.task",
  "created": 1779782400,
  "created_at": 1779782400,
  "updated_at": 1779782420,
  "model": "seedance-2.0",
  "status": "running",
  "billing_status": "frozen"
}

{
  "id": "vidtask_3cb6299b32d24f93a82e8a74b3e06161",
  "object": "video.generation.task",
  "created": 1779782400,
  "created_at": 1779782400,
  "updated_at": 1779782488,
  "model": "seedance-2.0",
  "status": "succeeded",
  "billing_status": "settled",
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "framespersecond": 24,
  "generate_audio": true,
  "service_tier": "default",
  "content": {
    "video_url": "https://example.com/generated-video.mp4",
    "video_url_expires_at": "2026-05-27T12:00:00Z"
  },
  "usage": {
    "completion_tokens": 540900,
    "total_tokens": 540900
  }
}

{
  "id": "vidtask_3cb6299b32d24f93a82e8a74b3e06161",
  "object": "video.generation.task",
  "created": 1779782400,
  "created_at": 1779782400,
  "updated_at": 1779782488,
  "model": "seedance-2.0",
  "status": "failed",
  "billing_status": "refunded",
  "error": {
    "code": "OutputVideoSensitiveContentDetected",
    "message": "The request failed because the output video may contain sensitive information."
  }
}

错误码

HTTP 状态码	`error.type`	场景
404	`task_not_found`	任务不存在，或任务不属于当前 API Key。
401	—	API Key 缺失或无效。

`status`	说明
`queued`	排队中，等待处理。
`running`	视频正在生成中。
`succeeded`	任务成功，`content.video_url` 可用。
`failed`	任务失败，`error` 字段包含错误信息。
`cancelled`	任务已取消。
`expired`	任务超时，已超过 `execution_expires_after` 设定的时间。

账务状态

`billing_status`	说明
`frozen`	已冻结预估费用，任务尚未最终结算。
`settling`	结算处理中。
`settled`	已成功结算。
`refunded`	任务失败、取消或超时后已退款。
`settle_failed`	结算失败，需联系平台处理。
`refund_failed`	退款失败，需联系平台处理。

响应示例

{
  "id": "vidtask_3cb6299b32d24f93a82e8a74b3e06161",
  "object": "video.generation.task",
  "created": 1779782400,
  "created_at": 1779782400,
  "updated_at": 1779782400,
  "model": "seedance-2.0",
  "status": "queued",
  "billing_status": "frozen"
}

{
  "id": "vidtask_3cb6299b32d24f93a82e8a74b3e06161",
  "object": "video.generation.task",
  "created": 1779782400,
  "created_at": 1779782400,
  "updated_at": 1779782488,
  "model": "seedance-2.0",
  "status": "succeeded",
  "billing_status": "settled",
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "framespersecond": 24,
  "generate_audio": true,
  "service_tier": "default",
  "content": {
    "video_url": "https://example.com/generated-video.mp4",
    "video_url_expires_at": "2026-05-27T12:00:00Z"
  },
  "usage": {
    "completion_tokens": 540900,
    "total_tokens": 540900
  }
}

{
  "id": "vidtask_3cb6299b32d24f93a82e8a74b3e06161",
  "object": "video.generation.task",
  "created": 1779782400,
  "created_at": 1779782400,
  "updated_at": 1779782488,
  "model": "seedance-2.0",
  "status": "failed",
  "billing_status": "refunded",
  "error": {
    "code": "OutputVideoSensitiveContentDetected",
    "message": "The request failed because the output video may contain sensitive information."
  }
}

授权

Authorization

string

header

默认值:sk-your-api-key

必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

路径参数

string

必填

创建接口返回的任务 ID，格式通常以 vidtask_ 开头。

响应

视频任务状态与结果。

string

必填

示例:

"vidtask_3cb6299b32d24f93a82e8a74b3e06161"

object

enum<string>

必填

可用选项:

video.generation.task

status

enum<string>

必填

任务状态：queued（排队中）、running（运行中）、succeeded（成功）、 failed（失败）、cancelled（已取消）、expired（已超时）。

可用选项:

queued,

running,

succeeded,

failed,

cancelled,

expired

created

integer

任务创建时间，Unix 秒。

created_at

integer

任务创建时间，Unix 秒。

updated_at

integer

任务状态更新时间，Unix 秒。

model

string

billing_status

enum<string>

账务状态：frozen（已冻结）、settling（结算中）、settled（已结算）、 refunded（已退款）、settle_failed（结算失败）、refund_failed（退款失败）。

可用选项:

frozen,

settling,

settled,

refunded,

settle_failed,

refund_failed

content

object

视频生成结果，任务成功且存在视频地址时返回。

Hide child attributes

content.video_url

string

生成视频 URL，请及时下载和转存。

content.video_url_expires_at

string

视频 URL 过期时间，RFC3339 格式。

error

object

Hide child attributes

error.code

string

error.message

string

usage

object

用量信息，任务完成并完成用量统计后返回。Token 视频模型返回 token 字段；Grok Imagine 返回按秒计费字段。

Hide child attributes

usage.completion_tokens

integer

usage.total_tokens

integer

usage.billing_unit

string

计费单位，例如 video_second。

usage.unit_name

string

单位名称，例如 video_second。

usage.requested_units

请求单位数。Grok Imagine 中通常为请求的视频秒数。

usage.billable_units

实际结算单位数。Grok Imagine 中通常为输出视频秒数。

usage.billable_input_images

实际计费的输入图张数，存在时返回。

usage.billable_output_seconds

实际计费的输出视频秒数，存在时返回。

usage.input_charge_amount

输入图费用，存在时返回。

usage.output_charge_amount

输出视频费用，存在时返回。

usage.charge_amount

本次任务总费用，存在时返回。

seed

integer

resolution

string

ratio

string

duration

frames

integer

framespersecond

integer

generate_audio

boolean

service_tier

string

expires_at

integer

开始使用

API 参考

模型与计费

指南

参考

示例

响应字段

任务状态

账务状态

响应示例

错误码

账务状态

响应示例

授权

路径参数

响应

​示例

​响应字段

​任务状态

​账务状态

​响应示例

​错误码

​账务状态

​响应示例

授权

路径参数

响应

示例

响应字段

任务状态

账务状态

响应示例

错误码

账务状态

响应示例