# API Key 与鉴权

> sk- 令牌怎么创建？请求头怎么写？401 / 403 怎么排查？/api 前缀能省略吗？

<AccordionGroup>
  <Accordion title="API Key 在哪里创建？">
    在 [控制台 → 令牌](https://console.looprouter.com/keys) 新建一个令牌，得到形如 `sk-xxxx` 的 API Key。视频生成与素材库 / 真人认证**共用同一把 Key**，无需单独申请。请妥善保管，不要提交到代码仓库或泄露给不信任的一方。
  </Accordion>
  <Accordion title="请求头该怎么写？">
    所有接口统一使用 `Authorization: Bearer sk-...`。JSON 请求再带 `Content-Type: application/json`。例如：

    ```bash
    curl -X POST "https://api.looprouter.com/api/v3/contents/generations/tasks" \
      -H "Authorization: Bearer sk-你的APIKey" \
      -H "Content-Type: application/json" \
      -d '{ ... }'
    ```
  </Accordion>
  <Accordion title="Base URL 是什么？/api 前缀能省略吗？">
    Base URL 是 `https://api.looprouter.com`，视频接口完整路径是 `/api/v3/contents/generations/tasks`。**`/api` 前缀不能省略**，漏掉会 404。这是从火山方舟迁移时最常见的一个坑，详见 [从方舟迁移](/scenarios/migrate-from-ark)。
  </Accordion>
  <Accordion title="返回 401 Unauthorized 怎么办？">
    401 表示 API Key 缺失或无效。检查：1）请求头是否为 `Authorization: Bearer sk-...`（有 `Bearer ` 前缀、Key 完整）；2）Key 是否被禁用或删除；3）有没有把 Key 写错 / 带上多余空格。到控制台确认令牌状态。
  </Accordion>
  <Accordion title="返回 403 Forbidden 是什么原因？">
    403 有两类常见原因：1）**令牌无权访问该模型**——到控制台确认令牌可用模型范围；2）**内容审核未通过**——最典型的是把真实人脸图片直接放进了生成请求，需先走 [真人认证](/asset-management/real-person)。两者提示信息不同，按 `message` 区分。
  </Accordion>
  <Accordion title="一个令牌多人 / 多进程共用可以吗？">
    可以。同一把 Key 可在多处并发使用，任务与素材都归属于同一账号。注意限流是按账号维度的（见 [并发与限流](/faq/concurrency-and-ratelimit)），多人共用会共享这份额度。出于安全建议不同用途分配不同令牌，方便在日志中区分与单独吊销。
  </Accordion>
  <Accordion title="怀疑 Key 泄露了怎么办？">
    立即到 [控制台 → 令牌](https://console.looprouter.com/keys) 禁用 / 删除该令牌并新建一把，然后更新你的服务配置。素材 ID、真人认证的 `BytedToken` 同样属于敏感凭据，也应一并排查。
  </Accordion>
</AccordionGroup>

## 相关文档

<CardGroup cols={3}>
  <Card title="快速开始" icon="rocket" href="/getting-started">
    创建 Key 并跑通第一个任务
  </Card>
  <Card title="计费与余额" icon="receipt" href="/faq/billing-and-balance">
    额度与扣费规则
  </Card>
  <Card title="从方舟迁移" icon="arrows-turn-right" href="/scenarios/migrate-from-ark">
    Base URL 与 Key 替换
  </Card>
</CardGroup>