# 从火山引擎方舟迁移

> 已有火山引擎方舟（Ark）Seedance 代码？只改 Base URL 与 API Key 即可迁移到 LoopRouter

LoopRouter 的 Seedance 2.0 接口与火山引擎方舟（Ark）**同路径、同参数、同响应结构**。如果你已经在用方舟的官方 SDK 或自写代码，迁移基本上只有两处改动：**Base URL** 和 **API Key**。

## 只改两处

<CardGroup cols={2}>
  <Card title="Base URL" icon="link">
    把方舟域名换成 `https://api.looprouter.com`，路径 `/api/v3/contents/generations/tasks` 保持不变（`/api` 前缀不能省略）
  </Card>
  <Card title="API Key" icon="key">
    把方舟的 Key 换成 LoopRouter 的 `sk-` 令牌，请求头仍是 `Authorization: Bearer <key>`
  </Card>
</CardGroup>

## 迁移前后对照

```diff
- BASE = "https://ark.cn-beijing.volces.com"
+ BASE = "https://api.looprouter.com"

- headers = {"Authorization": "Bearer <方舟 API Key>"}
+ headers = {"Authorization": "Bearer sk-你的LoopRouterKey"}

  # 其余请求体、轮询逻辑、响应解析都不用改
  POST {BASE}/api/v3/contents/generations/tasks
  GET  {BASE}/api/v3/contents/generations/tasks/{task_id}
```

模型名直接用 `doubao-seedance-2-0-260128`（与方舟快照版本号一致），**不需要**方舟那种 `ep-` 开头的接入点 ID。

## 需要留意的差异点

<Warning>
接入前对照以下几点，可避开绝大多数排障时间：

1. **分辨率白名单**：可用档位由[分组](/user-groups)决定——VIP 组支持 `480p`、`720p`、`1080p`、`4k` 全档位，补贴组支持 `720p`、`1080p`。传分组外的值会返回 400 且不扣费。
2. **不支持回调**：`callback_url` 会被 400 拒绝，请用轮询查询任务状态。
3. **成功终态是 `succeeded`**（不是 `completed`）；终态匹配 `succeeded / failed / cancelled / expired`。
4. **真人脸不能直传**：真实人脸图片需先走 [真人认证](/asset-management/real-person)，再以 `asset://` 引用。
5. **Python `requests`** 建议加请求头 `Accept-Encoding: identity`，避免个别网络环境 gzip 解码异常。
6. **成片链接约 2 小时过期**，请及时转存；下载时不要带 `Authorization` 头。
</Warning>

## LoopRouter 额外提供的能力

在与方舟兼容的基础上，LoopRouter 还补充了几个原厂之外的便利接口：

| 能力 | 说明 |
| --- | --- |
| 任务列表 | `GET /api/v3/contents/generations/tasks` 分页 / 按状态筛选批量查询 |
| 取消任务 | `DELETE /api/v3/contents/generations/tasks/{id}` 取消排队中的任务 |
| 统一计费与日志 | 控制台「日志中心」逐条核对预扣与结算，被拒绝的请求不扣费 |
| 渠道级智能调度 | 高并发时按 RPM 排队重试，任务不易直接失败 |

## 迁移自测清单

<Steps>
  <Step title="替换 Base URL 与 Key">
    改完后先跑一条最简单的文生视频（`720p` / 5 秒）验证连通。
  </Step>
  <Step title="核对终态判断">
    确认代码里判断的是 `succeeded`，且覆盖了 `failed / cancelled / expired`。
  </Step>
  <Step title="移除回调依赖">
    如果原来用 `callback_url`，改为轮询查询接口。
  </Step>
  <Step title="校验计费">
    在 [控制台日志中心](https://console.looprouter.com) 核对预扣与结算记录是否符合预期。
  </Step>
</Steps>

## 相关文档

<CardGroup cols={3}>
  <Card title="视频生成 API" icon="clapperboard" href="/api-capabilities/seedance2/video-generation">
    参数与响应详解
  </Card>
  <Card title="API Key 与鉴权" icon="key" href="/faq/api-key-and-auth">
    令牌与请求头
  </Card>
  <Card title="快速开始" icon="rocket" href="/getting-started">
    三步跑通第一个视频
  </Card>
</CardGroup>