查询与下载

图片和视频共用统一任务管线。创建接口返回的 task_id 是公开任务 ID，不会暴露上游任务标识。

查询任务状态

GET /v1/videos/{task_id}

图片与视频任务通用

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

状态说明

queued

已进入队列，等待处理

in_progress

模型正在生成图片或视频

completed

生成完成，可以下载

failed

任务失败，查看错误信息

准备图片与视频素材

DragonAPI 当前不提供通用文件托管接口。需要参考素材时，请先将文件保存到你自己的对象存储或其他可公开访问的 HTTPS 地址，再把 URL 传入 image_urls、images、video_url 等模型字段。

必须公网可访问

不能使用本地路径、内网地址或需要登录才能访问的链接。

不要直接传 base64

图片和视频任务只接收 URL；请设置正确的 Content-Type，并确保链接在任务完成前不过期。

上传由你的存储服务负责

可使用 OSS、COS、S3 或兼容对象存储。DragonAPI 只保存任务记录，不代管用户文件。

下载任务结果

GET /v1/videos/{task_id}/content

返回图片或视频二进制内容

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 任务日志中使用。

建议轮询间隔

图片建议 3–5 秒，视频建议 8–15 秒。不要高频轮询；任务完成后及时保存结果。

查询与下载 ​

查询任务状态 ​

状态说明 ​

准备图片与视频素材 ​

下载任务结果 ​