ClipMixAI 开发者 API 正式开放：视频翻译、AI 音乐、换脸头像与记忆视频，一个接口全搞定

今天，我们将驱动 ClipMixAI 网页应用的底层引擎向所有开发者开放。全新的开发者 API 托管于 api.clipmixai.com/api/v1，通过单一 Bearer Token REST 接口提供四项服务——视频翻译、记忆视频、换脸与虚拟形象、AI 音乐。模型相同，质量相同，积分体系相同。无需订阅，无最低消费。

如果不想看完整介绍：/api 是产品介绍页，/api/docs 是接口文档，/dashboard/api-keys 是创建密钥的地方。

为什么要做这件事

在过去一年里，我们一次次看到付费用户重复同样的操作：打开控制台、上传 30 张照片、点击创建、等待歌曲生成，再手动将结果推送到另一个编辑工具。我们见过有创始人把创作者内容翻译成 10 种语言，有广告公司每周制作 100 条品牌视频，有独立游戏工作室为原型生成临时音乐。所有人最终都会问同一个问题："有 API 吗？"

现在有了。驱动这些工作流的四项服务，现在可以直接通过代码调用——无需经过控制台，无需摸索各个服务商的接口细节，定价与网页端完全一致，按积分计费，清晰明了。如果一个原本需要人工花一小时完成的工作流，现在能用定时任务在后台自动跑完——这正是我们想要的。

快速开始

在控制台生成密钥后，执行：

curl -X POST https://api.clipmixai.com/api/v1/music \
  -H "Authorization: Bearer sk_live_..." \
  -H "Idempotency-Key: my-fresh-key-1" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt":   "Uplifting synthwave with female vocals",
    "lyrics":   "[verse]\nRunning through neon lights...",
    "duration_seconds": 60
  }'

调用后会立即返回一个 job-id，状态为 status: "processing"。你可以轮询 GET /v1/music/{id} 直到状态变为 completed，或者更好的方式——在创建密钥时配置 Webhook，由我们将完成的结果 POST 到你的端点，并附带 HMAC-SHA256 签名供你验证来源。

开发者长期以来的三个需求，我们终于实现了

1. 沙盒密钥

每个 API 密钥都有一种模式：sk_live_ 会消耗积分并调用真实服务；sk_test_ 不收费、不调用服务商，而是返回一个带有 test: true 字段的合成 completed 任务。在 CI 环境中使用沙盒密钥，可以在不消耗积分的情况下验证集成逻辑，需要真实输出时再切换到正式密钥即可。

沙盒密钥对所有人免费开放，包括免费账户用户。使用正式密钥的唯一前提是至少完成一次积分充值，与网页端相同的付款门控保持一致。

2. 每次 POST 均支持幂等键

网络重试是涉及计费的 API 最大的隐患。我们借鉴了 Stripe 的方案：在任意创建请求中传入 Idempotency-Key: <your-string>，服务器会将响应缓存 24 小时。使用相同密钥 + 相同请求体重试，将返回原始响应，绝不重复扣费。若使用相同密钥但请求体不同，则返回 422 idempotency_key_reuse，帮你精准定位问题，而不是悄悄创建出错误的任务。

两个官方 SDK 均将其封装为单一关键字参数：

# Python
c.music.create(prompt=..., lyrics=..., idempotency_key="order-42")

// JS
await c.music.create({ prompt, lyrics, idempotencyKey: "order-42" });

3. 带测试触发按钮的 Webhook

在密钥上配置回调 URL 后，每当任务完成，我们会向你的端点 POST job.completed / job.failed 事件。每次投递都在 X-ClipMix-Signature: sha256=<hex> 头部携带 HMAC 签名——可使用任一 SDK 中的辅助函数进行验证。投递失败后会以指数退避策略重试（0 秒 → 30 秒 → 5 分钟 → 1 小时，共 4 次）。

控制台提供发送测试按钮，可发出一个合成的 webhook.test 事件，让你无需等待真实任务即可验证端点的签名解析逻辑。同一面板还展示每个密钥最近 100 条投递日志，出现问题时无需猜测哪里出了错。

我们已经看到的三种使用场景

为创作者批量翻译视频

上传一个视频，获得 10 种语言的配音版本，可选开启保留说话者音色的语音克隆功能。已有一位 YouTube 创作者借此在全自动模式下将每周播客翻译成 9 种语言——API 调用由其现有的发布钩子触发，Webhook 将配音文件直接投送到 CMS。

为每位顾客定制品牌视频

照片转视频的记忆视频功能，让电商平台可以将顾客的商品照片生成一段专属的短片广告。family-videos 端点提供四种模式（Moment、Story、Album、Chronicle），这些模式最初为我们的消费端 UI 而设计；如今，广告公司正将其作为白标工具的底层引擎。

游戏音频原型制作

独立游戏工作室正在其内部资产管线中调用 /v1/music 端点。游戏设计师输入一段情绪描述和几句占位歌词，10 分钟后，一首 60 秒的音轨就出现在项目的音频文件夹里。他们可以在几秒内迭代临时音乐，而无需每次改动都等待音效师。

版本策略与我们的承诺

v1 是稳定版本。我们不会在 /api/v1/ 内引入破坏性变更——新字段和新端点仅以追加方式添加，现有接口保持不变。必须进行的破坏性变更（极少发生）将在 /api/v2/ 下发布，并提前公告过渡期。变更日志是唯一权威信息来源。

服务运行状态实时展示于 /api/status——基于近 5 分钟真实流量的各服务健康快照，每 60 秒更新一次，与我们值班人员看到的视图完全一致。

定价

与网页端共用同一积分钱包。$1 = 100 积分，充值时享有现有的阶梯折扣。一首 60 秒的歌曲消耗 60 积分（$0.60）。均衡档的 30 秒说话人头像消耗 450 积分。高级档翻译一分钟视频约消耗 190 积分。沙盒密钥免费。

分级 API 套餐（Pro / Business / Enterprise），含批量折扣和优先处理队列，即将推出。如有需要，欢迎在 /contact?topic=api-tiers 留下邮箱，上线时我们会第一时间联系你。

立即体验

• /api — 五分钟产品介绍
• /api/docs — 接口文档（认证、幂等性、Webhook、沙盒、错误码、SDK）
• /api/status — 实时服务健康状态
• /api/changelog — 已发布内容与后续计划
• /dashboard/api-keys — 生成你的第一个密钥

Bug 报告和功能建议：GitHub Issues。其他问题：support@clipmixai.com。