跳转到内容
Luma39 文档

BYOK 接入(完全免费)

BYOK = Bring Your Own Key。如果你已经有豆包、可灵、火山或腾讯的开发者账号,可以把自己的 API Key 填到 Luma39,所有调用直连官方计费,平台不收任何费用。

BYOK 适合谁

  • ✅ 已经在豆包/可灵开发者后台开通,有用量,只是想要一个集成度高的工作台 UI
  • ✅ 团队/中重度用户,月消耗超过几百元,想跳过平台 markup
  • ✅ 对数据出口有要求(直连官方,不经平台中转余额)

不适合:第一次用、不懂 API、只想快速试试效果——这些情况直接用网站 Key 充值更省事。

安全说明(先看这个)

很多人 BYOK 之前会担心 Key 被偷,这里把规则讲清楚:

  • Key 服务器 AES-256-GCM 加密落盘,主密钥跟 DB 放在不同位置
  • 前端只能看到脱敏的「**** + 后 4 位」预览
  • 管理员也无法解密查看明文(密钥设计上不让管理员碰)
  • 你可以随时在「账户 - API Key 来源」中替换或撤销

如果还是不放心,给豆包/可灵那边的 Key 加 IP 白名单(豆包 ARK 后台支持)、设置消耗上限(可灵后台支持)就完全可控。

接入步骤

第一步:申请官方 Key

如果还没账号,先去申请:

服务商官网需要什么
豆包 Seedance(视频/图片)volcengine.com火山引擎账号 + 开通豆包大模型
可灵 Klingklingai.com可灵账号 + 开通 API
火山豆包音乐跟豆包同账号开通 imagination 服务
腾讯混元 VCLM(演唱视频)腾讯云控制台腾讯云账号 + 开通混元生视频

可以只配一家(比如只用豆包),不强制全配。没配的服务商功能会自动隐藏。

第二步:进 Luma39 配置页

  1. 登录工作台 → 右上角头像 → 账户
  2. 左侧「API Key 来源」标签页
  3. 看到两个卡片:「使用网站 Key」(默认) vs 「使用自己的 Key」
  4. 点「使用自己的 Key」,展开各服务商表单

第三步:填 Key

豆包(单个 Key):

ARK_API_KEY: 在火山方舟控制台「API Key 管理」生成

可灵(双 Key,Access Key + Secret Key):

ACCESS_KEY: 在可灵控制台「API 密钥」生成
SECRET_KEY: 同上,跟 AK 配对生成

火山豆包音乐(双 Key,V4 签名格式):

ACCESS_KEY: 火山引擎账号通用 AK
SECRET_KEY: 火山引擎账号通用 SK

腾讯混元(双 Key,TC3 签名):

SECRET_ID: 腾讯云访问密钥 SecretId
SECRET_KEY: 腾讯云访问密钥 SecretKey

第四步:验证

填完保存后,工作台顶部会出现一个绿色徽标 BYOK 模式。点一下随便生成什么,如果没扣积分 = 接入成功。

如果报错:

  • 1102 等错误码 → 故障排查
  • Key invalid / Forbidden → Key 填错或没开通对应服务,回服务商后台检查
  • 内容审核拦截 → BYOK 不能绕过审核,跟用网站 Key 一样要遵守内容规则

BYOK 模式下的注意事项

1. 计费完全在你那边

工作台不再扣你的积分,但不代表免费——豆包/可灵那边按 API 调用次数照常收钱。养成自己管账的习惯,定期看官方账单。

2. 失败仍然会被官方计费(部分场景)

豆包/可灵在某些失败场景下也会扣费(比如内容审核拦截、超时被中断)。这是它们的计费规则,Luma39 影响不到。

3. 失败任务不退积分(因为本来就没扣)

工作台不知道你那边账单,所以失败也不会”退什么”。如果想精确算成本,自己看官方控制台的账单页。

4. 切换回网站 Key

随时可以——「账户 - API Key 来源」点回「使用网站 Key」即可。Key 不会被删,只是暂停使用。再切回 BYOK 不用重填。

5. 团队不要共享同一个 Key

如果是团队用,给每个成员单独 Luma39 账号 + 各自填 Key,别用同一个账号让大家共享 Key——后续审计、配额管理都更方便。

常见问题

Q:能只配一家服务商吗? A:可以。只配豆包就只有豆包模型可用,可灵那边的功能(包括 264 个特效模板)会自动隐藏。

Q:Key 配了之后能查看明文吗? A:不行。设计上让管理员都查不到,你也查不到。如果忘了 Key 内容,去服务商控制台重新生成一个。

Q:BYOK 模式还能用工作台的高级功能吗(角色库、提示词优化、特效模板)? A:全部可以——BYOK 只是改了底层 API 调用的鉴权方式,工作台 UI 层面的功能完全保留。

Q:Key 被泄露了怎么办? A:第一时间去服务商后台禁用旧 Key + 生成新 Key,然后回 Luma39 替换。Luma39 这边删 Key 是即时生效的。

Q:可不可以一部分用网站 Key 一部分 BYOK? A:目前不可以——一次只能选一种模式。这个混合模式在路线图上,但优先级不高。