# 01Router — 网关 API 文档

> 一个 REST API 统一调用 fal.ai、Replicate、WaveSpeedAI、KIE AI、APIMart、EvoLink、AtlasCloud、Vercel AI Gateway、OpenRouter 上的图片、视频、音频与对话模型。

Base URL: https://01router.com/api/v1
Documentation: https://01router.com/zh/docs
Index: https://01router.com/docs/llms.txt?locale=zh
Full reference: https://01router.com/docs/llms-full.txt?locale=zh

生成、任务记录、取消与对话需要密钥；模型目录、提示词和报价公开可读。请将 API Key 保存在服务端。

响应仅用于说明结构；ID、用量、价格和结果以实际请求为准。


## 模型文档

Source: https://01router.com/zh/docs/models/ltx-2.5-fast

# LTX-2.5 Fast API

Lightricks LTX-2.5 Fast: real-time speed with audio, 6–20 s, up to native 4K.

`POST /api/v1/generations`

需要 Bearer API Key

## 输入参数

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [   "ltx-2.5-fast" ] |
| input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 |  |
| provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 |  |
| project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 |  |
| callback_url | string<uri> | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 |  |
| input.prompt | string | yes |  |  |
| input.image_url | string<uri> | no | Optional start image (image-to-video) |  |
| input.end_image_url | string<uri> | no |  |  |
| input.duration | enum | no |  | default: 6; options: [   6,   8,   10,   12,   14,   16,   18,   20 ] |
| input.resolution | enum | no |  | default: "1080p"; options: [   "720p",   "1080p",   "1440p",   "2160p" ] |
| input.aspect_ratio | enum | no |  | default: "16:9"; options: [   "16:9",   "9:16" ] |
| input.generate_audio | boolean | no |  | default: true |

## 输出字段

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| id | string | — | 创建任务返回的生成 ID。 |  |
| object | "generation" | — | generation |  |
| model | string | — | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 |  |
| type | video \| image \| audio \| chat | — |  |  |
| provider | string | — | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 |  |
| status | string | — | queued（排队）/ processing（处理中）/ succeeded（成功）/ failed（失败）。成功或失败后停止轮询。 |  |
| input | object | — | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 |  |
| outputs | string[] | — | 结果文件 URL 列表；结果未就绪时为空。链接可能过期，请及时下载。 |  |
| error | string \| null | — | 失败时的错误信息，否则为 null。 |  |
| credits | number | — | 该任务扣除的积分，退款后为 0。 |  |
| price_usd | number | — | 该任务的美元价格，退款后为 0。 |  |
| created_at | string | — | ISO 8601 格式的创建时间。 |  |
| completed_at | string \| null | — | ISO 8601 格式的完成时间，进行中为 null。 |  |

## cURL

```bash
curl 'https://01router.com/api/v1/generations' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ltx-2.5-fast",
  "input": {
    "prompt": "A cinematic landscape at sunrise.",
    "duration": 6,
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'
```

## 200 · application/json

```json
{
  "id": "gen_example",
  "object": "generation",
  "model": "ltx-2.5-fast",
  "type": "video",
  "provider": "fal",
  "status": "processing",
  "input": {
    "prompt": "A cinematic landscape at sunrise.",
    "duration": 6,
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  },
  "outputs": [],
  "error": null,
  "credits": 100,
  "price_usd": 1,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": null
}
```

## 使用说明

- 轮询间隔至少 3 秒。同步生图接口返回 504 时，任务可能仍在进行，应使用 error.id 查询，避免重复创建。


## 此模型使用的接口

- [POST /api/v1/generations](https://01router.com/docs/llms-full.txt?locale=zh&section=create): 创建生成任务
- [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh&section=poll): 获取结果
- [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh&section=cancel): 取消任务
- [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh&section=quote): 报价
- [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh&section=model-detail): 查询单个模型

调用 /generations 和 /quote 时，将以下参数放入 input；调用 /images/generations 时放在顶层；对话参数放在 /chat/completions 顶层。

选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入，请将示例媒体地址替换为可访问的文件。

### Provider parameter schemas

```json
[
  {
    "provider": "fal",
    "params": [
      {
        "name": "prompt",
        "type": "text",
        "label": "Prompt",
        "required": true
      },
      {
        "name": "image_url",
        "type": "image",
        "label": "First frame",
        "description": "Optional start image (image-to-video)"
      },
      {
        "name": "end_image_url",
        "type": "image",
        "label": "Last frame"
      },
      {
        "name": "duration",
        "type": "enum",
        "label": "Duration (s)",
        "options": [
          6,
          8,
          10,
          12,
          14,
          16,
          18,
          20
        ],
        "default": 6
      },
      {
        "name": "resolution",
        "type": "enum",
        "label": "Resolution",
        "options": [
          "720p",
          "1080p",
          "1440p",
          "2160p"
        ],
        "default": "1080p"
      },
      {
        "name": "aspect_ratio",
        "type": "enum",
        "label": "Aspect ratio",
        "options": [
          "16:9",
          "9:16"
        ],
        "default": "16:9"
      },
      {
        "name": "generate_audio",
        "type": "boolean",
        "label": "Generate audio",
        "default": true
      }
    ]
  },
  {
    "provider": "replicate",
    "params": [
      {
        "name": "prompt",
        "type": "text",
        "label": "Prompt",
        "required": true
      },
      {
        "name": "image_url",
        "type": "image",
        "label": "First frame",
        "description": "Optional start image (image-to-video)"
      },
      {
        "name": "end_image_url",
        "type": "image",
        "label": "Last frame"
      },
      {
        "name": "duration",
        "type": "enum",
        "label": "Duration (s)",
        "options": [
          6,
          8,
          10,
          12,
          14,
          16,
          18,
          20
        ],
        "default": 6
      },
      {
        "name": "resolution",
        "type": "enum",
        "label": "Resolution",
        "options": [
          "720p",
          "1080p",
          "1440p",
          "2160p"
        ],
        "default": "1080p"
      },
      {
        "name": "aspect_ratio",
        "type": "enum",
        "label": "Aspect ratio",
        "options": [
          "16:9",
          "9:16"
        ],
        "default": "16:9"
      },
      {
        "name": "generate_audio",
        "type": "boolean",
        "label": "Generate audio",
        "default": true
      }
    ]
  },
  {
    "provider": "atlascloud",
    "params": [
      {
        "name": "prompt",
        "type": "text",
        "label": "Prompt",
        "required": true
      },
      {
        "name": "image_url",
        "type": "image",
        "label": "First frame",
        "description": "Optional start image (image-to-video)"
      },
      {
        "name": "end_image_url",
        "type": "image",
        "label": "Last frame"
      },
      {
        "name": "duration",
        "type": "enum",
        "label": "Duration (s)",
        "options": [
          6,
          8,
          10,
          12,
          14,
          16,
          18,
          20
        ],
        "default": 6
      },
      {
        "name": "resolution",
        "type": "enum",
        "label": "Resolution",
        "options": [
          "720p"
        ],
        "default": "720p"
      },
      {
        "name": "aspect_ratio",
        "type": "enum",
        "label": "Aspect ratio",
        "options": [
          "16:9",
          "9:16"
        ],
        "default": "16:9"
      },
      {
        "name": "generate_audio",
        "type": "boolean",
        "label": "Generate audio",
        "default": true
      }
    ]
  }
]
```

---