切换主题
查询与下载
视频使用统一任务管线。创建接口返回的 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 秒。不要高频轮询;任务完成后及时保存结果。
