API Key 与鉴权

API Key 在哪里创建？

在控制台 → 令牌新建一个令牌，得到形如 sk-xxxx 的 API Key。视频生成与素材库 / 真人认证共用同一把 Key，无需单独申请。请妥善保管，不要提交到代码仓库或泄露给不信任的一方。

请求头该怎么写？

所有接口统一使用 Authorization: Bearer sk-...。JSON 请求再带 Content-Type: application/json。例如：

curl -X POST "https://api.looprouter.com/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

Base URL 是什么？/api 前缀能省略吗？

Base URL 是 https://api.looprouter.com，视频接口完整路径是 /api/v3/contents/generations/tasks。/api 前缀不能省略，漏掉会 404。这是从火山方舟迁移时最常见的一个坑，详见从方舟迁移。

返回 401 Unauthorized 怎么办？

401 表示 API Key 缺失或无效。检查：1）请求头是否为 Authorization: Bearer sk-...（有 Bearer 前缀、Key 完整）；2）Key 是否被禁用或删除；3）有没有把 Key 写错 / 带上多余空格。到控制台确认令牌状态。

返回 403 Forbidden 是什么原因？

403 有两类常见原因：1）令牌无权访问该模型——到控制台确认令牌可用模型范围；2）内容审核未通过——最典型的是把真实人脸图片直接放进了生成请求，需先走真人认证。两者提示信息不同，按 message 区分。

一个令牌多人 / 多进程共用可以吗？

可以。同一把 Key 可在多处并发使用，任务与素材都归属于同一账号。注意限流是按账号维度的（见并发与限流），多人共用会共享这份额度。出于安全建议不同用途分配不同令牌，方便在日志中区分与单独吊销。

怀疑 Key 泄露了怎么办？

立即到控制台 → 令牌禁用 / 删除该令牌并新建一把，然后更新你的服务配置。素材 ID、真人认证的 BytedToken 同样属于敏感凭据，也应一并排查。

快速开始

创建 Key 并跑通第一个任务

计费与余额

额度与扣费规则

从方舟迁移

Base URL 与 Key 替换

模型与调用

令牌与计费

素材与安全

相关文档

快速开始

计费与余额

从方舟迁移

​相关文档

快速开始

计费与余额

从方舟迁移

相关文档