# TiKo API 文档

在线文档：`http://127.0.0.1:8787/docs/`

机器可读 OpenAPI：`http://127.0.0.1:8787/docs/openapi.json`

## 快速调用

```bash
curl -X POST http://127.0.0.1:8787/openapi/v1/videos \
  -H "Authorization: Bearer SUBSITE_API_KEY_EXAMPLE" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order_demo_20261004_001" \
  -d '{
    "model": "seedance-2.5-workflow",
    "prompt": "黄昏街道，电影感光影，镜头缓慢推进",
    "duration": 30,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'
```

返回任务 ID 后轮询：

```bash
curl http://127.0.0.1:8787/openapi/v1/videos/任务ID \
  -H "Authorization: Bearer SUBSITE_API_KEY_EXAMPLE"
```

完成后读取 `video_url`，或下载：

```bash
curl -L -H "Authorization: Bearer SUBSITE_API_KEY_EXAMPLE" \
  http://127.0.0.1:8787/openapi/v1/videos/任务ID/content -o result.mp4
```

完整参数、模型限制、Python 示例和错误处理请打开在线文档。