跳转到主要内容
GET
Retrieve task
视频与图片任务共用 /v1/tasks/{task_id}。提交 /v1/videos/generations 后拿到 task_id,再用本接口轮询。

请求

进行中响应

成功响应

任务进入 completed 后,结果视频可通过 /v1/videos/{task_id}/content 拉取(需要带 Bearer 鉴权)。
如果你的产品要把视频展示给终端用户,建议在你的服务端代理这一次下载:先用密钥取到视频,再以你自己的鉴权下发,避免把 DimiLinks 密钥暴露到浏览器。

失败响应

状态

轮询建议

  • 每 3 到 5 秒查询一次,比图片任务略宽松。
  • 单条任务最长建议轮询 10 分钟;超时后直接告知用户失败并允许重试。
  • 出现 404 立即停止轮询,多半是任务 ID 错或不属于当前密钥。

授权

Authorization
string
header
必填

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

路径参数

task_id
string
必填

响应

Image or video task

task_id
string
必填
示例:

"task_xxx"

status
enum<string>
必填
可用选项:
NOT_START,
SUBMITTED,
QUEUED,
IN_PROGRESS,
SUCCESS,
FAILURE
progress
string
必填
Pattern: ^[0-9]{1,3}%$
示例:

"50%"

created_at
integer
必填
platform
string
示例:

"openai"

fail_reason
string
finished_at
integer
data
object