Skip to main content
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

id
string
示例:

"img_xxx"

task_id
string
示例:

"img_xxx"

object
string
示例:

"image.task"

status
enum<string>
可用选项:
queued,
in_progress,
succeeded,
failed
progress
integer
必填范围: 0 <= x <= 100
created_at
integer
completed_at
integer
result
object
error
object