Skip to content

查询与下载 ​

视频使用统一任务管线。创建接口返回的 id 是公开任务 ID,不会暴露上游任务标识;图片接口按对应模型页面调用。

查询任务状态 ​

GET /v1/videos/{task_id}

视频任务

sh
curl --request GET \
  --url https://newapi.dragon3api.com/v1/videos/task_xxxxxxxxxxxxxxxxxxxxxxxx \
  --header 'Authorization: Bearer YOUR_DRAGONAPI_KEY'

状态说明 ​

queued

已进入队列,等待处理

in_progress

模型正在生成视频

completed

生成完成,可以下载

failed

任务失败,查看错误信息

参考素材 ​

先确认所选模型明确支持参考素材,再按该模型的字段与格式提交。普通文生视频示例不需要素材;不要通用地添加 image_urls、base64 或参考视频字段。

下载任务结果 ​

GET /v1/videos/{task_id}/content

返回视频二进制内容

sh
curl --location \
  --url https://newapi.dragon3api.com/v1/videos/task_xxxxxxxxxxxxxxxxxxxxxxxx/content \
  --header 'Authorization: Bearer YOUR_DRAGONAPI_KEY' \
  --output result.bin

在 DragonAPI 查看 ​

任务日志

可按任务 ID 筛选,查看状态、进度、模型、消耗和结果。

打开任务日志 ↗

任务列表通过控制台查看

公开 API 提供按任务 ID 查询和下载;任务列表、筛选与历史记录请在 DragonAPI 任务日志中使用。

建议轮询间隔

视频建议 8–15 秒。不要高频轮询;任务完成后及时保存结果。

模型、价格与服务规则以当前控制台为准。