让 Codex 或 Workbuddy 帮你从低价模型开始试
点击上方“复制全部”或“下载完整文档”,把文档交给你信任的 Agent(例如 Codex 或 Workbuddy),再通过它的安全配置提供平台 API Key。告诉它你的素材、时长、清晰度和预算,让它优先尝试符合需求的低价模型。
为什么这样用?平台接入了多个低价渠道,各渠道每天的可用额度、排队情况和稳定性可能变化。让 Agent 先核对当前模型与价格,再从低价选项开始小量尝试,确认失败后才换下一个,可以减少手动选型的麻烦;低价不代表随时可用,也不保证最快出片。
可以把下面这段话一起发给 Agent
请按照这份 API 文档生成视频。先获取当前可用模型和价格,筛选符合我的素材、时长、清晰度要求的模型,再按预计整条费用从低到高尝试。按条、按秒和按 Token 的单价不能直接比较;按 Token 计费只能估算,请先说明预计费用。
请先与我确认总预算和最多尝试次数,每次只提交一条任务。拿到任务 ID 后,每隔 5~10 秒查询状态;排队、超时或结果不明确时继续核查原任务,不要重复提交或切换模型。网络重试沿用同一幂等键。只有确认任务失败、核实扣费状态后,才在预算内尝试下一个模型;不要绕过内容审核。成功后把视频链接和实际消费金额给我。
API Key 请从我提供的安全配置读取,不要写进代码、文档或日志。
密钥提醒:复制和下载的文档不含你的真实 API Key。只向自己信任的 Agent 提供密钥,建议通过环境变量或密钥管理功能配置;不要发到公开群聊或提交到代码仓库。文档是导出时的快照,实际调用前请重新查询模型和价格。
5 分钟接入
拿到密钥,创建任务,再取回视频。
API 是异步的:创建后会先返回任务 ID。每隔 5~10 秒查一次,看到 succeeded 后读取视频链接。
model。平台会在后台自动选择可用线路。先跑通一条任务
把示例里的密钥换成你的密钥。开启超分后,平台会自动先生成 480P,再升到目标清晰度。
SD 2.0 系列
SD 2.0 提供标准版和快速版。
SD 2.5 特惠版
seedance-2.5-720p-nv 固定输出 720P,支持 4~30 秒。
视频生成·扩展模型
SD-2.5-30s、sd2.0-720-900、sd-2.0-T 与 sd-2.0-vip 是新增模型,不影响原有线路。
查询这条任务
看到 status: "succeeded" 后,超分前视频在 content.source_video_url,超分后视频在 content.video_url。平台会自动转存到 OSS;storage.persistent 为 true 时表示已完成持久保存。
接口一览
所有业务接口都需要 Authorization: Bearer 你的密钥。
| 方法 | 地址 | 用来做什么 |
|---|---|---|
GET | /v1/balance | 查询当前 API Key 所属账户的可用积分 |
GET | /v1/models | 查询当前可调用的模型、能力、价格和近 1 小时成功率 |
POST | /v1/videos/generations/tasks | 创建视频任务 |
GET | /v1/videos/generations/tasks/{任务ID} | 查询单条任务和最终结果 |
GET | /v1/videos/generations/tasks | 分页查询当前密钥所属客户的任务 |
POST | /v1/files | 上传素材;图片和视频会自动登记到上游素材库 |
GET | /v1/files | 查询已上传的素材 |
DELETE | /v1/files/{素材ID} | 从素材列表移除;任务已用的素材仍保留历史预览 |
GET | /healthz | 检查服务是否在线,无需密钥 |
查询账户余额
建议程序启动时和遇到任务失败时查询一次。HTTP 200 表示密钥有效;HTTP 401 表示密钥无效或已停用。data.balance 是当前可用积分。
查询可用模型
近 1 小时成功率:读取 data[i].success_rate_1h.percent(0~100 的百分数,非 0~1 比例)。按本站该模型、对应线路近 3600 秒内结束的任务统计:成功数 ÷(成功数+失败数),四舍五入到整数;排队和生成中的任务不计入。没有已结束样本时返回 null,不是 100%。这不是上游全站统计,也不保证下一次调用成功。
{"success_rate_1h":{"percent":87,"sample_level":"sufficient","window_seconds":3600,"basis":"finished_at"}}
上述为字段示例。sample_level:none 无样本,limited 1~9 个已结束样本,sufficient 至少 10 个;不公开具体调用量。统计按结束时间滚动计算,前端约每分钟刷新,API 可按需查询,建议间隔至少 60 秒。近 48 小时稳定性指标仍保留用于排序,与近 1 小时成功率分别展示。旧渠道字段 model_success_rates 仅兼容旧客户端,新客户端请使用此字段。
模型列表采用 OpenAI 兼容格式:顶层 object: "list",data 为模型数组,只返回当前已上架且该账号可调用的模型,不返回上游渠道、成本或密钥。旧客户端需要 data.data 时,请使用 /v1/models?format=legacy。
自定义画布接入:Base URL 填本站域名加 /v1(不要重复添加 /v1),模型列表请求 GET /v1/models,使用平台客户 API Key。浏览器跨域调用支持这些 Bearer API 接口,请勿携带登录 Cookie(fetch 使用 credentials: "omit");只在可信的私人画布中输入自己的 Key,公开应用请由服务端保管密钥。模型列表兼容不代表聊天接口兼容:视频仍须通过 POST /v1/videos/generations/tasks 创建、查询任务,不支持用 /v1/chat/completions 生成视频。
查询任务列表
列表支持 page_num、page_size(1~100)、status 和 model 筛选。
创建任务参数
只写提示词时,最少传 model 和 content。其他能力都通过下面的 API 参数设置。
| 参数 | 是否必填 | 怎么填 | 默认值 |
|---|---|---|---|
channel | 无需传入 | 平台按 model 自动选择线路 | 自动 |
model | 必填 | 渠道 1:video-pro 等;渠道 4:seedance-2.5-720p-nv | — |
content | 必填 | 非空数组;支持文字、图片、视频、音频 URL | — |
ratio | 选填 | adaptive、16:9、9:16、1:1、4:3、3:4、21:9 | adaptive |
duration | 选填 | -1 自动,或 4~15 秒;Fast 最长 12 秒 | 5 |
super_resolution | 选填 | 内置超分:{"resolution":"1080p"};腾讯 MPS:{"provider":"tencent_mps","resolution":"2x","type":"hq"} | 不超分 |
resolution | 选填 | 不超分时的原生输出:480p / 720p / 1080p;Mini 不支持原生 1080p | 720p |
generate_audio | 选填 | true 一起生成声音,false 静音 | true |
output_format | 选填 | Seedance 2.5 支持 mp4 / mov;其他模型仅 mp4 | mp4 |
tools | 选填 | 联网搜索仅支持 [{"type":"web_search"}] | 关闭 |
auto_ingest_images | 选填 | 是否自动保存 HTTPS 图片,布尔值 | false |
超分和原生清晰度二选一:传了 super_resolution 后,平台会自动把 resolution 固定为 480p,你不需要自己处理。
XY-SD 2.0:XY-seedance-2 按 0.26 积分/秒;XY-seedance-2-fast 按 1.95 积分/条。duration 支持 4–15 的整数,提示词 2–5000 字符。不传 ratio、resolution、generate_audio,画面由上游自动决定。最多 9 图、3 视频、3 音频,总计 12 份;参考素材请先使用本站上传接口。视频和音频单个 2–15 秒、各类合计最多 15 秒,音频不能单独使用。任务成功后使用本站返回的地址下载,不使用供应商下载地址。
腾讯 MPS 是 2 倍超分:480P 输入通常会得到约 960P 的输出,接口会返回真实宽高;hq 画质优先,lq 速度优先。
渠道 4 参数:ratio 支持 16:9、9:16、21:9、1:1、4:3;duration 支持 4~30 的整数;原生 resolution 支持 480p / 720p,也可选择腾讯 MPS 2 倍超分;不支持 generate_audio 和视频参考。
文字和素材怎么传
本地文件先调用上传接口,再把返回的 data.url 原样放进 content。图片和视频会返回 Asset://,页面预览使用 preview_url。
上传本地素材
X-File-Kind 可传 image、video 或 audio;X-File-Name 传带扩展名的文件名。图片和视频会等到上游素材状态为 active 后才返回成功。涉及真人的参考素材必须使用返回的 Asset://,但仍需遵守上游审核规则。
| 类型 | 格式 | 上限 | 其他要求 |
|---|---|---|---|
| 图片 | JPG / PNG / WebP / BMP / TIFF / GIF | 30MB | 300-6000px,宽高比 0.4-2.5 |
| 视频 | MP4 / MOV | 50MB | 2-15 秒,480P / 720P,24-60 FPS |
| 音频 | MP3 / WAV | 15MB | 2-15 秒 |
保留时间:未使用素材保留 24 小时;被任务使用的原素材保留至最后一个任务结束后 7 天,同时从上传起最长保留 15 天。生成视频等 OSS 文件最长保留 15 天,请及时下载备份。系统每小时清理一次,运行中任务使用的素材暂缓清理;任务参数、消费及结算记录不受影响。
| 素材 | content.type | role | 数量规则 |
|---|---|---|---|
| 文字 | text | 不用传 | 内容不能为空,最多 10,000 字符 |
| 首帧 / 尾帧 | image_url | first_frame / last_frame | 各 1 张;尾帧必须搭配首帧 |
| 参考图片 | image_url | reference_image | 最多 9 张,不能与首尾帧混用 |
| 参考视频 | video_url | reference_video | 最多 3 个 |
| 参考音频 | audio_url | reference_audio | 最多 3 个,必须搭配图片或视频 |
SD 2.5 的素材上限:支持最多 30 张图片和 10 个音频,不支持参考视频。
首尾帧示例
图片、视频、音频混合参考
返回结果和任务状态
创建成功返回 HTTP 201;相同 Idempotency-Key 重试时返回同一任务,避免重复扣费。
正在产生视频,预占金额尚未最终结算。
已完成,按该渠道的计价规则从余额结算。
失败原因在 error,预占金额会自动退回。
成功结果示例
billing.amount 是本次人民币实付金额;渠道 1 还会在 usage.total_tokens 返回生成和超分合计用量。
需要长期链接时:任务成功后继续查询,直到 storage.persistent 为 true。此时 content.video_url 已经是 OSS 地址。
常见错误
接口错误都会返回 {"success":false,"error":{"code":"...","message":"..."}}。
| HTTP | 错误码 | 怎么处理 |
|---|---|---|
| 400 | BAD_REQUEST | 参数不符合规则,直接看 message 修改 |
| 401 | UNAUTHORIZED | 检查 Bearer 密钥是否完整、有效 |
| 402 | INSUFFICIENT_BALANCE | 人民币余额不足,请联系管理员充值 |
| 404 | NOT_FOUND | 任务不存在,或任务不属于当前客户 |
| 413 | UPLOAD_TOO_LARGE | 文件超过当前类型的大小上限 |
| 429 | RATE_LIMITED | 请求太快,稍等后重试 |
| 502 | UPSTREAM_ERROR | 上游暂时不可用;创建失败会自动退回预占金额 |
| 500 / 502 | UPLOAD_FAILED / OSS_DELETE_FAILED | OSS 暂时不可用,稍后使用同一文件重试 |
建议:每次创建都传一个业务唯一的 Idempotency-Key,最长 128 个字符。网络超时后可以安全重试,不会重复创建任务或重复扣费。