# 快速开始

> 三步完成接入：创建 API Key → 提交视频任务 → 轮询获取成片

本页带你用最短路径跑通 LoopRouter 的 Seedance 2.0 视频生成。

## 第一步：创建 API Key

<Steps>
  <Step title="注册账号">
    打开 [console.looprouter.com](https://console.looprouter.com) 完成注册与登录。
  </Step>
  <Step title="创建令牌">
    进入「令牌」页面，新建一个令牌，得到形如 `sk-xxxx` 的 API Key。请妥善保管，不要提交到代码仓库。
  </Step>
  <Step title="确认额度">
    在「钱包」页面确认账户余额充足。视频生成为预扣费模式，余额不足会直接返回错误。
  </Step>
</Steps>

## 第二步：提交视频生成任务

<CodeGroup>

```bash cURL
curl -X POST "https://api.looprouter.com/api/v3/contents/generations/tasks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $LOOPROUTER_API_KEY" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
      {
        "type": "text",
        "text": "海边日落，无人机航拍视角缓缓推进，金色阳光洒在海面上"
      }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5
  }'
```

```python Python
import requests

resp = requests.post(
    "https://api.looprouter.com/api/v3/contents/generations/tasks",
    headers={
        "Authorization": "Bearer sk-你的APIKey",
        "Accept-Encoding": "identity",
    },
    json={
        "model": "doubao-seedance-2-0-260128",
        "content": [
            {"type": "text", "text": "海边日落，无人机航拍视角缓缓推进，金色阳光洒在海面上"}
        ],
        "resolution": "720p",
        "ratio": "16:9",
        "duration": 5,
    },
)
print(resp.json())  # {"id": "cgt-xxxx"}
```

</CodeGroup>

创建接口只返回任务 ID，**不会**直接返回视频：

```json
{"id": "cgt-20260721-xxxx"}
```

## 第三步：轮询任务并下载视频

```bash cURL
curl "https://api.looprouter.com/api/v3/contents/generations/tasks/cgt-20260721-xxxx" \
  -H "Authorization: Bearer $LOOPROUTER_API_KEY"
```

任务状态依次经历 `queued → running → succeeded / failed`。成功后响应中的 `content.video_url` 即为成片下载地址。

<Warning>
`video_url` 是带签名的临时链接，**约 2 小时后过期**，拿到后请尽快转存到自己的存储。下载视频时不要携带 `Authorization` 请求头。
</Warning>

## 下一步

<CardGroup cols={2}>
  <Card title="完整参数说明" icon="book" href="/api-capabilities/seedance2/video-generation">
    首尾帧、多模态参考、音频等全部生成模式与参数
  </Card>
  <Card title="在线调试（试一试）" icon="flask" href="/api-reference/create-video-task">
    在文档内直接填参数发起真实请求
  </Card>
</CardGroup>