视频生成

通过一个 API 由文字或图片生成视频：发送请求、轮询状态、下载文件，并查看每个模型每秒的确切价格。

用文字生成视频：请求、状态、下载，以及每秒的价格。

全部模型、功能与价格面向 AI 智能体的文档索引： https://oneprovider.dev/docs/llms.txt

可用的视频模型

kling-3.0 Runnable

720p, no sound: US$0.672 / 秒
1080p, no sound: US$0.896 / 秒
720p, with sound: US$1.008 / 秒
1080p, with sound: US$1.344 / 秒

720p · 1080p · 5–10s kling-3.0-turbo Runnable

720p, sound included: US$0.896 / 秒
1080p, sound included: US$1.12 / 秒

720p · 1080p · 5–10s

工作流程

发送 POST /v1/videos/generations，带上模型、提示词和选项。响应中包含 request_id。
视频是异步生成的，通常需要 1–3 分钟。每 10 秒查询一次状态，直到完成或失败。
状态为 done 时，使用同一个密钥，从 video.url 中的路径下载文件。

请求

bash

curl -sS https://api.oneprovider.dev/v1/videos/generations \
-H "Authorization: Bearer $ONEPROVIDER_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-3.0",
"prompt": "A red balloon rises over a quiet harbor at sunrise",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
}'
# {"request_id":"task_..."}

请求参数

字段	值
`model`	必填。上方表格中的模型 ID。
`prompt`	必填。视频的描述。
`duration`	时长（秒）：`5`（默认）或 `10`。
`resolution`	`720p`（默认）或 `1080p`。
`aspect_ratio`	`16:9`（默认）或 `9:16`。
`audio`	`true` 会添加声音（每秒价格更高）。`kling-3.0-turbo` 始终带声音。

不在价格表中的组合会立即被拒绝并返回 400 错误，不会扣费。

状态

bash

curl -sS https://api.oneprovider.dev/v1/videos/generations/$REQUEST_ID \
-H "Authorization: Bearer $ONEPROVIDER_KEY"
# {"request_id":"task_...","status":"pending","progress":50}
# {"request_id":"task_...","status":"done","progress":100,
# "video":{"url":"/v1/videos/generations/$REQUEST_ID/content","duration":5}}

状态

status	该怎么做
`pending`	视频仍在生成。请 10 秒后再查询。
`done`	已就绪。请从 `video.url` 下载文件。`video.duration` 是计费时长。
`failed`	视频未能生成。不会扣费；请重新发送请求。

下载

bash

curl -sS https://api.oneprovider.dev/v1/videos/generations/$REQUEST_ID/content \
-H "Authorization: Bearer $ONEPROVIDER_KEY" \
-o video.mp4

响应是 video/mp4 文件，支持 Range 请求头。请立即把文件保存到您自己这边；不要指望链接永远有效。

价格

您按视频的秒数付费，费率取自上方表格中对应的行（分辨率和声音）。扣费只发生一次，在状态变为 done 时；失败或未完成的视频不会扣费。

示例：kling-3.0，720p，无声，5 秒 = US$0.672 × 5 = US$3.36。

错误

错误码

HTTP	原因
400	字段无效，或组合不在价格表中。
401	密钥无效或已被撤销。
402 / 403 / 429	余额不足，或已达密钥限额。请充值后重试。
404	该密钥下没有这个 request_id。
502	视频服务暂时不可用。未扣费；请稍后重试。

一个密钥通用所有模型视频与文本使用同一份余额支付。完整的模型和价格表见价格页面。

快速解答

该使用哪个 base URL？

Claude Code 和 Anthropic SDK 使用 https://api.oneprovider.dev。OpenAI SDK 和兼容 OpenAI 的客户端使用 https://api.oneprovider.dev/v1。同一个密钥可用于这两个地址；模型列表见模型页面，费率见价格页面。

如何进行身份验证？

将完整的 sk-… 密钥放在 x-api-key 或 Authorization: Bearer 中，二选一，不要同时使用。请把密钥存放在环境变量中，不要写进会被提交的文件。了解更多身份验证说明。

在哪里获取密钥？

在 Telegram 机器人 @oneprovider_robot 或 app.oneprovider.dev 打开您的个人中心，为余额充值，然后点击“签发密钥”。每个密钥都可以设置各自的消费限额。个人中心与 API 密钥。

401、404 和 429 是什么意思？

401：密钥缺失、拼写有误或放错了请求头；请粘贴完整的密钥，不要带引号或空格。404：通常是 base URL 不对，例如缺少或重复了 /v1。429 且提示“Insufficient balance”：个人中心余额或密钥的消费限额已用完，请充值，不要反复重试；其他 429 属于速率限制，请等待 Retry-After 指定的时间。详情见：错误码和故障排查。

流式输出为什么会中断或被重置？

VPN 和 VLESS 代理常常会缓冲 SSE，或破坏 HTTP/2 协商。OneProvider 没有地区限制，也不会缓冲流式输出，请关闭代理后重试。

以上都没解决，该去哪里咨询？

请在 Telegram 联系 @Oneproviderhelpbot ，或在网页个人中心打开“客服”，并附上 HTTP 状态码和完整的错误信息。客服如何运作。

最后更新: 2026-11-08 发现问题？ @Oneproviderhelpbot