创建任务
调用 POST /api/v3/contents/generations/tasks，content 可放 text、image_url、video_url、audio_url。
多模型整合 · Key 鉴权 · 异步查询
多媒体生成 能力整合
把多种媒体生成能力整合到统一 API：提交视频或图片任务后返回任务 ID；轮询任务接口获取 queued、running、succeeded 或 failed 状态，成功后返回 video_url 或 image_url。
POST 创建媒体任务
GET 查询任务结果
Queue 任务排队
当前开放
接入后完成三件事
创建视频或图片任务、查询任务状态、在成功后返回结果地址；视频输入可包含文本、参考图、参考视频和参考音频。
当前开放模型
视频生成模型
以 /api/v3/models 返回为准
当前开放模型
轻量视频生成模型
以 /api/v3/models 返回为准
当前开放模型
图像生成模型
以 /api/v3/models 返回为准
当前开放模型
音乐生成模型
以 /api/v3/models 返回为准
能力：视频任务支持文本、参考图、参考视频和参考音频；图片任务通过 /api/v3/images/generations 入队，成功后返回 content.image_url。音乐任务通过 /api/v3/music/generations 入队，成功后返回 content.audio_urls。
查询结果
调用 GET /api/v3/contents/generations/tasks/:id，返回 queued、running、succeeded 或 failed。
Key 权限
每个 Key 绑定可用模型、视频、图片与音乐并发数；明文 Key 只在创建时显示一次。
结果回传
成功后返回视频或图片地址；失败时返回明确错误码，便于业务侧重试或人工处理。
接入步骤
从申请账号到拿回生成结果
申请通过后拿到 Key；业务侧提交视频或图片任务并保存 task id；轮询查询接口，直到状态变为 succeeded 或 failed。
- 提交申请填写团队名、联系方式、使用场景和预计并发。
- 确认额度按视频、图片、音乐并发和可用模型开通权限。
- 领取 Key审核通过后生成 sk-oneact-*，调用时放在 Authorization: Bearer。
- 提交任务POST 创建任务，传入提示词和可选参考素材，保存返回的 task id。
- 查询结果GET 任务详情；succeeded 时读取 content.video_url 或 content.image_url。
接口示例
提交任务后用同一个查询接口拿结果
视频任务和图片任务都按异步方式处理；查询接口统一返回 queued、running、succeeded 或 failed。
curl -X POST https://your-domain.example/api/v3/contents/generations/tasks \
-H 'authorization: Bearer sk-oneact-替换成你的Key' \
-H 'content-type: application/json' \
-d '{"model":"替换成 /api/v3/models 返回的视频模型 ID","content":[{"type":"text","text":"A cinematic shot of a paper boat drifting on water."},{"type":"image_url","image_url":{"url":"https://example.com/reference.png"}}],"duration":5,"ratio":"16:9","resolution":"720p"}'
curl -X POST https://your-domain.example/api/v3/images/generations \
-H 'authorization: Bearer sk-oneact-替换成你的Key' \
-H 'content-type: application/json' \
-d '{"model":"替换成 /api/v3/models 返回的图片模型 ID","prompt":"A vertical poster for a neon cyber cafe.","ratio":"9:16","resolution":"High (2K)"}'
curl -X POST https://your-domain.example/api/v3/music/generations \
-H 'authorization: Bearer sk-oneact-替换成你的Key' \
-H 'content-type: application/json' \
-d '{"model":"替换成 /api/v3/models 返回的音乐模型 ID","title":"雨夜追逐","prompt":"tense low drums, guzheng, rain ambience, instrumental","instrumental":true}'并发与权限
并发与权限配置
当前由人工审核与人工配置。每个 Key 会绑定可用模型、视频、图片和音乐并发；达到当前并发时，新请求会返回 429，调用方应在本地排队后重试。
用于联调和小批量测试；达到并发后由调用方在本地排队重试。
按项目设置视频并发，用于批量分镜或短片任务。
需要更高并发时，在申请备注里说明调用峰值。
申请表单
申请接入
提交后进入审核流程；通过后会按申请的并发数创建 Key，并通过你填写的联系方式发回。
查询 / 领取
用提交后得到的申请编号查询审核状态；通过后在此领取 API Key。
接入答疑
常见问题
这里整理接入时最常见的状态、并发、图片任务和结果处理问题。
任务状态有哪些？
任务状态包括 queued、running、succeeded、failed。成功时响应包含 content.video_url 或 content.image_url。
并发满了怎么办？
任务继续返回 task id，并保持 queued；前面的任务完成后会继续处理，或申请提高视频/图片并发。
图片生成能用吗？
可以。POST /api/v3/images/generations 会创建图片任务，查询同一个 task id，成功后读取 content.image_url。
结果地址怎么用？
succeeded 后直接读取结果地址；建议业务侧保存 task id，方便后续重新查询或排查失败原因。