Keevx
用 Keevx API 完成视频翻译与图生视频并控制积分消耗
Keevx API 把 AI 视频生产压缩成一次接口调用：视频翻译、图生视频、AI 生图都能通过 API Key 触发。本文从账号与密钥准备讲起，逐项拆解各套餐的积分与并发上限、按秒与按张计费的规则，并给出一个从鉴权到提交任务的完整示例，帮助你在动手前就把成本与配额算清楚。
Keevx API 面向的是需要批量生产视频的开发者与团队：它把视频翻译、图生视频、AI 生图这几类能力包装成接口，让原本要在剪辑软件里手工完成的工作变成一次请求。适合的场景包括把已有视频本地化成多种语言版本、把静态图片做成动态短片、以及按需批量生成配图。真正决定项目能否跑顺的往往不是接口本身，而是积分怎么扣、并发有多少、密钥怎么管——这篇教程就围绕这三点展开，把调用前的准备、计费口径和一个可跑通的最小示例讲清楚。如果你更想先在网页端熟悉这套能力，可以从 Keevx 的工具页进入。
准备工作
在写第一行代码之前，需要把三样东西备齐：账号、凭证、积分。缺任何一样，请求都会在鉴权或额度环节被拦下。
注册 Keevx 账号
先在 Keevx 注册账号，注册完成后才能进入 API Management 控制台。控制台是生成密钥、查看积分、配置自动充值的唯一入口。
获取 API Key
API Key 是每一次请求的身份凭证，它同时决定了你的任务按哪个套餐的并发上限被处理。进入 API Management 控制台有两条路径：
- 侧边栏入口：在首页左侧边栏底部点击 API Management 按钮。
- 头像菜单入口：点击右上角用户头像，在下拉菜单中选择 API Management。
进入控制台后即可看到属于你的 API Key。如果你在某个工作区或团队下操作，需要先拥有一个有效的 API 订阅（Starter、Pro 或 Enterprise），否则看不到这组凭证。
确认套餐与积分
免费版用户可以领取 10 个积分，这是一次性额度，适合先把调用链路跑通。需要更大用量时再升级到付费套餐，付费用户可以使用视频翻译与视频生成的全部工具集。各档位对应的积分与并发上限如下：
| 套餐 | 价格 | 包含积分 | 并发上限 | 备注 |
|---|---|---|---|---|
| Free | $0 | 10（一次性） | Basic | 仅可领取一次 |
| Starter | $99 / 月 | 1,000 / 月 | 1 | 无水印 |
| Pro | $299 / 月 | 3,200 / 月 | 3 | 无水印 |
| Enterprise A | $1,999 / 年 | 25,000 / 年 | 5 | 约 20% 折扣 |
| Enterprise B | $3,999 / 年 | 52,000 / 年 | 10 | 约 23% 折扣 |
| Enterprise C | $7,999 / 年 | 110,000 / 年 | 20 | 约 27% 折扣 |
价格、积分额度与并发数会随官方调整而变化，下单前请以官网当前展示的信息为准。
套餐支持即时升级或降级，也支持在下一个计费周期生效。如果账号下同时存在多个有效套餐，积分会自动叠加，消费时优先扣除最早到期的积分。
操作步骤
第一步：把积分口径算清楚
Keevx 的积分按「使用的功能 + 输出时长」消耗，不同功能的计费单位并不一样。动手前先按下面的规则估算一次任务的成本，可以避免跑到一半额度见底。
视频翻译按 30 秒为一个计费单位，每个单位消耗 5 个积分。也就是说，一段 90 秒的视频会落在 3 个计费单位上。
图生视频的成本取决于底层引擎与输出设置：
| 模型 / 功能 | 计费规则 |
|---|---|
| 标准模型 · 首尾帧视频（带声音） | 4 积分 / 秒 |
| 标准模型 · 首尾帧视频（无声音） | 2 积分 / 秒 |
| 标准模型 · 多参考图生视频 720P | 1 积分 / 秒 |
| 标准模型 · 多参考图生视频 1080P | 2 积分 / 秒 |
| Pro 模型 720P | 3 积分 / 秒 |
| Pro 模型 1080P | 5 积分 / 秒 |
AI 生图按张计费：
| 模型 / 功能 | 计费规则 |
|---|---|
| 标准模型 | 1 积分 / 张 |
| Pro 模型 1080P、2K | 2 积分 / 张 |
| Pro 模型 4K | 3 积分 / 张 |
把这三张表放在一起看，可以得出一个很实用的结论：同样一段时长，选择标准模型、关闭声音、降低分辨率，成本会成倍下降；而 Pro 模型 1080P 是单价最高的一档。批量任务前先用低配置跑通流程，再按需提高画质，是控制预算的常规做法。
第二步：安全地保存密钥
API Key 直接关联你的积分余额与项目数据，属于敏感凭证。落地时有两条硬性要求：
- 不要暴露在客户端：不要把密钥写进浏览器端代码，也不要提交到 GitHub 这类公开仓库。密钥应当只存在于服务端环境变量或密钥管理服务中。
- 泄露后立即重置：一旦怀疑密钥外泄，在 API Management 控制台点击 Regenerate 按钮吊销旧密钥并签发新密钥，不要等待。
在代码里读取密钥的推荐方式是环境变量，例如在 shell 中设置：
export KEEVX_API_KEY="你的 API Key"后续所有请求都从环境变量取值，源码中不出现明文密钥。
第三步：为每个请求带上鉴权信息
Keevx API 的每一个请求都必须使用有效的 API Key 完成鉴权。这组凭证既用于识别调用方，也决定了任务按哪个套餐的并发上限被调度。因此请求头中必须携带密钥，示例结构如下：
curl -X POST "https://api.keevx.com/v1/your-endpoint" \
-H "Authorization: Bearer $KEEVX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": "your-payload"
}'上面的地址与路径是占位写法，实际调用时请以控制台中对应功能的接口地址为准。需要强调的是：鉴权失败与积分不足是两类不同的错误，前者检查密钥是否正确、是否已被重置，后者检查账户余额是否足够覆盖本次任务的预估消耗。
第四步：按并发上限安排任务队列
并发上限指的是同一时刻可以并行处理的 API 请求数量，它由当前套餐决定。Free 为 Basic 级别，Starter 为 1，Pro 为 3，Enterprise A/B/C 分别为 5、10、20。升级套餐会立即提高并发上限。
这意味着批量任务不能简单地一次性全部发出。以 Starter 套餐为例，并发为 1，同一时刻只能有一个任务在跑，其余请求需要排队。工程上的做法是维护一个任务队列，控制同时在途的请求数不超过套餐上限，任务完成后再放行下一个。如果业务量明显超过当前档位，升级套餐比在客户端做复杂的重试更划算。
第五步：配置自动充值
余额不足会直接中断服务。可以在 Dashboard 中设置自动充值规则，当余额低于阈值时自动补充积分，避免批量任务跑到中途失败。对于长时间运行的流水线，这一步建议在正式上线前就配好。
一个完整示例
下面用一个最小场景把整条链路串起来：把一段 60 秒的视频做翻译，并估算这次调用的积分消耗。示例只演示结构与计算，具体接口路径与请求体字段请对照控制台中的接口说明填写。
1. 准备环境变量
export KEEVX_API_KEY="你的 API Key"2. 估算成本
视频翻译按 30 秒一个计费单位、每单位 5 积分计算。60 秒的视频对应 2 个计费单位，预估消耗 10 积分。免费版的 10 个一次性积分刚好够跑完这一条，跑完即用尽；如果还要继续测试，需要升级到付费套餐。
3. 提交任务
curl -X POST "https://api.keevx.com/v1/video-translation" \
-H "Authorization: Bearer $KEEVX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"video_url": "https://example.com/source.mp4",
"target_language": "en"
}'请求发出后，服务端会依据你的套餐校验并发额度与积分余额。如果当前已有任务在跑且并发已满，新任务需要等待；如果余额不足以覆盖预估消耗，请求会被拒绝。
4. 换成图生视频时的成本对照
同样是 60 秒的输出，不同配置的积分差距非常明显：标准模型多参考图生视频 720P 为 1 积分/秒，合计 60 积分；1080P 为 2 积分/秒，合计 120 积分；Pro 模型 720P 为 3 积分/秒，合计 180 积分；Pro 模型 1080P 为 5 积分/秒，合计 300 积分。若使用标准模型的首尾帧视频，带声音为 4 积分/秒（240 积分），不带声音为 2 积分/秒（120 积分）。
把这些数字和套餐额度对照，就能判断某个批量任务应该放在哪一档套餐上。例如 Pro 套餐每月 3,200 积分，若全部用于 Pro 模型 1080P 的图生视频，按每秒 5 积分计算，可支撑的时长相当有限；而换成标准模型 720P，同样的积分能覆盖的时长会多出数倍。
5. 生图任务的计费
如果流水线里还需要配图，标准模型每张 1 积分，Pro 模型 1080P 与 2K 每张 2 积分，4K 每张 3 积分。生图按张计费，与视频的按秒计费相互独立，估算总成本时要把两部分相加。
注意事项
积分会过期
月度积分在计费周期结束时失效，不会结转到下个周期。年度 Enterprise 积分有效期为一年。因此不要把积分长期闲置，也不要在周期末尾一次性囤积大量任务。
多套餐积分叠加与扣减顺序
账号下存在多个有效套餐时，积分自动叠加，消费时优先扣除最早到期的积分。这个顺序对成本核算有实际影响：如果你同时持有月度和年度套餐，先被消耗的是即将过期的那部分。
工作区权限
在特定工作区或团队中操作时，必须拥有有效的 API 订阅（Starter、Pro 或 Enterprise）才能看到 API 凭证。免费版用户虽然能拿到 10 个积分，但在工作区场景下可能看不到密钥，需要先确认订阅状态。
并发与重试
并发上限由套餐决定，升级后立即生效。在客户端做重试时要注意不要把并发打满，否则新请求会持续排队甚至失败。合理的做法是让在途请求数始终低于套餐上限，并为每个任务设置超时与退避策略。
密钥轮换
怀疑密钥泄露时，使用控制台的 Regenerate 按钮吊销旧密钥并签发新密钥。轮换后记得同步更新服务端环境变量，否则所有请求都会因鉴权失败而被拒绝。
价格与额度的时效性
套餐价格、积分额度、并发上限与各功能的计费规则都可能调整，本文所列数字仅反映整理时的信息。正式采购或做容量规划前，请以官网当前展示的套餐与计费说明为准。遇到技术问题或需要确认积分规模，可以通过 support@keevx.com 联系支持团队。