图片与视频快速开始

本部分的异步任务接口仅适用于下列协议兼容模型；不是所有图片模型都使用 /v1/videos。本站在线生图另见 生图工作台教程。

更新于 2026-09-20 · 页面与服务规则以当前控制台为准

在线操作还是代码调用

想直接在网页生图，打开 生图工作台，使用当前账户余额；步骤见 图文教程。视频创作空间入口为 cly.dragon3api.com，按其登录与令牌绑定流程操作。

本部分面向需要代码调用的用户。 先选模型，再按模型文档使用接口。不是所有图片模型都走同一种协议。

选择对应模型文档

• 图片接口与模型：先确认模型所在分组和输入格式。
• 视频接口与模型：确认时长、比例、分辨率和参考素材要求。
• 图片／视频价格：价格信息仅作查阅，最终以当前控制台与实际计费为准。

本目录中采用异步统一协议的模型使用 /v1/videos；本站其他图片模型可能使用 OpenAI Images 或原生协议，不能直接套用下面示例。

异步任务的一般流程

1. 使用支持该协议的模型，按模型文档提交任务。
2. 保存返回的任务 ID，等待 queued / in_progress 状态变化。
3. 查询任务，成功后再读取结果或下载。
4. 失败时查看 error，带任务 ID 排查，避免重复提交。

步骤	兼容异步任务入口
创建	POST /v1/videos
查询	GET /v1/videos/{task_id}
下载	GET /v1/videos/{task_id}/content

具体参数、响应结构和下载方式以所选模型页为准，查看 任务查询与下载。

计费与等待

图片可能按张或规格，视频可能按时长和分辨率计费。高峰时可能排队；客户端超时不代表服务器已取消任务。先用 task id 查询，不要立即再提交一次。

如果既没有任务 ID，也没有明确失败信息，记录请求时间、模型和错误正文，请管理员协助确认是否已创建任务。