# 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 # 快速开始 选择模型、发送请求、获取结果。从这里完成第一次 API 调用。 ## cURL ```bash curl 'https://01router.com/api/v1/models?type=video' ``` ## cURL ```bash curl 'https://01router.com/api/v1/generations' \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "seedance-2.5", "input": { "prompt": "A red fox running through fresh snow, cinematic" } }' ``` ## cURL ```bash curl 'https://01router.com/api/v1/generations/gen_example' \ -H "Authorization: Bearer $API_KEY" ``` ## 使用说明 - 生成、任务记录、取消与对话需要密钥；模型目录、提示词和报价公开可读。请将 API Key 保存在服务端。 - 轮询间隔至少 3 秒。同步生图接口返回 504 时，任务可能仍在进行，应使用 error.id 查询，避免重复创建。 - 模型参数来自实时模型目录。 --- Source: https://01router.com/zh/docs/auth # 鉴权 以 Bearer Token 方式发送 API Key，费用从 Key 所属账户的积分中扣除。 ## 鉴权请求头 ```http Authorization: Bearer YOUR_API_KEY Content-Type: application/json ``` ## 使用说明 - 生成、任务记录、取消与对话需要密钥；模型目录、提示词和报价公开可读。请将 API Key 保存在服务端。 --- Source: https://01router.com/zh/docs/projects # 项目机制 项目是接入的基本单位：每个项目有自己的 API Key、模型范围、供应商和价格比例。用项目的 Key 调用接口时，项目配置会自动生效；你的前端还能用项目 ID 拉取带售价的模型目录。 ## 读取项目模型目录 ```bash curl 'https://01router.com/api/v1/models?project=YOUR_PROJECT_ID&type=video' ``` ## 调用自定义模型 ID ```bash curl 'https://01router.com/api/v1/generations' \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "my-video-lite", "input": { "prompt": "A red fox running through fresh snow, cinematic" } }' ``` ## 按项目配置报价 ```bash curl 'https://01router.com/api/v1/quote' \ -H "Content-Type: application/json" \ -d '{ "model": "seedance-2.5", "input": { "prompt": "A red fox running through fresh snow, cinematic" }, "project": "YOUR_PROJECT_ID" }' ``` ## 使用说明 - 在控制台「项目」页创建项目，一个账户最多 20 个项目，每个项目最多 20 个 API Key。新项目默认启用全部模型、价格比例 100%。所有项目共用账户积分余额。 - 开启「全部模型」时，平台目录里的模型都能调用，未单独配置的模型自动走最便宜的供应商；关闭后只能调用单独配置过的模型，其余模型返回 400（Model xxx is not enabled in this project）。 - 单独配置模型时可以固定供应商、设置价格比例和排序（数字越小越靠前）。固定供应商后，该模型的请求只发往这个供应商，请求里的 provider 字段会被忽略。 - 可以为同一个平台模型再上架一个自定义模型 ID（小写字母、数字、. _ -，最长 64 位，不能与平台模型重名），绑定另一个供应商和名称，例如同时提供标准版和低价版。调用时 model 填自定义 ID 即可。 - 价格比例取 1–1000 的整数（100 = 平台原价，120 = 加价 20%），只影响项目模型目录里展示给你的用户的售价。实际扣费始终按平台价从你的账户积分扣除，差价由你在自己的产品中向终端用户收取。 - GET /api/v1/models?project=YOUR_PROJECT_ID 公开可读、无需密钥，返回已启用的模型、参数和按比例换算后的价格（美元），可追加 type 过滤。项目 ID 可以放在前端，API Key 不可以。填写项目域名后，只有该域名及其子域名下的浏览器能跨域读取；不填则允许任意来源。 - 每个 API Key 都属于一个项目，请求会自动使用该项目的配置，请求体里的 project 字段可以省略；如果填写，必须与 Key 所属项目一致，否则返回 403。报价接口 /quote 无需密钥，可传 project 按项目的模型映射和供应商报价（返回平台价）。 - 每个 Key 可设置：额度上限（积分，可选择不重置或按天 / 周 / 月重置，并指定时区），超出返回 429 quota_exceeded；IP 白名单（最多 50 条，支持 IPv4 CIDR），不在名单内的请求按无效 Key 处理；有效期（1 / 7 / 30 / 90 / 180 / 365 天或永久）。删除项目后，其模型目录与 Key 的调用都会失效。 --- Source: https://01router.com/zh/docs/create # 创建生成任务 传入模型 ID、统一输入参数，可选指定供应商 slug。接口立即返回任务 ID；同步类供应商的图片模型可能直接返回成功结果。 `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | ## 输出字段 | 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": "seedance-2.5", "input": { "prompt": "A red fox running through fresh snow, cinematic" } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "seedance-2.5", "type": "video", "provider": "01router", "status": "processing", "input": { "prompt": "A red fox running through fresh snow, cinematic" }, "outputs": [], "error": null, "credits": 100, "price_usd": 1, "created_at": "2026-10-25T08:00:00.000Z", "completed_at": null } ``` ## 使用说明 - 轮询间隔至少 3 秒。同步生图接口返回 504 时，任务可能仍在进行，应使用 error.id 查询，避免重复创建。 --- Source: https://01router.com/zh/docs/poll # 获取结果 每隔几秒轮询，直到 status 为 succeeded 或 failed。输出链接由供应商托管，可能过期，请及时下载保存；也可以传 callback_url 接收推送。 `GET /api/v1/generations/{id}` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | id | string · path | yes | 创建任务返回的生成 ID。 | | ## 输出字段 | 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/gen_example' \ -H "Authorization: Bearer $API_KEY" ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "seedance-2.5", "type": "video", "provider": "01router", "status": "succeeded", "input": { "prompt": "A red fox running through fresh snow, cinematic" }, "outputs": [ "https://example.com/result.mp4" ], "error": null, "credits": 100, "price_usd": 1, "created_at": "2026-10-25T08:00:00.000Z", "completed_at": "2026-10-25T08:01:00.000Z" } ``` ## 使用说明 - 轮询间隔至少 3 秒。同步生图接口返回 504 时，任务可能仍在进行，应使用 error.id 查询，避免重复创建。 --- Source: https://01router.com/zh/docs/list # 任务列表 分页查询你的生成记录（page、pageSize） `GET /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | page | integer | no | 页码，从 1 开始。 | default: 1; min: 1; max: 10000 | | pageSize | integer | no | 每页记录数，范围 1–100，默认 20。 | default: 20; min: 1; max: 100 | ## 输出字段 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | data | array | — | 任务对象数组，字段与任务详情响应一致。 | | | total | integer | — | 匹配记录的总数。 | | | page | integer | — | 页码，从 1 开始。 | | | pageSize | integer | — | 每页记录数，范围 1–100，默认 20。 | | ## cURL ```bash curl 'https://01router.com/api/v1/generations?page=1&pageSize=20' \ -H "Authorization: Bearer $API_KEY" ``` ## 200 · application/json ```json { "object": "list", "data": [ { "id": "gen_example", "object": "generation", "model": "seedance-2.5", "type": "video", "provider": "01router", "status": "processing", "input": { "prompt": "A red fox running through fresh snow, cinematic" }, "outputs": [], "error": null, "credits": 100, "price_usd": 1, "created_at": "2026-10-25T08:00:00.000Z", "completed_at": null } ], "total": 1, "page": 1, "pageSize": 20 } ``` --- Source: https://01router.com/zh/docs/cancel # 取消任务 POST /generations/:id/cancel 会请求供应商停止进行中的任务。供应商确认后，任务以 failed 结束（error 为 "Canceled by user"），积分全额退还。目前支持 fal（仅排队中的任务）和 Replicate；其他供应商或已结束的任务返回 409 not_cancelable。 `POST /api/v1/generations/{id}/cancel` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | id | string · path | yes | 创建任务返回的生成 ID。 | | ## 输出字段 | 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 -X POST 'https://01router.com/api/v1/generations/gen_example/cancel' \ -H "Authorization: Bearer $API_KEY" ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "seedance-2.5", "type": "video", "provider": "01router", "status": "failed", "input": { "prompt": "A red fox running through fresh snow, cinematic" }, "outputs": [], "error": "Canceled by user", "credits": 0, "price_usd": 0, "created_at": "2026-10-25T08:00:00.000Z", "completed_at": "2026-10-25T08:01:00.000Z" } ``` --- Source: https://01router.com/zh/docs/images # OpenAI 兼容生图 POST /images/generations 兼容 OpenAI 图片接口，OpenAI SDK、LobeChat、Cherry Studio、Dify、n8n 都能直接调用这里的图片模型。size 会映射为最接近的 aspect_ratio，n 映射为 num_images，模型的其他参数可作为额外字段传入。最多等待约 110 秒，超时返回 504 和任务 id，可继续轮询。 `POST /api/v1/images/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | | | prompt | string | yes | 描述要生成的图片，必填且不能为空。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | size | string | no | 宽 x 高，例如 1024x1024，或 auto。必要时映射到最接近的受支持宽高比。 | | | n | integer | no | 正整数，默认 1。多图生成需要模型支持 num_images。 | default: 1; min: 1 | | response_format | string | no | url（默认）或 b64_json。Base64 转换失败或超过大小限制时，该条结果回退为 URL。 | default: "url"; options: [ "url", "b64_json" ] | ## 输出字段 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | created | integer | — | Unix 时间戳，单位为秒。 | | | data | array | — | 每项包含 url 或 b64_json，取决于 response_format 及转换是否成功。 | | | id | string | — | 创建任务返回的生成 ID。 | | | model | string | — | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | | | credits | number | — | 该任务扣除的积分，退款后为 0。 | | ## cURL ```bash curl 'https://01router.com/api/v1/images/generations' \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "nano-banana-pro", "prompt": "A minimalist poster of a paper crane", "size": "1024x1024" }' ``` ## 200 · application/json ```json { "created": 1792915200, "data": [ { "url": "https://example.com/result.png" } ], "id": "gen_example", "model": "nano-banana-pro", "credits": 10 } ``` ## 使用说明 - 轮询间隔至少 3 秒。同步生图接口返回 504 时，任务可能仍在进行，应使用 error.id 查询，避免重复创建。 - 调用 /generations 和 /quote 时，将以下参数放入 input；调用 /images/generations 时放在顶层；对话参数放在 /chat/completions 顶层。 --- Source: https://01router.com/zh/docs/chat # 对话补全 对话模型（GPT、Claude、Gemini、Grok、DeepSeek 等）使用 OpenAI Chat Completions 格式，官方 OpenAI SDK 将 base URL 设为 https://01router.com/api/v1 即可调用。传 "stream": true 获得 SSE 流式输出。调用前按输入 + max_tokens（未传时为 4096）预扣积分，回复结束后按实际 token 用量结算；请求 ID 会出现在 X-Gateway-Request-Id 响应头和任务日志中。 `POST /api/v1/chat/completions` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | | | messages | object[] | yes | 非空消息数组，每项包含 role 和 content；content 可包含模型支持的多模态内容。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | stream | boolean | no | 默认 false；true 返回 text/event-stream 数据流，以 data: [DONE] 结束。 | default: false | | max_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | default: 4096; min: 1 | | max_completion_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | | | temperature | number | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | tools | object[] | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | response_format | object | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | ## 输出字段 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | id | string | — | 创建任务返回的生成 ID。 | | | object | string | — | chat.completion / chat.completion.chunk | | | model | string | — | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | | | choices | array | — | 回答列表。非流式使用 choices[].message，流式数据块使用 choices[].delta。 | | | usage | object | — | 包含 prompt_tokens、completion_tokens、total_tokens。流式响应在供应商提供时包含用量。 | | ## cURL ```bash curl 'https://01router.com/api/v1/chat/completions' \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-6-sol", "messages": [ { "role": "user", "content": "Hello!" } ], "max_tokens": 512, "stream": false }' ``` ## 200 · application/json ```json { "id": "chat_example", "object": "chat.completion", "model": "gpt-6-sol", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "Hello!" }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 8, "completion_tokens": 2, "total_tokens": 10 } } ``` ## SSE · stream: true ```text data: {"id":"chat_example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"Hello!"},"finish_reason":null}]} data: [DONE] ``` ## 使用说明 - OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 --- Source: https://01router.com/zh/docs/quote # 报价 请求体与创建任务相同。返回按价格排序的可用供应商，以及无法处理该请求的供应商及原因。 `POST /api/v1/quote` 公开接口 · 无需 API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | ## 输出字段 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | — | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | | | input | object | — | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | providers | array | — | 按价格排序的可用供应商，包含 unit、quantity、price_usd、original_price_usd 和 credits。 | | | unavailable | array | — | 无法处理此请求的供应商及原因。 | | ## cURL ```bash curl 'https://01router.com/api/v1/quote' \ -H "Content-Type: application/json" \ -d '{ "model": "seedance-2.5", "input": { "prompt": "A red fox running through fresh snow, cinematic" } }' ``` ## 200 · application/json ```json { "model": "seedance-2.5", "type": "video", "input": { "prompt": "A red fox running through fresh snow, cinematic" }, "providers": [ { "provider": "01router", "provider_name": "01Router", "unit": "second", "quantity": 5, "price_usd": 1, "original_price_usd": null, "credits": 100 } ], "unavailable": [] } ``` --- Source: https://01router.com/zh/docs/models # 模型列表 通过 GET /api/v1/models 获取平台模型、参数与价格；传入 project 查询参数获取指定项目模型，可用 type=video|image|audio|chat 筛选。 `GET /api/v1/models` 公开接口 · 无需 API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | type | string | no | video / image / audio / chat | options: [ "video", "image", "audio", "chat" ] | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | ## 输出字段 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | data | array | — | 模型对象包含 slug、name、type、vendor、params 和 providers。供应商条目包含其实际参数和价格档位。 | | ## cURL ```bash curl 'https://01router.com/api/v1/models' ``` ## cURL ```bash curl 'https://01router.com/api/v1/models?type=video' ``` ## 200 · application/json ```json { "object": "list", "data": [ { "id": "seedance-2.5", "object": "model", "owned_by": "ByteDance", "slug": "seedance-2.5", "name": "Seedance 2.5", "type": "video", "vendor": "ByteDance", "description": "", "tags": [], "coverUrl": "", "params": [ { "name": "prompt", "type": "text", "required": true } ], "providers": [], "fromMicros": null, "fromOriginalMicros": null, "fromUnit": null } ] } ``` --- Source: https://01router.com/zh/docs/model-detail # 查询单个模型 模型对象包含 slug、name、type、vendor、params 和 providers。供应商条目包含其实际参数和价格档位。 `GET /api/v1/models/{slug}` 公开接口 · 无需 API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | slug | string · path | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | | ## 输出字段 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | slug | string | — | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | | | params | array | — | 参数定义：name、type、required、default、options，以及已配置的 min、max、maxItems、maxLength。 | | | providers | array | — | 可用供应商、各自的参数约束及公开价格档位。 | | ## cURL ```bash curl 'https://01router.com/api/v1/models/seedance-2.5' ``` ## 200 · application/json ```json { "slug": "seedance-2.5", "name": "Seedance 2.5", "type": "video", "vendor": "ByteDance", "description": "", "tags": [], "coverUrl": "", "params": [ { "name": "prompt", "type": "text", "required": true } ], "providers": [], "fromMicros": null, "fromOriginalMicros": null, "fromUnit": null } ``` --- Source: https://01router.com/zh/docs/project-models # 项目模型目录 使用 GET /api/v1/models?project={id} 读取指定项目的公开模型目录，包含选定供应商与转售价格。不传 project 时返回平台模型；可追加 &type=video 等类型筛选参数。 `GET /api/v1/models` 公开接口 · 无需 API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | project | string · query | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | type | string | no | video / image / audio / chat | options: [ "video", "image", "audio", "chat" ] | ## 输出字段 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | project | object | — | id, name | | | data | array | — | 项目模型对象包含 slug、name、type、vendor、description、tags、coverUrl、provider、providerName、params、prices、fromMicros 和 fromUnit。价格包含项目加价；每项为单个 provider，不含 providers 数组。 | | ## cURL ```bash curl 'https://01router.com/api/v1/models?project=YOUR_PROJECT_ID' ``` ## cURL ```bash curl 'https://01router.com/api/v1/models?project=YOUR_PROJECT_ID&type=video' ``` ## 200 · application/json ```json { "object": "list", "project": { "id": "YOUR_PROJECT_ID", "name": "Example project" }, "data": [] } ``` --- Source: https://01router.com/zh/docs/prompts # 提示词 API 公开只读接口，无需 API Key，不扣除积分。复用提示词库中已启用模型的已发布示例，支持按模型、来源和场景组合筛选。 `GET /api/v1/prompts` 公开接口 · 无需 API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | no | 可选。模型 slug，例如 seedance-2.5；不传则查询所有模型。返回的 categories 提供可选模型及各模型的收录量。 | | | source | string | no | 可选。来源域名，例如 evolink.ai；seed 表示种子示例，unknown 表示未标注来源。使用 sources 返回的 name，不是模型供应商路由参数。 | | | scene | string | no | 可选。场景分类的完整名称，例如 Cinematic Story；使用 scenes 返回的 name，并对查询值进行 URL 编码。 | | | locale | string | no | 可选，en 或 zh，默认 en。返回对应语言及语言通用的记录；详情接口也接受此参数。 | default: "en"; options: [ "en", "zh" ] | | page | integer | no | 可选。1–100000 的整数，默认 1，每页固定 24 条。超过总页数时返回最后一页；空结果的 total_pages 为 1。 | default: 1; min: 1; max: 100000 | ## 输出字段 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | data | array | — | 公开提示词对象：id、title、prompt、category、source、mediaType、mediaUrl、modelSlug 和 modelName。 | | | total | integer | — | 匹配记录的总数。 | | | page / page_size / total_pages | integer | — | 可选。1–100000 的整数，默认 1，每页固定 24 条。超过总页数时返回最后一页；空结果的 total_pages 为 1。 | | | categories / sources / scenes | array | — | 可用模型分类、来源和场景及数量，统计范围见下方说明。 | | ## cURL ```bash curl 'https://01router.com/api/v1/prompts?model=seedance-2.5&locale=en&page=1' ``` ## 200 · application/json ```json { "object": "list", "data": [ { "id": "prompt_example", "title": "Cinematic landscape", "prompt": "A cinematic landscape at sunrise.", "category": "Cinematic Story", "source": "evolink.ai", "mediaType": "video", "mediaUrl": "https://example.com/video.mp4", "modelSlug": "seedance-2.5", "modelName": "Seedance 2.5" } ], "total": 1, "page": 1, "page_size": 24, "total_pages": 1, "categories": [ { "slug": "seedance-2.5", "name": "Seedance 2.5", "type": "video", "total": 1 } ], "sources": [ { "name": "evolink.ai", "total": 1 } ], "scenes": [ { "name": "Cinematic Story", "total": 1 } ] } ``` ## 使用说明 - 下方为返回结构示意，数量和内容以实际响应为准。data 为提示词数组；categories 为当前语言下所有模型分类；sources 的数量按当前模型统计，scenes 的数量按当前模型和来源统计；total 是应用全部筛选后的数量。category 表示场景分类，modelSlug 表示模型分类。 - 使用返回的 modelSlug 和 prompt 构造下方请求体，调用 POST /generations；生成接口仍需 API Key，并按模型计费。其他生成参数请通过 GET /models/{slug} 查询后补充。 - 参数无效返回 400；模型分类或提示词不存在、停用或在所选语言下不可见时返回 404；有效分类下无匹配结果返回 200 和空 data。接口按 IP 限流，同一路径请求间隔至少 200 毫秒，触发时返回 429 和 Retry-After；成功响应允许缓存 60 秒。 --- Source: https://01router.com/zh/docs/prompt-detail # 提示词详情 将列表中的 id 替换 。详情直接返回提示词对象，包含 object: "prompt" 及 data 单条记录中的同名字段，不再包裹 data。只返回当前语言下可公开访问的记录。 `GET /api/v1/prompts/{id}` 公开接口 · 无需 API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | id | string · path | yes | 将列表中的 id 替换 。详情直接返回提示词对象，包含 object: "prompt" 及 data 单条记录中的同名字段，不再包裹 data。只返回当前语言下可公开访问的记录。 | | | locale | string | no | 可选，en 或 zh，默认 en。返回对应语言及语言通用的记录；详情接口也接受此参数。 | default: "en"; options: [ "en", "zh" ] | ## 输出字段 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | object | "prompt" | — | prompt | | | prompt | string | — | 公开提示词对象：id、title、prompt、category、source、mediaType、mediaUrl、modelSlug 和 modelName。 | | | modelSlug | string | — | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | | ## cURL ```bash curl 'https://01router.com/api/v1/prompts/prompt_example?locale=en' ``` ## 200 · application/json ```json { "object": "prompt", "id": "prompt_example", "title": "Cinematic landscape", "prompt": "A cinematic landscape at sunrise.", "category": "Cinematic Story", "source": "evolink.ai", "mediaType": "video", "mediaUrl": "https://example.com/video.mp4", "modelSlug": "seedance-2.5", "modelName": "Seedance 2.5" } ``` ## 使用说明 - 参数无效返回 400；模型分类或提示词不存在、停用或在所选语言下不可见时返回 404；有效分类下无匹配结果返回 200 和空 data。接口按 IP 限流，同一路径请求间隔至少 200 毫秒，触发时返回 429 和 Retry-After；成功响应允许缓存 60 秒。 --- Source: https://01router.com/zh/docs/callback # 任务回调 传入 callback_url（公网 https 地址），任务成功或失败后我们会把最终的 generation 对象 POST 过去，失败按退避重试最多 5 次，无需轮询。 ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | ## 输出字段 | 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": "seedance-2.5", "input": { "prompt": "A red fox running through fresh snow, cinematic" }, "callback_url": "https://your-app.com/webhooks/generation" }' ``` ## Node.js · HMAC-SHA256 ```javascript import { createHmac, timingSafeEqual } from 'node:crypto'; // rawBody is the original request body, before JSON parsing. const timestamp = request.headers.get('x-gateway-timestamp') ?? ''; const signature = request.headers.get('x-gateway-signature') ?? ''; const expected = 'sha256=' + createHmac('sha256', process.env.API_KEY) .update(timestamp + '.' + rawBody).digest('hex'); const received = Buffer.from(signature); const signed = Buffer.from(expected); const fresh = /^\d+$/.test(timestamp) && Math.abs(Date.now() / 1000 - Number(timestamp)) <= 300; const valid = fresh && received.length === signed.length && timingSafeEqual(received, signed); if (!valid) throw new Error('Invalid callback signature'); ``` ## 使用说明 - 每次回调都带 X-Gateway-Timestamp 和 X-Gateway-Signature：sha256=HMAC-SHA256(你的 API Key, timestamp + "." + 原始请求体)。可以校验签名，也可以直接再调一次 GET /generations/:id 确认。 - 按任务 ID 幂等处理回调，使用原始请求体校验签名并拒绝过期时间戳。使用登录会话创建的任务可能没有签名，API 集成应使用密钥创建任务。 --- Source: https://01router.com/zh/docs/routing # 供应商路由 未指定 provider 时，我们会用每个供应商支持的取值校验参数并报价，提交给最便宜的供应商；提交失败会退款并尝试下一个（最多 3 家）。指定 provider 时只会发往该供应商。 ## 使用说明 - 自动熔断：某个供应商在同一模型上连续 5 次提交失败，会在 5 分钟内被排到最后，请求优先走健康的供应商；它仍作为最后的兜底，成功一次即恢复。 - 选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入，请将示例媒体地址替换为可访问的文件。 --- Source: https://01router.com/zh/docs/billing # 计费 任务提交时按所选供应商对应参数的价格扣除积分（视频按秒、图片按张或按次）。失败或超时的任务会自动退还积分。 ## 使用说明 - 对话模型（GPT、Claude、Gemini、Grok、DeepSeek 等）使用 OpenAI Chat Completions 格式，官方 OpenAI SDK 将 base URL 设为 https://01router.com/api/v1 即可调用。传 "stream": true 获得 SSE 流式输出。调用前按输入 + max_tokens（未传时为 4096）预扣积分，回复结束后按实际 token 用量结算；请求 ID 会出现在 X-Gateway-Request-Id 响应头和任务日志中。 - 请求体与创建任务相同。返回按价格排序的可用供应商，以及无法处理该请求的供应商及原因。 --- Source: https://01router.com/zh/docs/audio # 音频模型 音乐（Suno）和语音合成（Gemini TTS）模型与图片、视频一样走 /generations：先创建任务再轮询，输出为音频文件 URL。 ## cURL ```bash curl 'https://01router.com/api/v1/generations' \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gemini-3.8-flash-tts", "input": { "prompt": "Welcome back, let us get started.", "voice": "Kore" } }' ``` ## 使用说明 - 轮询间隔至少 3 秒。同步生图接口返回 504 时，任务可能仍在进行，应使用 error.id 查询，避免重复创建。 --- Source: https://01router.com/zh/docs/errors # 错误码 请同时检查 HTTP 状态和 error.message。部分限流响应使用 message 包装并附带 Retry-After。相同 HTTP 状态的错误码可能随接口不同。 ## 输出字段 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | 400 · invalid_request | HTTP | — | 请求体或参数取值不合法 | | | 401 · unauthorized | HTTP | — | 缺少或无效的 API Key | | | 402 · insufficient_credits | HTTP | — | 积分不足 | | | 403 · invalid_request | HTTP | — | 密钥或项目不允许调用该模型、供应商或请求来源。 | | | 404 · not_found | HTTP | — | 模型或任务不存在 | | | 409 · not_cancelable | HTTP | — | 任务无法取消（已结束，或该供应商不支持取消） | | | 429 · rate_limited / concurrency_limit | HTTP | — | 请求过于频繁，请稍后重试 · 该 API Key 进行中的任务过多，等部分任务完成后再提交 | | | 502 · upstream_error | HTTP | — | 所有供应商都拒绝了任务（积分已退回） | | | 503 · no_provider / upstream_error | HTTP | — | 没有供应商支持这些参数 | | | 504 · timeout | HTTP | — | 等待超时但图片仍在生成，请轮询 GET /generations/:id | | ## 401 · application/json ```json { "error": { "message": "Invalid or missing API key", "code": "unauthorized" } } ``` ## 使用说明 - 轮询间隔至少 3 秒。同步生图接口返回 504 时，任务可能仍在进行，应使用 error.id 查询，避免重复创建。 --- ## 模型文档 Source: https://01router.com/zh/docs/models/grok-imagine-video-1.5 # Grok Imagine Video 1.5 API Grok Imagine Video 1.5: 1–15 second videos with synchronized audio, at 480p, 720p or 1080p. Image-to-video follows the source image aspect ratio. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "grok-imagine-video-1.5" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | maxLength: 4096 | | input.image_url | string | no | Optional start image (image-to-video) | | | input.duration | integer | no | | default: 6; min: 1; max: 15 | | input.resolution | enum | no | | default: "720p"; options: [ "480p", "720p", "1080p" ] | | input.aspect_ratio | enum | no | Text-to-video only; image-to-video follows the source image. | default: "16:9"; options: [ "16:9", "4:3", "3:2", "1:1", "2:3", "3:4", "9:16" ] | ## 输出字段 | 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": "grok-imagine-video-1.5", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9" } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "grok-imagine-video-1.5", "type": "video", "provider": "01router", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9" }, "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§ion=create): 创建生成任务 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=model-detail): 查询单个模型 调用 /generations 和 /quote 时，将以下参数放入 input；调用 /images/generations 时放在顶层；对话参数放在 /chat/completions 顶层。 选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入，请将示例媒体地址替换为可访问的文件。 ### Provider parameter schemas ```json [ { "provider": "01router", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true, "maxLength": 4096 }, { "name": "image_url", "type": "image", "label": "First frame", "description": "Optional start image (image-to-video)" }, { "name": "duration", "type": "integer", "label": "Duration (s)", "min": 1, "max": 15, "default": 6 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "4:3", "3:2", "1:1", "2:3", "3:4", "9:16" ], "default": "16:9", "description": "Text-to-video only; image-to-video follows the source image." } ] }, { "provider": "fal", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true, "maxLength": 4096 }, { "name": "image_url", "type": "image", "label": "First frame", "description": "Optional start image (image-to-video)" }, { "name": "duration", "type": "integer", "label": "Duration (s)", "min": 1, "max": 15, "default": 6 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "4:3", "3:2", "1:1", "2:3", "3:4", "9:16" ], "default": "16:9", "description": "Text-to-video only; image-to-video follows the source image." } ] }, { "provider": "replicate", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true, "maxLength": 4096 }, { "name": "image_url", "type": "image", "label": "First frame", "description": "Optional start image (image-to-video)" }, { "name": "duration", "type": "integer", "label": "Duration (s)", "min": 1, "max": 15, "default": 6 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "4:3", "3:2", "1:1", "2:3", "3:4", "9:16" ], "default": "16:9", "description": "Text-to-video only; image-to-video follows the source image." } ] }, { "provider": "wavespeed", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true, "maxLength": 4096 }, { "name": "image_url", "type": "image", "label": "First frame", "description": "Optional start image (image-to-video)" }, { "name": "duration", "type": "integer", "label": "Duration (s)", "min": 1, "max": 15, "default": 6 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "3:2", "2:3" ], "default": "16:9", "description": "Text-to-video only; image-to-video follows the source image." } ] }, { "provider": "kie", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true, "maxLength": 4096 }, { "name": "image_url", "type": "image", "label": "First frame", "description": "Optional start image (image-to-video)" }, { "name": "duration", "type": "integer", "label": "Duration (s)", "min": 1, "max": 15, "default": 6 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "3:2", "2:3" ], "default": "16:9", "description": "Text-to-video only; image-to-video follows the source image." } ] }, { "provider": "apimart", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true, "maxLength": 4096 }, { "name": "image_url", "type": "image", "label": "First frame", "description": "Optional start image (image-to-video)" }, { "name": "duration", "type": "integer", "label": "Duration (s)", "min": 1, "max": 15, "default": 6 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "4:3", "3:2", "1:1", "2:3", "3:4", "9:16" ], "default": "16:9", "description": "Text-to-video only; image-to-video follows the source image." } ] }, { "provider": "evolink", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true, "maxLength": 4096 }, { "name": "image_url", "type": "image", "label": "First frame", "description": "Optional start image (image-to-video)" }, { "name": "duration", "type": "integer", "label": "Duration (s)", "min": 1, "max": 15, "default": 6 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "3:2", "2:3" ], "default": "16:9", "description": "Text-to-video only; image-to-video follows the source image." } ] }, { "provider": "atlascloud", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true, "maxLength": 4096 }, { "name": "duration", "type": "integer", "label": "Duration (s)", "min": 1, "max": 15, "default": 6 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p" ], "default": "480p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "4:3", "3:2", "1:1", "2:3", "3:4", "9:16" ], "default": "16:9", "description": "Text-to-video only; image-to-video follows the source image." } ] }, { "provider": "vercel", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true, "maxLength": 4096 }, { "name": "image_url", "type": "image", "label": "First frame", "description": "Optional start image (image-to-video)" }, { "name": "duration", "type": "integer", "label": "Duration (s)", "min": 1, "max": 15, "default": 6 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "4:3", "3:2", "1:1", "2:3", "3:4", "9:16" ], "default": "16:9", "description": "Text-to-video only; image-to-video follows the source image." } ] }, { "provider": "openrouter", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true, "maxLength": 4096 }, { "name": "image_url", "type": "image", "label": "First frame", "description": "Optional start image (image-to-video)" }, { "name": "duration", "type": "integer", "label": "Duration (s)", "min": 1, "max": 15, "default": 6 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "4:3", "3:2", "1:1", "2:3", "3:4", "9:16" ], "default": "16:9", "description": "Text-to-video only; image-to-video follows the source image." } ] } ] ``` --- Source: https://01router.com/zh/docs/models/seedance-2.5 # Seedance 2.5 API ByteDance’s flagship video model: up to 30 s in one pass, native synchronized audio, first/last-frame control. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "seedance-2.5" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.image_url | string | no | Optional start image (image-to-video) | | | input.end_image_url | string | no | | | | input.duration | integer | no | | default: 5; min: 4; max: 30 | | input.resolution | enum | no | | default: "720p"; options: [ "480p", "720p", "1080p" ] | | input.aspect_ratio | enum | no | | default: "16:9"; options: [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] | | 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": "seedance-2.5", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 5, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "seedance-2.5", "type": "video", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 5, "resolution": "720p", "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§ion=create): 创建生成任务 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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": "integer", "label": "Duration (s)", "min": 4, "max": 30, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true } ] }, { "provider": "01router", "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": "integer", "label": "Duration (s)", "min": 4, "max": 30, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "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": "integer", "label": "Duration (s)", "min": 4, "max": 30, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p" ], "default": "480p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true } ] }, { "provider": "wavespeed", "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": "integer", "label": "Duration (s)", "min": 4, "max": 30, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true } ] }, { "provider": "kie", "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": "integer", "label": "Duration (s)", "min": 4, "max": 30, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true } ] }, { "provider": "apimart", "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": "integer", "label": "Duration (s)", "min": 4, "max": 30, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true } ] }, { "provider": "evolink", "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": "duration", "type": "integer", "label": "Duration (s)", "min": 4, "max": 30, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "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": "integer", "label": "Duration (s)", "min": 4, "max": 30, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p" ], "default": "480p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true } ] }, { "provider": "vercel", "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": "duration", "type": "integer", "label": "Duration (s)", "min": 4, "max": 30, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true } ] } ] ``` --- Source: https://01router.com/zh/docs/models/grok-imagine-video-1.5-lite # Grok Imagine Video 1.5 Lite API Grok Imagine Video 1.5 Lite: 1–15 second videos with synchronized audio, at 480p, 720p or 1080p. Image-to-video follows the source image aspect ratio. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "grok-imagine-video-1.5-lite" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | maxLength: 4096 | | input.image_url | string | no | Optional start image (image-to-video) | | | input.duration | integer | no | | default: 6; min: 1; max: 15 | | input.resolution | enum | no | | default: "720p"; options: [ "480p", "720p", "1080p" ] | | input.aspect_ratio | enum | no | Text-to-video only; image-to-video follows the source image. | default: "16:9"; options: [ "16:9", "4:3", "3:2", "1:1", "2:3", "3:4", "9:16" ] | ## 输出字段 | 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": "grok-imagine-video-1.5-lite", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9" } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "grok-imagine-video-1.5-lite", "type": "video", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9" }, "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§ion=create): 创建生成任务 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=model-detail): 查询单个模型 调用 /generations 和 /quote 时，将以下参数放入 input；调用 /images/generations 时放在顶层；对话参数放在 /chat/completions 顶层。 选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入，请将示例媒体地址替换为可访问的文件。 ### Provider parameter schemas ```json [ { "provider": "fal", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true, "maxLength": 4096 }, { "name": "image_url", "type": "image", "label": "First frame", "description": "Optional start image (image-to-video)" }, { "name": "duration", "type": "integer", "label": "Duration (s)", "min": 1, "max": 15, "default": 6 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "4:3", "3:2", "1:1", "2:3", "3:4", "9:16" ], "default": "16:9", "description": "Text-to-video only; image-to-video follows the source image." } ] }, { "provider": "01router", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true, "maxLength": 4096 }, { "name": "image_url", "type": "image", "label": "First frame", "description": "Optional start image (image-to-video)" }, { "name": "duration", "type": "integer", "label": "Duration (s)", "min": 1, "max": 15, "default": 6 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "4:3", "3:2", "1:1", "2:3", "3:4", "9:16" ], "default": "16:9", "description": "Text-to-video only; image-to-video follows the source image." } ] }, { "provider": "evolink", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true, "maxLength": 4096 }, { "name": "image_url", "type": "image", "label": "First frame", "description": "Optional start image (image-to-video)" }, { "name": "duration", "type": "integer", "label": "Duration (s)", "min": 1, "max": 15, "default": 6 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "4:3", "3:2", "1:1", "2:3", "3:4", "9:16" ], "default": "16:9", "description": "Text-to-video only; image-to-video follows the source image." } ] }, { "provider": "atlascloud", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true, "maxLength": 4096 }, { "name": "duration", "type": "integer", "label": "Duration (s)", "min": 1, "max": 15, "default": 6 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p" ], "default": "480p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "4:3", "3:2", "1:1", "2:3", "3:4", "9:16" ], "default": "16:9", "description": "Text-to-video only; image-to-video follows the source image." } ] }, { "provider": "vercel", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true, "maxLength": 4096 }, { "name": "image_url", "type": "image", "label": "First frame", "description": "Optional start image (image-to-video)" }, { "name": "duration", "type": "integer", "label": "Duration (s)", "min": 1, "max": 15, "default": 6 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "4:3", "3:2", "1:1", "2:3", "3:4", "9:16" ], "default": "16:9", "description": "Text-to-video only; image-to-video follows the source image." } ] }, { "provider": "openrouter", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true, "maxLength": 4096 }, { "name": "image_url", "type": "image", "label": "First frame", "description": "Optional start image (image-to-video)" }, { "name": "duration", "type": "integer", "label": "Duration (s)", "min": 1, "max": 15, "default": 6 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "4:3", "3:2", "1:1", "2:3", "3:4", "9:16" ], "default": "16:9", "description": "Text-to-video only; image-to-video follows the source image." } ] } ] ``` --- Source: https://01router.com/zh/docs/models/minimax-h3-max # MiniMax H3 Max API MiniMax H3 post-trained by fal for speed: 5–15 s clips with first/last frame, ranked #1 on video arenas. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "minimax-h3-max" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.image_url | string | no | Optional start image (image-to-video) | | | input.end_image_url | string | no | | | | input.duration | integer | no | | default: 5; min: 5; max: 15 | | input.resolution | enum | no | | default: "768p"; options: [ "480p", "768p", "1080p" ] | | input.aspect_ratio | enum | no | | default: "16:9"; options: [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] | ## 输出字段 | 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": "minimax-h3-max", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 5, "resolution": "768p", "aspect_ratio": "16:9" } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "minimax-h3-max", "type": "video", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 5, "resolution": "768p", "aspect_ratio": "16:9" }, "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§ion=create): 创建生成任务 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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": "integer", "label": "Duration (s)", "min": 5, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "768p", "1080p" ], "default": "768p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" } ] }, { "provider": "01router", "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": "integer", "label": "Duration (s)", "min": 5, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "768p", "1080p" ], "default": "768p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" } ] }, { "provider": "apimart", "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": "integer", "label": "Duration (s)", "min": 5, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "768p", "1080p" ], "default": "768p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" } ] }, { "provider": "evolink", "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": "integer", "label": "Duration (s)", "min": 5, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "768p", "480p" ], "default": "768p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" } ] }, { "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": "integer", "label": "Duration (s)", "min": 5, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p" ], "default": "480p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" } ] }, { "provider": "vercel", "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": "duration", "type": "integer", "label": "Duration (s)", "min": 5, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "768p", "480p" ], "default": "768p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" } ] } ] ``` --- Source: https://01router.com/zh/docs/models/seedance-2.0 # Seedance 2.0 API Multi-shot Seedance generation with synchronized audio and first/last-frame control, 4–15 s. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "seedance-2.0" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.image_url | string | no | Optional start image (image-to-video) | | | input.end_image_url | string | no | | | | input.duration | integer | no | | default: 5; min: 4; max: 15 | | input.resolution | enum | no | | default: "720p"; options: [ "480p", "720p", "1080p" ] | | input.aspect_ratio | enum | no | | default: "16:9"; options: [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] | | 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": "seedance-2.0", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 5, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "seedance-2.0", "type": "video", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 5, "resolution": "720p", "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§ion=create): 创建生成任务 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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": "integer", "label": "Duration (s)", "min": 4, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "480p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true } ] }, { "provider": "01router", "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": "integer", "label": "Duration (s)", "min": 4, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "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": "integer", "label": "Duration (s)", "min": 4, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true } ] }, { "provider": "wavespeed", "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": "integer", "label": "Duration (s)", "min": 4, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true } ] }, { "provider": "kie", "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": "integer", "label": "Duration (s)", "min": 4, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "480p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true } ] }, { "provider": "apimart", "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": "integer", "label": "Duration (s)", "min": 4, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true } ] }, { "provider": "evolink", "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": "duration", "type": "integer", "label": "Duration (s)", "min": 4, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "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": "integer", "label": "Duration (s)", "min": 4, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p" ], "default": "480p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true } ] }, { "provider": "vercel", "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": "duration", "type": "integer", "label": "Duration (s)", "min": 4, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true } ] } ] ``` --- Source: https://01router.com/zh/docs/models/seedance-2.0-mini # Seedance 2.0 Mini API Faster, lower-cost Seedance 2.0 for drafts and high-volume generation (480p/720p). `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "seedance-2.0-mini" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.image_url | string | no | Optional start image (image-to-video) | | | input.end_image_url | string | no | | | | input.duration | integer | no | | default: 5; min: 4; max: 15 | | input.resolution | enum | no | | default: "720p"; options: [ "480p", "720p" ] | | input.aspect_ratio | enum | no | | default: "16:9"; options: [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] | | 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": "seedance-2.0-mini", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 5, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "seedance-2.0-mini", "type": "video", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 5, "resolution": "720p", "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§ion=create): 创建生成任务 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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": "integer", "label": "Duration (s)", "min": 4, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true } ] }, { "provider": "01router", "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": "integer", "label": "Duration (s)", "min": 4, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "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": "integer", "label": "Duration (s)", "min": 4, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true } ] }, { "provider": "wavespeed", "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": "integer", "label": "Duration (s)", "min": 4, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true } ] }, { "provider": "kie", "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": "integer", "label": "Duration (s)", "min": 4, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true } ] }, { "provider": "apimart", "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": "integer", "label": "Duration (s)", "min": 4, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true } ] }, { "provider": "evolink", "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": "duration", "type": "integer", "label": "Duration (s)", "min": 4, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "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": "integer", "label": "Duration (s)", "min": 4, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p" ], "default": "480p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true } ] }, { "provider": "vercel", "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": "duration", "type": "integer", "label": "Duration (s)", "min": 4, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true } ] } ] ``` --- Source: https://01router.com/zh/docs/models/minimax-h3 # MiniMax H3 API MiniMax Hailuo H3 with native 768p and 2K output, 4–15 s, first/last frame. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "minimax-h3" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.image_url | string | no | Optional start image (image-to-video) | | | input.end_image_url | string | no | | | | input.duration | integer | no | | default: 5; min: 5; max: 15 | | input.resolution | enum | no | | default: "768p"; options: [ "768p", "2k" ] | | input.aspect_ratio | enum | no | | default: "16:9"; options: [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] | ## 输出字段 | 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": "minimax-h3", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 5, "resolution": "768p", "aspect_ratio": "16:9" } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "minimax-h3", "type": "video", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 5, "resolution": "768p", "aspect_ratio": "16:9" }, "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§ion=create): 创建生成任务 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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": "integer", "label": "Duration (s)", "min": 5, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "768p", "2k" ], "default": "768p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" } ] }, { "provider": "01router", "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": "integer", "label": "Duration (s)", "min": 5, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "768p", "2k" ], "default": "768p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" } ] }, { "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": "integer", "label": "Duration (s)", "min": 5, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "768p", "2k" ], "default": "768p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" } ] }, { "provider": "wavespeed", "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": "integer", "label": "Duration (s)", "min": 5, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "768p", "2k" ], "default": "768p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" } ] }, { "provider": "kie", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "duration", "type": "integer", "label": "Duration (s)", "min": 5, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "768p", "2k" ], "default": "768p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" } ] }, { "provider": "apimart", "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": "integer", "label": "Duration (s)", "min": 5, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "768p", "2k" ], "default": "768p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" } ] }, { "provider": "vercel", "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": "duration", "type": "integer", "label": "Duration (s)", "min": 5, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "768p", "2k" ], "default": "768p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" } ] } ] ``` --- Source: https://01router.com/zh/docs/models/wan-3.0 # Wan 3.0 API Alibaba Tongyi Wanxiang 3.0: 2–30 s video with audio, first/last frame, 480p–1080p. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "wan-3.0" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.image_url | string | no | Optional start image (image-to-video) | | | input.end_image_url | string | no | | | | input.duration | integer | no | | default: 5; min: 2; max: 30 | | input.resolution | enum | no | | default: "720p"; options: [ "480p", "720p", "1080p" ] | | input.aspect_ratio | enum | no | | default: "16:9"; options: [ "16:9", "9:16", "1:1", "4:3", "3:4" ] | | input.generate_audio | boolean | no | | default: true | | input.seed | integer | no | | min: 0; max: 2147483647 | ## 输出字段 | 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": "wan-3.0", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 5, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "wan-3.0", "type": "video", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 5, "resolution": "720p", "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§ion=create): 创建生成任务 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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": "integer", "label": "Duration (s)", "min": 2, "max": 30, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "01router", "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": "integer", "label": "Duration (s)", "min": 2, "max": 30, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "wavespeed", "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": "integer", "label": "Duration (s)", "min": 2, "max": 30, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "kie", "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": "integer", "label": "Duration (s)", "min": 2, "max": 30, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "apimart", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "duration", "type": "integer", "label": "Duration (s)", "min": 2, "max": 30, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "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": "integer", "label": "Duration (s)", "min": 2, "max": 30, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p" ], "default": "480p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "vercel", "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": "duration", "type": "integer", "label": "Duration (s)", "min": 2, "max": 30, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] } ] ``` --- Source: https://01router.com/zh/docs/models/kling-3.0-turbo # Kling 3.0 Turbo API Kling 3.0 Turbo: fast high-motion video with native audio; 720p (standard) or 1080p (pro), 3–15 s. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "kling-3.0-turbo" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.image_url | string | no | Optional start image (image-to-video) | | | input.duration | integer | no | | default: 5; min: 3; max: 15 | | input.resolution | enum | no | | default: "720p"; options: [ "720p", "1080p" ] | | input.aspect_ratio | enum | no | | default: "16:9"; options: [ "16:9", "9:16", "1:1" ] | ## 输出字段 | 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": "kling-3.0-turbo", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 5, "resolution": "720p", "aspect_ratio": "16:9" } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "kling-3.0-turbo", "type": "video", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 5, "resolution": "720p", "aspect_ratio": "16:9" }, "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§ion=create): 创建生成任务 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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": "duration", "type": "integer", "label": "Duration (s)", "min": 3, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1" ], "default": "16:9" } ] }, { "provider": "01router", "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": "duration", "type": "integer", "label": "Duration (s)", "min": 3, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1" ], "default": "16:9" } ] }, { "provider": "wavespeed", "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": "duration", "type": "integer", "label": "Duration (s)", "min": 3, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1" ], "default": "16:9" } ] }, { "provider": "kie", "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": "duration", "type": "integer", "label": "Duration (s)", "min": 3, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1" ], "default": "16:9" } ] }, { "provider": "apimart", "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": "duration", "type": "integer", "label": "Duration (s)", "min": 3, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1" ], "default": "16:9" } ] }, { "provider": "evolink", "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": "duration", "type": "integer", "label": "Duration (s)", "min": 3, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1" ], "default": "16:9" } ] }, { "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": "duration", "type": "integer", "label": "Duration (s)", "min": 3, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1" ], "default": "16:9" } ] } ] ``` --- Source: https://01router.com/zh/docs/models/gemini-omni-flash-1.1 # Gemini Omni Flash 1.1 API Google’s omni-modal Flash video model with native sound, 3–10 s, 360p up to 4K. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "gemini-omni-flash-1.1" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.image_url | string | no | Optional start image (image-to-video) | | | input.end_image_url | string | no | | | | input.duration | integer | no | | default: 8; min: 3; max: 10 | | input.resolution | enum | no | | default: "720p"; options: [ "360p", "720p", "1080p", "4k" ] | | input.aspect_ratio | enum | no | | default: "16:9"; options: [ "16:9", "9:16" ] | ## 输出字段 | 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": "gemini-omni-flash-1.1", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 8, "resolution": "720p", "aspect_ratio": "16:9" } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "gemini-omni-flash-1.1", "type": "video", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 8, "resolution": "720p", "aspect_ratio": "16:9" }, "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§ion=create): 创建生成任务 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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": "integer", "label": "Duration (s)", "min": 3, "max": 10, "default": 8 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "360p", "720p", "1080p", "4k" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16" ], "default": "16:9" } ] }, { "provider": "wavespeed", "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": "integer", "label": "Duration (s)", "min": 3, "max": 10, "default": 8 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "360p", "720p", "1080p", "4k" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16" ], "default": "16:9" } ] }, { "provider": "kie", "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": "integer", "label": "Duration (s)", "min": 3, "max": 10, "default": 8, "options": [ 4, 6, 8, 10 ] }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "360p", "720p", "1080p", "4k" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16" ], "default": "16:9" } ] }, { "provider": "apimart", "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": "integer", "label": "Duration (s)", "min": 3, "max": 10, "default": 8 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "360p", "720p", "1080p", "4k" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16" ], "default": "16:9" } ] }, { "provider": "evolink", "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": "duration", "type": "integer", "label": "Duration (s)", "min": 3, "max": 10, "default": 8 }, { "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" } ] } ] ``` --- Source: https://01router.com/zh/docs/models/happyhorse-1.1 # HappyHorse 1.1 API Alibaba HappyHorse 1.1: strong character consistency and natural motion, 3–15 s. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "happyhorse-1.1" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.image_url | string | no | Optional start image (image-to-video) | | | input.duration | integer | no | | default: 5; min: 3; max: 15 | | input.resolution | enum | no | | default: "720p"; options: [ "480p", "720p", "1080p" ] | | input.aspect_ratio | enum | no | | default: "16:9"; options: [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] | | input.seed | integer | no | | min: 0; max: 2147483647 | ## 输出字段 | 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": "happyhorse-1.1", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 5, "resolution": "720p", "aspect_ratio": "16:9" } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "happyhorse-1.1", "type": "video", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 5, "resolution": "720p", "aspect_ratio": "16:9" }, "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§ion=create): 创建生成任务 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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": "duration", "type": "integer", "label": "Duration (s)", "min": 3, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "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": "duration", "type": "integer", "label": "Duration (s)", "min": 3, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "wavespeed", "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": "duration", "type": "integer", "label": "Duration (s)", "min": 3, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p", "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "kie", "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": "duration", "type": "integer", "label": "Duration (s)", "min": 3, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "apimart", "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": "duration", "type": "integer", "label": "Duration (s)", "min": 3, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "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": "duration", "type": "integer", "label": "Duration (s)", "min": 3, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "480p" ], "default": "480p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] } ] ``` --- Source: https://01router.com/zh/docs/models/flux-3-video # FLUX 3 Video API Black Forest Labs’ FLUX 3 video model: 5–20 s with audio, FLUX-level visual quality. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "flux-3-video" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.image_url | string | no | Optional start image (image-to-video) | | | input.duration | integer | no | | default: 5; min: 5; max: 20 | | input.resolution | enum | no | | default: "720p"; options: [ "720p", "1080p" ] | | input.aspect_ratio | enum | no | | default: "16:9"; options: [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] | | 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": "flux-3-video", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 5, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "flux-3-video", "type": "video", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 5, "resolution": "720p", "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§ion=create): 创建生成任务 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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": "duration", "type": "integer", "label": "Duration (s)", "min": 5, "max": 20, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "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": "duration", "type": "integer", "label": "Duration (s)", "min": 5, "max": 20, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true } ] }, { "provider": "wavespeed", "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": "duration", "type": "integer", "label": "Duration (s)", "min": 5, "max": 20, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "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": "duration", "type": "integer", "label": "Duration (s)", "min": 5, "max": 20, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ], "default": "16:9" }, { "name": "generate_audio", "type": "boolean", "label": "Generate audio", "default": true } ] } ] ``` --- 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 | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.image_url | string | no | Optional start image (image-to-video) | | | input.end_image_url | string | 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§ion=create): 创建生成任务 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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 } ] } ] ``` --- Source: https://01router.com/zh/docs/models/wan-2.7 # Wan 2.7 API Wan 2.7: reliable Tongyi Wanxiang video with first/last-frame control, 2–15 s, 720p/1080p. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "wan-2.7" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.negative_prompt | string | no | | | | input.image_url | string | no | Optional start image (image-to-video) | | | input.end_image_url | string | no | | | | input.duration | integer | no | | default: 5; min: 2; max: 15 | | input.resolution | enum | no | | default: "720p"; options: [ "720p", "1080p" ] | | input.aspect_ratio | enum | no | | default: "16:9"; options: [ "16:9", "9:16", "1:1", "4:3", "3:4" ] | | input.seed | integer | no | | min: 0; max: 2147483647 | ## 输出字段 | 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": "wan-2.7", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 5, "resolution": "720p", "aspect_ratio": "16:9" } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "wan-2.7", "type": "video", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 5, "resolution": "720p", "aspect_ratio": "16:9" }, "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§ion=create): 创建生成任务 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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": "negative_prompt", "type": "string", "label": "Negative prompt" }, { "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": "integer", "label": "Duration (s)", "min": 2, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4" ], "default": "16:9" }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "replicate", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "negative_prompt", "type": "string", "label": "Negative prompt" }, { "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": "integer", "label": "Duration (s)", "min": 2, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4" ], "default": "16:9" }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "wavespeed", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "negative_prompt", "type": "string", "label": "Negative prompt" }, { "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": "integer", "label": "Duration (s)", "min": 2, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4" ], "default": "16:9" }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "apimart", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "negative_prompt", "type": "string", "label": "Negative prompt" }, { "name": "duration", "type": "integer", "label": "Duration (s)", "min": 2, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4" ], "default": "16:9" }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "evolink", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "negative_prompt", "type": "string", "label": "Negative prompt" }, { "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": "integer", "label": "Duration (s)", "min": 2, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4" ], "default": "16:9" }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "atlascloud", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "negative_prompt", "type": "string", "label": "Negative prompt" }, { "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": "integer", "label": "Duration (s)", "min": 2, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4" ], "default": "16:9" }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "vercel", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "negative_prompt", "type": "string", "label": "Negative prompt" }, { "name": "duration", "type": "integer", "label": "Duration (s)", "min": 2, "max": 15, "default": 5 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "1080p" ], "default": "720p" }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "16:9", "9:16", "1:1", "4:3", "3:4" ], "default": "16:9" }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] } ] ``` --- Source: https://01router.com/zh/docs/models/veo-3.1 # Veo 3.1 API Google DeepMind Veo 3.1: cinematic 4–8 s video with native dialogue and sound effects. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "veo-3.1" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.negative_prompt | string | no | | | | input.image_url | string | no | Optional start image (image-to-video) | | | input.end_image_url | string | no | | | | input.duration | enum | no | | default: 8; options: [ 4, 6, 8 ] | | input.resolution | enum | no | | default: "720p"; options: [ "720p", "1080p", "4k" ] | | input.aspect_ratio | enum | no | | default: "16:9"; options: [ "16:9", "9:16" ] | | input.generate_audio | boolean | no | | default: true | | input.seed | integer | no | | min: 0; max: 2147483647 | ## 输出字段 | 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": "veo-3.1", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 8, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "veo-3.1", "type": "video", "provider": "01router", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "duration": 8, "resolution": "720p", "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§ion=create): 创建生成任务 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=model-detail): 查询单个模型 调用 /generations 和 /quote 时，将以下参数放入 input；调用 /images/generations 时放在顶层；对话参数放在 /chat/completions 顶层。 选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入，请将示例媒体地址替换为可访问的文件。 ### Provider parameter schemas ```json [ { "provider": "01router", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "negative_prompt", "type": "string", "label": "Negative prompt" }, { "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": [ 4, 6, 8 ], "default": 8 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "1080p", "4k" ], "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 }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "replicate", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "negative_prompt", "type": "string", "label": "Negative prompt" }, { "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": [ 4, 6, 8 ], "default": 8 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "1080p" ], "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 }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "wavespeed", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "negative_prompt", "type": "string", "label": "Negative prompt" }, { "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": [ 4, 6, 8 ], "default": 8 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "1080p", "4k" ], "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 }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "kie", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "negative_prompt", "type": "string", "label": "Negative prompt" }, { "name": "image_url", "type": "image", "label": "First frame", "description": "Optional start image (image-to-video)" }, { "name": "duration", "type": "enum", "label": "Duration (s)", "options": [ 4, 6, 8 ], "default": 8 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "1080p", "4k" ], "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, "options": [ true ] }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "atlascloud", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "negative_prompt", "type": "string", "label": "Negative prompt" }, { "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": [ 4, 6, 8 ], "default": 8 }, { "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": false, "options": [ false ] }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "vercel", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "negative_prompt", "type": "string", "label": "Negative prompt" }, { "name": "image_url", "type": "image", "label": "First frame", "description": "Optional start image (image-to-video)" }, { "name": "duration", "type": "enum", "label": "Duration (s)", "options": [ 4, 6, 8 ], "default": 8 }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "720p", "1080p" ], "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 }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] } ] ``` --- Source: https://01router.com/zh/docs/models/gpt-image-2.5-flare # GPT Image 2.5 Flare API OpenAI GPT Image 2.5 Flare: fast everyday generation and editing with precise text rendering. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "gpt-image-2.5-flare" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.image_urls | string[] | no | Optional — switches to image editing | maxItems: 10 | | input.aspect_ratio | enum | no | | default: "1:1"; options: [ "1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3" ] | | input.quality | enum | no | | default: "medium"; options: [ "low", "medium", "high", "xhigh", "max" ] | | input.num_images | integer | no | | default: 1; min: 1; max: 4 | ## 输出字段 | 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": "gpt-image-2.5-flare", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "quality": "medium", "num_images": 1 } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "gpt-image-2.5-flare", "type": "image", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "quality": "medium", "num_images": 1 }, "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§ion=create): 创建生成任务 - [POST /api/v1/images/generations](https://01router.com/docs/llms-full.txt?locale=zh§ion=images): OpenAI 兼容生图 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 10 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3" ], "default": "1:1" }, { "name": "quality", "type": "enum", "label": "Quality", "options": [ "low", "medium", "high", "xhigh", "max" ], "default": "medium" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 } ] }, { "provider": "01router", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 10 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3" ], "default": "1:1" }, { "name": "quality", "type": "enum", "label": "Quality", "options": [ "low", "medium", "high", "xhigh", "max" ], "default": "medium" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 } ] }, { "provider": "replicate", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 10 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3" ], "default": "1:1" }, { "name": "quality", "type": "enum", "label": "Quality", "options": [ "low", "medium", "high", "xhigh", "max" ], "default": "medium" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 } ] }, { "provider": "wavespeed", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 10 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3" ], "default": "1:1" }, { "name": "quality", "type": "enum", "label": "Quality", "options": [ "low", "medium", "high", "xhigh", "max" ], "default": "medium" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "kie", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 10 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3" ], "default": "1:1" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "vercel", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 10 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3" ], "default": "1:1" }, { "name": "quality", "type": "enum", "label": "Quality", "options": [ "low", "medium", "high", "xhigh", "max" ], "default": "medium" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 } ] } ] ``` --- Source: https://01router.com/zh/docs/models/gpt-image-2.5-sunburst # GPT Image 2.5 Sunburst API OpenAI GPT Image 2.5 Sunburst: tighter control for demanding edits and premium creative. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "gpt-image-2.5-sunburst" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.image_urls | string[] | no | Optional — switches to image editing | maxItems: 10 | | input.aspect_ratio | enum | no | | default: "1:1"; options: [ "1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3" ] | | input.quality | enum | no | | default: "medium"; options: [ "low", "medium", "high", "xhigh", "max" ] | | input.num_images | integer | no | | default: 1; min: 1; max: 4 | ## 输出字段 | 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": "gpt-image-2.5-sunburst", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "quality": "medium", "num_images": 1 } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "gpt-image-2.5-sunburst", "type": "image", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "quality": "medium", "num_images": 1 }, "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§ion=create): 创建生成任务 - [POST /api/v1/images/generations](https://01router.com/docs/llms-full.txt?locale=zh§ion=images): OpenAI 兼容生图 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 10 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3" ], "default": "1:1" }, { "name": "quality", "type": "enum", "label": "Quality", "options": [ "low", "medium", "high", "xhigh", "max" ], "default": "medium" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 } ] }, { "provider": "01router", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 10 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3" ], "default": "1:1" }, { "name": "quality", "type": "enum", "label": "Quality", "options": [ "low", "medium", "high", "xhigh", "max" ], "default": "medium" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 } ] }, { "provider": "replicate", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 10 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3" ], "default": "1:1" }, { "name": "quality", "type": "enum", "label": "Quality", "options": [ "low", "medium", "high", "xhigh", "max" ], "default": "medium" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 } ] }, { "provider": "wavespeed", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 10 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3" ], "default": "1:1" }, { "name": "quality", "type": "enum", "label": "Quality", "options": [ "low", "medium", "high", "xhigh", "max" ], "default": "medium" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "kie", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 10 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3" ], "default": "1:1" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "vercel", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 10 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3" ], "default": "1:1" }, { "name": "quality", "type": "enum", "label": "Quality", "options": [ "low", "medium", "high", "xhigh", "max" ], "default": "medium" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 } ] } ] ``` --- Source: https://01router.com/zh/docs/models/nano-banana-2.1 # Nano Banana 2.1 API Google Gemini image model: consistent multi-reference editing, 1K–4K output. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "nano-banana-2.1" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.image_urls | string[] | no | Optional — switches to image editing | maxItems: 14 | | input.aspect_ratio | enum | no | | default: "1:1"; options: [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ] | | input.resolution | enum | no | | default: "1K"; options: [ "1K", "2K", "4K" ] | | input.num_images | integer | no | | default: 1; min: 1; max: 4 | ## 输出字段 | 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": "nano-banana-2.1", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "resolution": "1K", "num_images": 1 } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "nano-banana-2.1", "type": "image", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "resolution": "1K", "num_images": 1 }, "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§ion=create): 创建生成任务 - [POST /api/v1/images/generations](https://01router.com/docs/llms-full.txt?locale=zh§ion=images): OpenAI 兼容生图 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 14 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K", "4K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 } ] }, { "provider": "01router", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 14 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K", "4K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 } ] }, { "provider": "replicate", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 14 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K", "4K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "wavespeed", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 14 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K", "4K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "kie", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 14 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K", "4K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "evolink", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 14 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K", "4K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "atlascloud", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 14 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "openrouter", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 14 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K", "4K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] } ] ``` --- Source: https://01router.com/zh/docs/models/seedream-5.0-pro # Seedream 5.0 Pro API ByteDance Seedream 5.0 Pro: photoreal images, multilingual text and up to 10-reference editing. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "seedream-5.0-pro" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.image_urls | string[] | no | Optional — switches to image editing | maxItems: 10 | | input.aspect_ratio | enum | no | | default: "1:1"; options: [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "21:9" ] | | input.resolution | enum | no | | default: "1K"; options: [ "1K", "2K" ] | | input.num_images | integer | no | | default: 1; min: 1; max: 4 | ## 输出字段 | 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": "seedream-5.0-pro", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "resolution": "1K", "num_images": 1 } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "seedream-5.0-pro", "type": "image", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "resolution": "1K", "num_images": 1 }, "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§ion=create): 创建生成任务 - [POST /api/v1/images/generations](https://01router.com/docs/llms-full.txt?locale=zh§ion=images): OpenAI 兼容生图 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 10 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 } ] }, { "provider": "replicate", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 10 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "wavespeed", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 10 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "kie", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 10 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "apimart", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 10 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 } ] }, { "provider": "evolink", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 10 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] } ] ``` --- Source: https://01router.com/zh/docs/models/nano-banana-2 # Nano Banana 2 API Gemini 3.1 Flash Image: fast generation and editing with strong text rendering, 1K–4K. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "nano-banana-2" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.image_urls | string[] | no | Optional — switches to image editing | maxItems: 14 | | input.aspect_ratio | enum | no | | default: "1:1"; options: [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ] | | input.resolution | enum | no | | default: "1K"; options: [ "1K", "2K", "4K" ] | | input.num_images | integer | no | | default: 1; min: 1; max: 4 | ## 输出字段 | 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": "nano-banana-2", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "resolution": "1K", "num_images": 1 } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "nano-banana-2", "type": "image", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "resolution": "1K", "num_images": 1 }, "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§ion=create): 创建生成任务 - [POST /api/v1/images/generations](https://01router.com/docs/llms-full.txt?locale=zh§ion=images): OpenAI 兼容生图 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 14 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K", "4K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 } ] }, { "provider": "replicate", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 14 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K", "4K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "wavespeed", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 14 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K", "4K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "kie", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 14 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K", "4K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "evolink", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 14 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K", "4K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "atlascloud", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "openrouter", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 14 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K", "4K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] } ] ``` --- Source: https://01router.com/zh/docs/models/seedream-5.0-flash # Seedream 5.0 Flash API Low-latency Seedream 5.0: same price for 1K–2K, up to 10 reference images. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "seedream-5.0-flash" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.image_urls | string[] | no | Optional — switches to image editing | maxItems: 10 | | input.aspect_ratio | enum | no | | default: "1:1"; options: [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "21:9" ] | | input.resolution | enum | no | | default: "1K"; options: [ "1K", "2K" ] | | input.num_images | integer | no | | default: 1; min: 1; max: 4 | ## 输出字段 | 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": "seedream-5.0-flash", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "resolution": "1K", "num_images": 1 } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "seedream-5.0-flash", "type": "image", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "resolution": "1K", "num_images": 1 }, "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§ion=create): 创建生成任务 - [POST /api/v1/images/generations](https://01router.com/docs/llms-full.txt?locale=zh§ion=images): OpenAI 兼容生图 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 10 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 } ] }, { "provider": "wavespeed", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 10 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "kie", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 10 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "apimart", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 10 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 } ] }, { "provider": "evolink", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 10 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] } ] ``` --- Source: https://01router.com/zh/docs/models/qwen-image-3.0 # Qwen Image 3.0 API Qwen Image 3.0: excellent Chinese/English text rendering, posters and precise editing. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "qwen-image-3.0" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.negative_prompt | string | no | | | | input.image_urls | string[] | no | Optional — switches to image editing | maxItems: 3 | | input.aspect_ratio | enum | no | | default: "1:1"; options: [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "21:9" ] | | input.resolution | enum | no | | default: "1K"; options: [ "1K", "2K" ] | | input.num_images | integer | no | | default: 1; min: 1; max: 4 | | input.seed | integer | no | | min: 0; max: 2147483647 | ## 输出字段 | 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": "qwen-image-3.0", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "resolution": "1K", "num_images": 1 } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "qwen-image-3.0", "type": "image", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "resolution": "1K", "num_images": 1 }, "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§ion=create): 创建生成任务 - [POST /api/v1/images/generations](https://01router.com/docs/llms-full.txt?locale=zh§ion=images): OpenAI 兼容生图 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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": "negative_prompt", "type": "string", "label": "Negative prompt" }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 3 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "wavespeed", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "negative_prompt", "type": "string", "label": "Negative prompt" }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 3 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "apimart", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "negative_prompt", "type": "string", "label": "Negative prompt" }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 3 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "atlascloud", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "negative_prompt", "type": "string", "label": "Negative prompt" }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 3 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] } ] ``` --- Source: https://01router.com/zh/docs/models/grok-imagine-image-2.0 # Grok Imagine Image 2.0 API xAI Grok Imagine Image 2.0: bold, detailed images with low/medium quality tiers at 1K or 2K. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "grok-imagine-image-2.0" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.image_urls | string[] | no | Optional — switches to image editing | maxItems: 4 | | input.aspect_ratio | enum | no | | default: "1:1"; options: [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ] | | input.resolution | enum | no | | default: "1K"; options: [ "1K", "2K" ] | | input.quality | enum | no | | default: "medium"; options: [ "low", "medium" ] | | input.num_images | integer | no | | default: 1; min: 1; max: 4 | ## 输出字段 | 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": "grok-imagine-image-2.0", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "resolution": "1K", "quality": "medium", "num_images": 1 } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "grok-imagine-image-2.0", "type": "image", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "resolution": "1K", "quality": "medium", "num_images": 1 }, "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§ion=create): 创建生成任务 - [POST /api/v1/images/generations](https://01router.com/docs/llms-full.txt?locale=zh§ion=images): OpenAI 兼容生图 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 4 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K" ], "default": "1K" }, { "name": "quality", "type": "enum", "label": "Quality", "options": [ "low", "medium" ], "default": "medium" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 } ] }, { "provider": "01router", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 4 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K" ], "default": "1K" }, { "name": "quality", "type": "enum", "label": "Quality", "options": [ "low", "medium" ], "default": "medium" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 } ] }, { "provider": "replicate", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 1 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K" ], "default": "1K" }, { "name": "quality", "type": "enum", "label": "Quality", "options": [ "low", "medium" ], "default": "medium" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "wavespeed", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 1 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K" ], "default": "1K" }, { "name": "quality", "type": "enum", "label": "Quality", "options": [ "low", "medium" ], "default": "medium" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "kie", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 4 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "apimart", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 1 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K" ], "default": "1K" }, { "name": "quality", "type": "enum", "label": "Quality", "options": [ "low", "medium" ], "default": "medium" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "evolink", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 4 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K" ], "default": "1K" }, { "name": "quality", "type": "enum", "label": "Quality", "options": [ "low", "medium" ], "default": "medium" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 } ] }, { "provider": "atlascloud", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 4 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K" ], "default": "1K" }, { "name": "quality", "type": "enum", "label": "Quality", "options": [ "low" ], "default": "low" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 } ] }, { "provider": "vercel", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 1 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K" ], "default": "1K" }, { "name": "quality", "type": "enum", "label": "Quality", "options": [ "low", "medium" ], "default": "medium" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "openrouter", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 1 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K" ], "default": "1K" }, { "name": "quality", "type": "enum", "label": "Quality", "options": [ "low", "medium" ], "default": "medium" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] } ] ``` --- Source: https://01router.com/zh/docs/models/nano-banana-pro # Nano Banana Pro API Gemini 3 Pro Image: studio-quality output with reasoning, up to 4K. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "nano-banana-pro" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.image_urls | string[] | no | Optional — switches to image editing | maxItems: 14 | | input.aspect_ratio | enum | no | | default: "1:1"; options: [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ] | | input.resolution | enum | no | | default: "1K"; options: [ "1K", "2K", "4K" ] | | input.num_images | integer | no | | default: 1; min: 1; max: 4 | ## 输出字段 | 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": "nano-banana-pro", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "resolution": "1K", "num_images": 1 } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "nano-banana-pro", "type": "image", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "resolution": "1K", "num_images": 1 }, "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§ion=create): 创建生成任务 - [POST /api/v1/images/generations](https://01router.com/docs/llms-full.txt?locale=zh§ion=images): OpenAI 兼容生图 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 14 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K", "4K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 } ] }, { "provider": "replicate", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 14 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K", "4K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "wavespeed", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 14 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K", "4K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "kie", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 14 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K", "4K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "evolink", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 14 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K", "4K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "atlascloud", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 14 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] }, { "provider": "openrouter", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 14 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K", "4K" ], "default": "1K" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] } ] } ] ``` --- Source: https://01router.com/zh/docs/models/flux-2-pro # FLUX.2 Pro API FLUX.2 [pro]: production photorealism and up to 8-reference editing, billed per megapixel. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "flux-2-pro" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.image_urls | string[] | no | Optional — switches to image editing | maxItems: 8 | | input.aspect_ratio | enum | no | | default: "1:1"; options: [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ] | | input.resolution | enum | no | | default: "1K"; options: [ "1K", "2K" ] | | input.seed | integer | no | | min: 0; max: 2147483647 | ## 输出字段 | 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": "flux-2-pro", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "resolution": "1K" } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "flux-2-pro", "type": "image", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "resolution": "1K" }, "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§ion=create): 创建生成任务 - [POST /api/v1/images/generations](https://01router.com/docs/llms-full.txt?locale=zh§ion=images): OpenAI 兼容生图 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 8 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K" ], "default": "1K" }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "replicate", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 8 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K" ], "default": "1K" }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "wavespeed", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 8 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K" ], "default": "1K" }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "kie", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 8 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K", "2K" ], "default": "1K" }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "atlascloud", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "image_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 8 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ], "default": "1:1" }, { "name": "resolution", "type": "enum", "label": "Resolution", "options": [ "1K" ], "default": "1K" }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] } ] ``` --- Source: https://01router.com/zh/docs/models/ideogram-4.5 # Ideogram 4.5 API Ideogram 4.5: best-in-class typography for posters, logos and graphic design. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "ideogram-4.5" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.image_urls | string[] | no | Optional — switches to image editing | maxItems: 1 | | input.aspect_ratio | enum | no | | default: "1:1"; options: [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ] | | input.quality | enum | no | | default: "medium"; options: [ "low", "medium", "high" ] | | input.num_images | integer | no | | default: 1; min: 1; max: 4 | | input.seed | integer | no | | min: 0; max: 2147483647 | ## 输出字段 | 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": "ideogram-4.5", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "quality": "medium", "num_images": 1 } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "ideogram-4.5", "type": "image", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "quality": "medium", "num_images": 1 }, "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§ion=create): 创建生成任务 - [POST /api/v1/images/generations](https://01router.com/docs/llms-full.txt?locale=zh§ion=images): OpenAI 兼容生图 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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_urls", "type": "images", "label": "Reference images", "description": "Optional — switches to image editing", "maxItems": 1 }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ], "default": "1:1" }, { "name": "quality", "type": "enum", "label": "Quality", "options": [ "low", "medium", "high" ], "default": "medium" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] } ] ``` --- Source: https://01router.com/zh/docs/models/recraft-v4 # Recraft V4 API Recraft V4: brand-consistent illustrations, icons and design assets. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "recraft-v4" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.aspect_ratio | enum | no | | default: "1:1"; options: [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ] | ## 输出字段 | 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": "recraft-v4", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1" } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "recraft-v4", "type": "image", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1" }, "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§ion=create): 创建生成任务 - [POST /api/v1/images/generations](https://01router.com/docs/llms-full.txt?locale=zh§ion=images): OpenAI 兼容生图 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ], "default": "1:1" } ] }, { "provider": "replicate", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ], "default": "1:1" } ] }, { "provider": "wavespeed", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ], "default": "1:1" } ] }, { "provider": "vercel", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" ], "default": "1:1" } ] } ] ``` --- Source: https://01router.com/zh/docs/models/z-image-turbo # Z-Image Turbo API Tongyi Z-Image Turbo: sub-second, very low-cost photoreal images with bilingual text. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "z-image-turbo" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.aspect_ratio | enum | no | | default: "1:1"; options: [ "1:1", "16:9", "9:16", "4:3", "3:4" ] | | input.num_images | integer | no | | default: 1; min: 1; max: 4 | | input.seed | integer | no | | min: 0; max: 2147483647 | ## 输出字段 | 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": "z-image-turbo", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "num_images": 1 } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "z-image-turbo", "type": "image", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "aspect_ratio": "1:1", "num_images": 1 }, "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§ion=create): 创建生成任务 - [POST /api/v1/images/generations](https://01router.com/docs/llms-full.txt?locale=zh§ion=images): OpenAI 兼容生图 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=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": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4" ], "default": "1:1" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "01router", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4" ], "default": "1:1" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1 }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "wavespeed", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4" ], "default": "1:1" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "kie", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4" ], "default": "1:1" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "apimart", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4" ], "default": "1:1" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "evolink", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1" ], "default": "1:1" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] }, { "provider": "atlascloud", "params": [ { "name": "prompt", "type": "text", "label": "Prompt", "required": true }, { "name": "aspect_ratio", "type": "enum", "label": "Aspect ratio", "options": [ "1:1", "16:9", "9:16", "4:3", "3:4" ], "default": "1:1" }, { "name": "num_images", "type": "integer", "label": "Images", "min": 1, "max": 4, "default": 1, "options": [ 1 ] }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 2147483647 } ] } ] ``` --- Source: https://01router.com/zh/docs/models/gpt-6-astra # GPT-6 Astra API OpenAI GPT-6 Astra: the most capable GPT-6 tier for hard reasoning, coding and agents. 1.05M context. `POST /api/v1/chat/completions` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "gpt-6-astra" ] | | messages | object[] | yes | 非空消息数组，每项包含 role 和 content；content 可包含模型支持的多模态内容。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | stream | boolean | no | 默认 false；true 返回 text/event-stream 数据流，以 data: [DONE] 结束。 | default: false | | max_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | default: 4096; min: 1 | | max_completion_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | | | temperature | number | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | tools | object[] | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | response_format | object | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | ## 输出字段 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | id | string | — | 创建任务返回的生成 ID。 | | | object | string | — | chat.completion / chat.completion.chunk | | | model | string | — | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | | | choices | array | — | 回答列表。非流式使用 choices[].message，流式数据块使用 choices[].delta。 | | | usage | object | — | 包含 prompt_tokens、completion_tokens、total_tokens。流式响应在供应商提供时包含用量。 | | ## cURL ```bash curl 'https://01router.com/api/v1/chat/completions' \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-6-astra", "messages": [ { "role": "user", "content": "Hello!" } ], "max_tokens": 512, "stream": false }' ``` ## 200 · application/json ```json { "id": "chat_example", "object": "chat.completion", "model": "gpt-6-astra", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "Hello!" }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 8, "completion_tokens": 2, "total_tokens": 10 } } ``` ## SSE · stream: true ```text data: {"id":"chat_example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"Hello!"},"finish_reason":null}]} data: [DONE] ``` ## 使用说明 - OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 ## 此模型使用的接口 - [POST /api/v1/chat/completions](https://01router.com/docs/llms-full.txt?locale=zh§ion=chat): 对话补全 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=model-detail): 查询单个模型 调用 /generations 和 /quote 时，将以下参数放入 input；调用 /images/generations 时放在顶层；对话参数放在 /chat/completions 顶层。 选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入，请将示例媒体地址替换为可访问的文件。 ### Provider parameter schemas ```json [ { "provider": "wavespeed", "params": [] }, { "provider": "kie", "params": [] }, { "provider": "apimart", "params": [] }, { "provider": "evolink", "params": [] }, { "provider": "atlascloud", "params": [] }, { "provider": "vercel", "params": [] }, { "provider": "openrouter", "params": [] } ] ``` --- Source: https://01router.com/zh/docs/models/gpt-6-sol # GPT-6 Sol API OpenAI GPT-6 Sol: balanced GPT-6 tier for everyday reasoning, coding and tool use. 1.05M context. `POST /api/v1/chat/completions` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "gpt-6-sol" ] | | messages | object[] | yes | 非空消息数组，每项包含 role 和 content；content 可包含模型支持的多模态内容。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | stream | boolean | no | 默认 false；true 返回 text/event-stream 数据流，以 data: [DONE] 结束。 | default: false | | max_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | default: 4096; min: 1 | | max_completion_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | | | temperature | number | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | tools | object[] | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | response_format | object | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | ## 输出字段 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | id | string | — | 创建任务返回的生成 ID。 | | | object | string | — | chat.completion / chat.completion.chunk | | | model | string | — | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | | | choices | array | — | 回答列表。非流式使用 choices[].message，流式数据块使用 choices[].delta。 | | | usage | object | — | 包含 prompt_tokens、completion_tokens、total_tokens。流式响应在供应商提供时包含用量。 | | ## cURL ```bash curl 'https://01router.com/api/v1/chat/completions' \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-6-sol", "messages": [ { "role": "user", "content": "Hello!" } ], "max_tokens": 512, "stream": false }' ``` ## 200 · application/json ```json { "id": "chat_example", "object": "chat.completion", "model": "gpt-6-sol", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "Hello!" }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 8, "completion_tokens": 2, "total_tokens": 10 } } ``` ## SSE · stream: true ```text data: {"id":"chat_example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"Hello!"},"finish_reason":null}]} data: [DONE] ``` ## 使用说明 - OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 ## 此模型使用的接口 - [POST /api/v1/chat/completions](https://01router.com/docs/llms-full.txt?locale=zh§ion=chat): 对话补全 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=model-detail): 查询单个模型 调用 /generations 和 /quote 时，将以下参数放入 input；调用 /images/generations 时放在顶层；对话参数放在 /chat/completions 顶层。 选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入，请将示例媒体地址替换为可访问的文件。 ### Provider parameter schemas ```json [ { "provider": "wavespeed", "params": [] }, { "provider": "kie", "params": [] }, { "provider": "apimart", "params": [] }, { "provider": "evolink", "params": [] }, { "provider": "atlascloud", "params": [] }, { "provider": "vercel", "params": [] }, { "provider": "openrouter", "params": [] } ] ``` --- Source: https://01router.com/zh/docs/models/gpt-6-luna # GPT-6 Luna API OpenAI GPT-6 Luna: the fastest, lowest-cost GPT-6 tier for high-volume tasks. 1.05M context. `POST /api/v1/chat/completions` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "gpt-6-luna" ] | | messages | object[] | yes | 非空消息数组，每项包含 role 和 content；content 可包含模型支持的多模态内容。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | stream | boolean | no | 默认 false；true 返回 text/event-stream 数据流，以 data: [DONE] 结束。 | default: false | | max_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | default: 4096; min: 1 | | max_completion_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | | | temperature | number | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | tools | object[] | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | response_format | object | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | ## 输出字段 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | id | string | — | 创建任务返回的生成 ID。 | | | object | string | — | chat.completion / chat.completion.chunk | | | model | string | — | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | | | choices | array | — | 回答列表。非流式使用 choices[].message，流式数据块使用 choices[].delta。 | | | usage | object | — | 包含 prompt_tokens、completion_tokens、total_tokens。流式响应在供应商提供时包含用量。 | | ## cURL ```bash curl 'https://01router.com/api/v1/chat/completions' \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-6-luna", "messages": [ { "role": "user", "content": "Hello!" } ], "max_tokens": 512, "stream": false }' ``` ## 200 · application/json ```json { "id": "chat_example", "object": "chat.completion", "model": "gpt-6-luna", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "Hello!" }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 8, "completion_tokens": 2, "total_tokens": 10 } } ``` ## SSE · stream: true ```text data: {"id":"chat_example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"Hello!"},"finish_reason":null}]} data: [DONE] ``` ## 使用说明 - OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 ## 此模型使用的接口 - [POST /api/v1/chat/completions](https://01router.com/docs/llms-full.txt?locale=zh§ion=chat): 对话补全 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=model-detail): 查询单个模型 调用 /generations 和 /quote 时，将以下参数放入 input；调用 /images/generations 时放在顶层；对话参数放在 /chat/completions 顶层。 选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入，请将示例媒体地址替换为可访问的文件。 ### Provider parameter schemas ```json [ { "provider": "01router", "params": [] }, { "provider": "wavespeed", "params": [] }, { "provider": "kie", "params": [] }, { "provider": "apimart", "params": [] }, { "provider": "evolink", "params": [] }, { "provider": "atlascloud", "params": [] }, { "provider": "vercel", "params": [] }, { "provider": "openrouter", "params": [] } ] ``` --- Source: https://01router.com/zh/docs/models/gpt-5.6-sol # GPT-5.6 Sol API OpenAI GPT-5.6 Sol: flagship GPT-5.6 tier for complex reasoning and coding. `POST /api/v1/chat/completions` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "gpt-5.6-sol" ] | | messages | object[] | yes | 非空消息数组，每项包含 role 和 content；content 可包含模型支持的多模态内容。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | stream | boolean | no | 默认 false；true 返回 text/event-stream 数据流，以 data: [DONE] 结束。 | default: false | | max_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | default: 4096; min: 1 | | max_completion_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | | | temperature | number | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | tools | object[] | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | response_format | object | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | ## 输出字段 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | id | string | — | 创建任务返回的生成 ID。 | | | object | string | — | chat.completion / chat.completion.chunk | | | model | string | — | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | | | choices | array | — | 回答列表。非流式使用 choices[].message，流式数据块使用 choices[].delta。 | | | usage | object | — | 包含 prompt_tokens、completion_tokens、total_tokens。流式响应在供应商提供时包含用量。 | | ## cURL ```bash curl 'https://01router.com/api/v1/chat/completions' \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-5.6-sol", "messages": [ { "role": "user", "content": "Hello!" } ], "max_tokens": 512, "stream": false }' ``` ## 200 · application/json ```json { "id": "chat_example", "object": "chat.completion", "model": "gpt-5.6-sol", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "Hello!" }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 8, "completion_tokens": 2, "total_tokens": 10 } } ``` ## SSE · stream: true ```text data: {"id":"chat_example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"Hello!"},"finish_reason":null}]} data: [DONE] ``` ## 使用说明 - OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 ## 此模型使用的接口 - [POST /api/v1/chat/completions](https://01router.com/docs/llms-full.txt?locale=zh§ion=chat): 对话补全 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=model-detail): 查询单个模型 调用 /generations 和 /quote 时，将以下参数放入 input；调用 /images/generations 时放在顶层；对话参数放在 /chat/completions 顶层。 选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入，请将示例媒体地址替换为可访问的文件。 ### Provider parameter schemas ```json [ { "provider": "replicate", "params": [] }, { "provider": "wavespeed", "params": [] }, { "provider": "kie", "params": [] }, { "provider": "apimart", "params": [] }, { "provider": "evolink", "params": [] }, { "provider": "atlascloud", "params": [] }, { "provider": "vercel", "params": [] }, { "provider": "openrouter", "params": [] } ] ``` --- Source: https://01router.com/zh/docs/models/gpt-5.6-terra # GPT-5.6 Terra API OpenAI GPT-5.6 Terra: mid GPT-5.6 tier balancing quality and cost. `POST /api/v1/chat/completions` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "gpt-5.6-terra" ] | | messages | object[] | yes | 非空消息数组，每项包含 role 和 content；content 可包含模型支持的多模态内容。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | stream | boolean | no | 默认 false；true 返回 text/event-stream 数据流，以 data: [DONE] 结束。 | default: false | | max_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | default: 4096; min: 1 | | max_completion_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | | | temperature | number | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | tools | object[] | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | response_format | object | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | ## 输出字段 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | id | string | — | 创建任务返回的生成 ID。 | | | object | string | — | chat.completion / chat.completion.chunk | | | model | string | — | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | | | choices | array | — | 回答列表。非流式使用 choices[].message，流式数据块使用 choices[].delta。 | | | usage | object | — | 包含 prompt_tokens、completion_tokens、total_tokens。流式响应在供应商提供时包含用量。 | | ## cURL ```bash curl 'https://01router.com/api/v1/chat/completions' \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-5.6-terra", "messages": [ { "role": "user", "content": "Hello!" } ], "max_tokens": 512, "stream": false }' ``` ## 200 · application/json ```json { "id": "chat_example", "object": "chat.completion", "model": "gpt-5.6-terra", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "Hello!" }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 8, "completion_tokens": 2, "total_tokens": 10 } } ``` ## SSE · stream: true ```text data: {"id":"chat_example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"Hello!"},"finish_reason":null}]} data: [DONE] ``` ## 使用说明 - OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 ## 此模型使用的接口 - [POST /api/v1/chat/completions](https://01router.com/docs/llms-full.txt?locale=zh§ion=chat): 对话补全 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=model-detail): 查询单个模型 调用 /generations 和 /quote 时，将以下参数放入 input；调用 /images/generations 时放在顶层；对话参数放在 /chat/completions 顶层。 选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入，请将示例媒体地址替换为可访问的文件。 ### Provider parameter schemas ```json [ { "provider": "replicate", "params": [] }, { "provider": "wavespeed", "params": [] }, { "provider": "kie", "params": [] }, { "provider": "apimart", "params": [] }, { "provider": "evolink", "params": [] }, { "provider": "atlascloud", "params": [] }, { "provider": "vercel", "params": [] }, { "provider": "openrouter", "params": [] } ] ``` --- Source: https://01router.com/zh/docs/models/gpt-5.6-luna # GPT-5.6 Luna API OpenAI GPT-5.6 Luna: small, fast GPT-5.6 tier. `POST /api/v1/chat/completions` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "gpt-5.6-luna" ] | | messages | object[] | yes | 非空消息数组，每项包含 role 和 content；content 可包含模型支持的多模态内容。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | stream | boolean | no | 默认 false；true 返回 text/event-stream 数据流，以 data: [DONE] 结束。 | default: false | | max_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | default: 4096; min: 1 | | max_completion_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | | | temperature | number | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | tools | object[] | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | response_format | object | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | ## 输出字段 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | id | string | — | 创建任务返回的生成 ID。 | | | object | string | — | chat.completion / chat.completion.chunk | | | model | string | — | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | | | choices | array | — | 回答列表。非流式使用 choices[].message，流式数据块使用 choices[].delta。 | | | usage | object | — | 包含 prompt_tokens、completion_tokens、total_tokens。流式响应在供应商提供时包含用量。 | | ## cURL ```bash curl 'https://01router.com/api/v1/chat/completions' \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-5.6-luna", "messages": [ { "role": "user", "content": "Hello!" } ], "max_tokens": 512, "stream": false }' ``` ## 200 · application/json ```json { "id": "chat_example", "object": "chat.completion", "model": "gpt-5.6-luna", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "Hello!" }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 8, "completion_tokens": 2, "total_tokens": 10 } } ``` ## SSE · stream: true ```text data: {"id":"chat_example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"Hello!"},"finish_reason":null}]} data: [DONE] ``` ## 使用说明 - OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 ## 此模型使用的接口 - [POST /api/v1/chat/completions](https://01router.com/docs/llms-full.txt?locale=zh§ion=chat): 对话补全 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=model-detail): 查询单个模型 调用 /generations 和 /quote 时，将以下参数放入 input；调用 /images/generations 时放在顶层；对话参数放在 /chat/completions 顶层。 选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入，请将示例媒体地址替换为可访问的文件。 ### Provider parameter schemas ```json [ { "provider": "replicate", "params": [] }, { "provider": "wavespeed", "params": [] }, { "provider": "kie", "params": [] }, { "provider": "apimart", "params": [] }, { "provider": "evolink", "params": [] }, { "provider": "atlascloud", "params": [] }, { "provider": "vercel", "params": [] }, { "provider": "openrouter", "params": [] } ] ``` --- Source: https://01router.com/zh/docs/models/claude-opus-5.5 # Claude Opus 5.5 API Anthropic Claude Opus 5.5: frontier model for agentic coding, long-horizon tasks and deep analysis. 1M context. `POST /api/v1/chat/completions` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "claude-opus-5.5" ] | | messages | object[] | yes | 非空消息数组，每项包含 role 和 content；content 可包含模型支持的多模态内容。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | stream | boolean | no | 默认 false；true 返回 text/event-stream 数据流，以 data: [DONE] 结束。 | default: false | | max_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | default: 4096; min: 1 | | max_completion_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | | | temperature | number | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | tools | object[] | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | response_format | object | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | ## 输出字段 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | id | string | — | 创建任务返回的生成 ID。 | | | object | string | — | chat.completion / chat.completion.chunk | | | model | string | — | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | | | choices | array | — | 回答列表。非流式使用 choices[].message，流式数据块使用 choices[].delta。 | | | usage | object | — | 包含 prompt_tokens、completion_tokens、total_tokens。流式响应在供应商提供时包含用量。 | | ## cURL ```bash curl 'https://01router.com/api/v1/chat/completions' \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-opus-5.5", "messages": [ { "role": "user", "content": "Hello!" } ], "max_tokens": 512, "stream": false }' ``` ## 200 · application/json ```json { "id": "chat_example", "object": "chat.completion", "model": "claude-opus-5.5", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "Hello!" }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 8, "completion_tokens": 2, "total_tokens": 10 } } ``` ## SSE · stream: true ```text data: {"id":"chat_example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"Hello!"},"finish_reason":null}]} data: [DONE] ``` ## 使用说明 - OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 ## 此模型使用的接口 - [POST /api/v1/chat/completions](https://01router.com/docs/llms-full.txt?locale=zh§ion=chat): 对话补全 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=model-detail): 查询单个模型 调用 /generations 和 /quote 时，将以下参数放入 input；调用 /images/generations 时放在顶层；对话参数放在 /chat/completions 顶层。 选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入，请将示例媒体地址替换为可访问的文件。 ### Provider parameter schemas ```json [ { "provider": "replicate", "params": [] }, { "provider": "wavespeed", "params": [] }, { "provider": "kie", "params": [] }, { "provider": "apimart", "params": [] }, { "provider": "evolink", "params": [] }, { "provider": "vercel", "params": [] }, { "provider": "openrouter", "params": [] } ] ``` --- Source: https://01router.com/zh/docs/models/claude-sonnet-5.5 # Claude Sonnet 5.5 API Anthropic Claude Sonnet 5.5: fast, capable everyday model for coding, writing and agents. 1M context. `POST /api/v1/chat/completions` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "claude-sonnet-5.5" ] | | messages | object[] | yes | 非空消息数组，每项包含 role 和 content；content 可包含模型支持的多模态内容。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | stream | boolean | no | 默认 false；true 返回 text/event-stream 数据流，以 data: [DONE] 结束。 | default: false | | max_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | default: 4096; min: 1 | | max_completion_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | | | temperature | number | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | tools | object[] | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | response_format | object | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | ## 输出字段 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | id | string | — | 创建任务返回的生成 ID。 | | | object | string | — | chat.completion / chat.completion.chunk | | | model | string | — | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | | | choices | array | — | 回答列表。非流式使用 choices[].message，流式数据块使用 choices[].delta。 | | | usage | object | — | 包含 prompt_tokens、completion_tokens、total_tokens。流式响应在供应商提供时包含用量。 | | ## cURL ```bash curl 'https://01router.com/api/v1/chat/completions' \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-5.5", "messages": [ { "role": "user", "content": "Hello!" } ], "max_tokens": 512, "stream": false }' ``` ## 200 · application/json ```json { "id": "chat_example", "object": "chat.completion", "model": "claude-sonnet-5.5", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "Hello!" }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 8, "completion_tokens": 2, "total_tokens": 10 } } ``` ## SSE · stream: true ```text data: {"id":"chat_example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"Hello!"},"finish_reason":null}]} data: [DONE] ``` ## 使用说明 - OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 ## 此模型使用的接口 - [POST /api/v1/chat/completions](https://01router.com/docs/llms-full.txt?locale=zh§ion=chat): 对话补全 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=model-detail): 查询单个模型 调用 /generations 和 /quote 时，将以下参数放入 input；调用 /images/generations 时放在顶层；对话参数放在 /chat/completions 顶层。 选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入，请将示例媒体地址替换为可访问的文件。 ### Provider parameter schemas ```json [ { "provider": "wavespeed", "params": [] }, { "provider": "kie", "params": [] }, { "provider": "apimart", "params": [] }, { "provider": "evolink", "params": [] }, { "provider": "vercel", "params": [] }, { "provider": "openrouter", "params": [] } ] ``` --- Source: https://01router.com/zh/docs/models/gemini-4-argon # Gemini 4 Argon API Google Gemini 4 Argon: multimodal reasoning model with a 1M-token context. `POST /api/v1/chat/completions` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "gemini-4-argon" ] | | messages | object[] | yes | 非空消息数组，每项包含 role 和 content；content 可包含模型支持的多模态内容。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | stream | boolean | no | 默认 false；true 返回 text/event-stream 数据流，以 data: [DONE] 结束。 | default: false | | max_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | default: 4096; min: 1 | | max_completion_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | | | temperature | number | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | tools | object[] | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | response_format | object | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | ## 输出字段 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | id | string | — | 创建任务返回的生成 ID。 | | | object | string | — | chat.completion / chat.completion.chunk | | | model | string | — | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | | | choices | array | — | 回答列表。非流式使用 choices[].message，流式数据块使用 choices[].delta。 | | | usage | object | — | 包含 prompt_tokens、completion_tokens、total_tokens。流式响应在供应商提供时包含用量。 | | ## cURL ```bash curl 'https://01router.com/api/v1/chat/completions' \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gemini-4-argon", "messages": [ { "role": "user", "content": "Hello!" } ], "max_tokens": 512, "stream": false }' ``` ## 200 · application/json ```json { "id": "chat_example", "object": "chat.completion", "model": "gemini-4-argon", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "Hello!" }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 8, "completion_tokens": 2, "total_tokens": 10 } } ``` ## SSE · stream: true ```text data: {"id":"chat_example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"Hello!"},"finish_reason":null}]} data: [DONE] ``` ## 使用说明 - OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 ## 此模型使用的接口 - [POST /api/v1/chat/completions](https://01router.com/docs/llms-full.txt?locale=zh§ion=chat): 对话补全 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=model-detail): 查询单个模型 调用 /generations 和 /quote 时，将以下参数放入 input；调用 /images/generations 时放在顶层；对话参数放在 /chat/completions 顶层。 选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入，请将示例媒体地址替换为可访问的文件。 ### Provider parameter schemas ```json [ { "provider": "wavespeed", "params": [] }, { "provider": "kie", "params": [] }, { "provider": "apimart", "params": [] }, { "provider": "evolink", "params": [] }, { "provider": "atlascloud", "params": [] }, { "provider": "vercel", "params": [] }, { "provider": "openrouter", "params": [] } ] ``` --- Source: https://01router.com/zh/docs/models/gemini-3.8-flash # Gemini 3.8 Flash API Google Gemini 3.8 Flash: fast, low-cost multimodal model with a 1M-token context. `POST /api/v1/chat/completions` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "gemini-3.8-flash" ] | | messages | object[] | yes | 非空消息数组，每项包含 role 和 content；content 可包含模型支持的多模态内容。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | stream | boolean | no | 默认 false；true 返回 text/event-stream 数据流，以 data: [DONE] 结束。 | default: false | | max_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | default: 4096; min: 1 | | max_completion_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | | | temperature | number | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | tools | object[] | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | response_format | object | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | ## 输出字段 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | id | string | — | 创建任务返回的生成 ID。 | | | object | string | — | chat.completion / chat.completion.chunk | | | model | string | — | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | | | choices | array | — | 回答列表。非流式使用 choices[].message，流式数据块使用 choices[].delta。 | | | usage | object | — | 包含 prompt_tokens、completion_tokens、total_tokens。流式响应在供应商提供时包含用量。 | | ## cURL ```bash curl 'https://01router.com/api/v1/chat/completions' \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gemini-3.8-flash", "messages": [ { "role": "user", "content": "Hello!" } ], "max_tokens": 512, "stream": false }' ``` ## 200 · application/json ```json { "id": "chat_example", "object": "chat.completion", "model": "gemini-3.8-flash", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "Hello!" }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 8, "completion_tokens": 2, "total_tokens": 10 } } ``` ## SSE · stream: true ```text data: {"id":"chat_example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"Hello!"},"finish_reason":null}]} data: [DONE] ``` ## 使用说明 - OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 ## 此模型使用的接口 - [POST /api/v1/chat/completions](https://01router.com/docs/llms-full.txt?locale=zh§ion=chat): 对话补全 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=model-detail): 查询单个模型 调用 /generations 和 /quote 时，将以下参数放入 input；调用 /images/generations 时放在顶层；对话参数放在 /chat/completions 顶层。 选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入，请将示例媒体地址替换为可访问的文件。 ### Provider parameter schemas ```json [ { "provider": "wavespeed", "params": [] }, { "provider": "kie", "params": [] }, { "provider": "apimart", "params": [] }, { "provider": "evolink", "params": [] }, { "provider": "atlascloud", "params": [] }, { "provider": "vercel", "params": [] }, { "provider": "openrouter", "params": [] } ] ``` --- Source: https://01router.com/zh/docs/models/grok-4.7 # Grok 4.7 API xAI Grok 4.7: reasoning model with real-time knowledge and a 500K context. `POST /api/v1/chat/completions` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "grok-4.7" ] | | messages | object[] | yes | 非空消息数组，每项包含 role 和 content；content 可包含模型支持的多模态内容。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | stream | boolean | no | 默认 false；true 返回 text/event-stream 数据流，以 data: [DONE] 结束。 | default: false | | max_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | default: 4096; min: 1 | | max_completion_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | | | temperature | number | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | tools | object[] | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | response_format | object | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | ## 输出字段 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | id | string | — | 创建任务返回的生成 ID。 | | | object | string | — | chat.completion / chat.completion.chunk | | | model | string | — | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | | | choices | array | — | 回答列表。非流式使用 choices[].message，流式数据块使用 choices[].delta。 | | | usage | object | — | 包含 prompt_tokens、completion_tokens、total_tokens。流式响应在供应商提供时包含用量。 | | ## cURL ```bash curl 'https://01router.com/api/v1/chat/completions' \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "grok-4.7", "messages": [ { "role": "user", "content": "Hello!" } ], "max_tokens": 512, "stream": false }' ``` ## 200 · application/json ```json { "id": "chat_example", "object": "chat.completion", "model": "grok-4.7", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "Hello!" }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 8, "completion_tokens": 2, "total_tokens": 10 } } ``` ## SSE · stream: true ```text data: {"id":"chat_example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"Hello!"},"finish_reason":null}]} data: [DONE] ``` ## 使用说明 - OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 ## 此模型使用的接口 - [POST /api/v1/chat/completions](https://01router.com/docs/llms-full.txt?locale=zh§ion=chat): 对话补全 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=model-detail): 查询单个模型 调用 /generations 和 /quote 时，将以下参数放入 input；调用 /images/generations 时放在顶层；对话参数放在 /chat/completions 顶层。 选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入，请将示例媒体地址替换为可访问的文件。 ### Provider parameter schemas ```json [ { "provider": "wavespeed", "params": [] }, { "provider": "kie", "params": [] }, { "provider": "apimart", "params": [] }, { "provider": "evolink", "params": [] }, { "provider": "atlascloud", "params": [] }, { "provider": "vercel", "params": [] }, { "provider": "openrouter", "params": [] } ] ``` --- Source: https://01router.com/zh/docs/models/deepseek-v4.1-flash # DeepSeek V4.1 Flash API DeepSeek V4.1 Flash: very low-cost fast model with a 1M-token context. `POST /api/v1/chat/completions` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "deepseek-v4.1-flash" ] | | messages | object[] | yes | 非空消息数组，每项包含 role 和 content；content 可包含模型支持的多模态内容。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | stream | boolean | no | 默认 false；true 返回 text/event-stream 数据流，以 data: [DONE] 结束。 | default: false | | max_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | default: 4096; min: 1 | | max_completion_tokens | integer | no | 正整数，默认 4096，不可与 max_completion_tokens 同时传入。 | | | temperature | number | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | tools | object[] | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | | response_format | object | no | OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 | | ## 输出字段 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | id | string | — | 创建任务返回的生成 ID。 | | | object | string | — | chat.completion / chat.completion.chunk | | | model | string | — | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | | | choices | array | — | 回答列表。非流式使用 choices[].message，流式数据块使用 choices[].delta。 | | | usage | object | — | 包含 prompt_tokens、completion_tokens、total_tokens。流式响应在供应商提供时包含用量。 | | ## cURL ```bash curl 'https://01router.com/api/v1/chat/completions' \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "deepseek-v4.1-flash", "messages": [ { "role": "user", "content": "Hello!" } ], "max_tokens": 512, "stream": false }' ``` ## 200 · application/json ```json { "id": "chat_example", "object": "chat.completion", "model": "deepseek-v4.1-flash", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "Hello!" }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 8, "completion_tokens": 2, "total_tokens": 10 } } ``` ## SSE · stream: true ```text data: {"id":"chat_example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"Hello!"},"finish_reason":null}]} data: [DONE] ``` ## 使用说明 - OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。 ## 此模型使用的接口 - [POST /api/v1/chat/completions](https://01router.com/docs/llms-full.txt?locale=zh§ion=chat): 对话补全 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=model-detail): 查询单个模型 调用 /generations 和 /quote 时，将以下参数放入 input；调用 /images/generations 时放在顶层；对话参数放在 /chat/completions 顶层。 选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入，请将示例媒体地址替换为可访问的文件。 ### Provider parameter schemas ```json [ { "provider": "01router", "params": [] }, { "provider": "wavespeed", "params": [] }, { "provider": "kie", "params": [] }, { "provider": "apimart", "params": [] }, { "provider": "evolink", "params": [] }, { "provider": "atlascloud", "params": [] }, { "provider": "vercel", "params": [] }, { "provider": "openrouter", "params": [] } ] ``` --- Source: https://01router.com/zh/docs/models/suno-v6 # Suno V6 API Suno V6 music generation: full songs with vocals or instrumentals from a description, or your own lyrics and style in custom mode. Each request returns two tracks. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "suno-v6" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | no | Song description (simple mode) or lyrics (custom mode) | | | input.custom_mode | boolean | no | Use your own lyrics, style and title | default: false | | input.instrumental | boolean | no | | default: false | | input.style | string | no | Custom mode only, e.g. "dream pop, female vocals" | | | input.title | string | no | Custom mode only | | | input.negative_tags | string | no | | | | input.vocal_gender | enum | no | | options: [ "m", "f" ] | | input.duration | integer | no | Custom mode only | min: 10; max: 360 | ## 输出字段 | 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": "suno-v6", "input": { "prompt": "A cinematic landscape at sunrise.", "custom_mode": false, "instrumental": false } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "suno-v6", "type": "audio", "provider": "kie", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "custom_mode": false, "instrumental": false }, "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§ion=create): 创建生成任务 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=model-detail): 查询单个模型 调用 /generations 和 /quote 时，将以下参数放入 input；调用 /images/generations 时放在顶层；对话参数放在 /chat/completions 顶层。 选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入，请将示例媒体地址替换为可访问的文件。 ### Provider parameter schemas ```json [ { "provider": "kie", "params": [ { "name": "prompt", "type": "text", "label": "Prompt / lyrics", "description": "Song description (simple mode) or lyrics (custom mode)", "maxLength": 5000 }, { "name": "custom_mode", "type": "boolean", "label": "Custom mode", "description": "Use your own lyrics, style and title", "default": false }, { "name": "instrumental", "type": "boolean", "label": "Instrumental", "default": false }, { "name": "style", "type": "string", "label": "Style", "description": "Custom mode only, e.g. \"dream pop, female vocals\"", "maxLength": 1000 }, { "name": "title", "type": "string", "label": "Title", "description": "Custom mode only", "maxLength": 80 }, { "name": "negative_tags", "type": "string", "label": "Exclude styles" }, { "name": "vocal_gender", "type": "enum", "label": "Vocal gender", "options": [ "m", "f" ] }, { "name": "duration", "type": "integer", "label": "Duration (s)", "description": "Custom mode only", "min": 10, "max": 360 } ] }, { "provider": "apimart", "params": [ { "name": "prompt", "type": "text", "label": "Prompt / lyrics", "description": "Song description (simple mode) or lyrics (custom mode)", "maxLength": 5000 }, { "name": "custom_mode", "type": "boolean", "label": "Custom mode", "description": "Use your own lyrics, style and title", "default": false }, { "name": "instrumental", "type": "boolean", "label": "Instrumental", "default": false }, { "name": "style", "type": "string", "label": "Style", "description": "Custom mode only, e.g. \"dream pop, female vocals\"", "maxLength": 1000 }, { "name": "title", "type": "string", "label": "Title", "description": "Custom mode only", "maxLength": 80 }, { "name": "negative_tags", "type": "string", "label": "Exclude styles" }, { "name": "vocal_gender", "type": "enum", "label": "Vocal gender", "options": [ "m", "f" ] }, { "name": "duration", "type": "integer", "label": "Duration (s)", "description": "Custom mode only", "min": 10, "max": 360 } ] }, { "provider": "evolink", "params": [ { "name": "prompt", "type": "text", "label": "Prompt / lyrics", "description": "Song description (simple mode) or lyrics (custom mode)" }, { "name": "custom_mode", "type": "boolean", "label": "Custom mode", "description": "Use your own lyrics, style and title", "default": false }, { "name": "instrumental", "type": "boolean", "label": "Instrumental", "default": false }, { "name": "style", "type": "string", "label": "Style", "description": "Custom mode only, e.g. \"dream pop, female vocals\"" }, { "name": "title", "type": "string", "label": "Title", "description": "Custom mode only" }, { "name": "negative_tags", "type": "string", "label": "Exclude styles" }, { "name": "vocal_gender", "type": "enum", "label": "Vocal gender", "options": [ "m", "f" ] }, { "name": "duration", "type": "integer", "label": "Duration (s)", "description": "Custom mode only", "min": 10, "max": 360 } ] }, { "provider": "atlascloud", "params": [ { "name": "prompt", "type": "text", "label": "Prompt / lyrics", "description": "Song description (simple mode) or lyrics (custom mode)", "maxLength": 3000 }, { "name": "custom_mode", "type": "boolean", "label": "Custom mode", "description": "Use your own lyrics, style and title", "default": false }, { "name": "instrumental", "type": "boolean", "label": "Instrumental", "default": false }, { "name": "style", "type": "string", "label": "Style", "description": "Custom mode only, e.g. \"dream pop, female vocals\"", "maxLength": 500 }, { "name": "title", "type": "string", "label": "Title", "description": "Custom mode only", "maxLength": 200 }, { "name": "negative_tags", "type": "string", "label": "Exclude styles", "maxLength": 500 }, { "name": "vocal_gender", "type": "enum", "label": "Vocal gender", "options": [ "m", "f" ] }, { "name": "duration", "type": "integer", "label": "Duration (s)", "description": "Custom mode only", "min": 10, "max": 360 } ] } ] ``` --- Source: https://01router.com/zh/docs/models/gemini-3.8-flash-tts # Gemini 3.8 Flash TTS API Google Gemini 3.8 Flash TTS: expressive speech in 30 voices with natural-language style control and inline vocal events like . `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "gemini-3.8-flash-tts" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | | | input.voice | enum | no | | default: "Kore"; options: [ "Kore", "Puck", "Charon", "Fenrir", "Leda", "Orus", "Aoede", "Zephyr", "Callirrhoe", "Autonoe", "Enceladus", "Iapetus", "Umbriel", "Algieba", "Despina", "Erinome", "Algenib", "Rasalgethi", "Laomedeia", "Achernar", "Alnilam", "Schedar", "Gacrux", "Pulcherrima", "Achird", "Zubenelgenubi", "Vindemiatrix", "Sadachbia", "Sadaltager", "Sulafat" ] | | input.style_instructions | string | no | e.g. "cheerful and friendly"; billing depends on the provider | | ## 输出字段 | 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": "gemini-3.8-flash-tts", "input": { "prompt": "A cinematic landscape at sunrise.", "voice": "Kore" } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "gemini-3.8-flash-tts", "type": "audio", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "voice": "Kore" }, "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§ion=create): 创建生成任务 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=model-detail): 查询单个模型 调用 /generations 和 /quote 时，将以下参数放入 input；调用 /images/generations 时放在顶层；对话参数放在 /chat/completions 顶层。 选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入，请将示例媒体地址替换为可访问的文件。 ### Provider parameter schemas ```json [ { "provider": "fal", "params": [ { "name": "prompt", "type": "text", "label": "Text", "required": true }, { "name": "voice", "type": "enum", "label": "Voice", "options": [ "Kore", "Puck", "Charon", "Fenrir", "Leda", "Orus", "Aoede", "Zephyr", "Callirrhoe", "Autonoe", "Enceladus", "Iapetus", "Umbriel", "Algieba", "Despina", "Erinome", "Algenib", "Rasalgethi", "Laomedeia", "Achernar", "Alnilam", "Schedar", "Gacrux", "Pulcherrima", "Achird", "Zubenelgenubi", "Vindemiatrix", "Sadachbia", "Sadaltager", "Sulafat" ], "default": "Kore" }, { "name": "style_instructions", "type": "string", "label": "Style", "description": "e.g. \"cheerful and friendly\"; billing depends on the provider" } ] }, { "provider": "wavespeed", "params": [ { "name": "prompt", "type": "text", "label": "Text", "required": true, "maxLength": 8000 }, { "name": "voice", "type": "enum", "label": "Voice", "options": [ "Kore", "Puck", "Charon", "Fenrir", "Leda", "Orus", "Aoede", "Zephyr", "Callirrhoe", "Autonoe", "Enceladus", "Iapetus", "Umbriel", "Algieba", "Despina", "Erinome", "Algenib", "Rasalgethi", "Laomedeia", "Achernar", "Alnilam", "Schedar", "Gacrux", "Pulcherrima", "Achird", "Zubenelgenubi", "Vindemiatrix", "Sadachbia", "Sadaltager", "Sulafat" ], "default": "Kore" }, { "name": "style_instructions", "type": "string", "label": "Style", "description": "e.g. \"cheerful and friendly\"; billing depends on the provider", "maxLength": 2000 } ] }, { "provider": "kie", "params": [ { "name": "prompt", "type": "text", "label": "Text", "required": true, "maxLength": 8000 }, { "name": "voice", "type": "enum", "label": "Voice", "options": [ "Kore", "Puck", "Charon", "Fenrir", "Leda", "Orus", "Aoede", "Zephyr", "Callirrhoe", "Autonoe", "Enceladus", "Iapetus", "Umbriel", "Algieba", "Despina", "Erinome", "Algenib", "Rasalgethi", "Laomedeia", "Achernar", "Alnilam", "Schedar", "Gacrux", "Pulcherrima", "Achird", "Zubenelgenubi", "Vindemiatrix", "Sadachbia", "Sadaltager", "Sulafat" ], "default": "Kore" }, { "name": "style_instructions", "type": "string", "label": "Style", "description": "e.g. \"cheerful and friendly\"; billing depends on the provider", "maxLength": 2000 } ] }, { "provider": "vercel", "params": [ { "name": "prompt", "type": "text", "label": "Text", "required": true, "maxLength": 8000 }, { "name": "voice", "type": "enum", "label": "Voice", "options": [ "Kore", "Puck", "Charon", "Fenrir", "Leda", "Orus", "Aoede", "Zephyr", "Callirrhoe", "Autonoe", "Enceladus", "Iapetus", "Umbriel", "Algieba", "Despina", "Erinome", "Algenib", "Rasalgethi", "Laomedeia", "Achernar", "Alnilam", "Schedar", "Gacrux", "Pulcherrima", "Achird", "Zubenelgenubi", "Vindemiatrix", "Sadachbia", "Sadaltager", "Sulafat" ], "default": "Kore" }, { "name": "style_instructions", "type": "string", "label": "Style", "description": "e.g. \"cheerful and friendly\"; billing depends on the provider", "maxLength": 2000 } ] }, { "provider": "openrouter", "params": [ { "name": "prompt", "type": "text", "label": "Text", "required": true, "maxLength": 8000 }, { "name": "voice", "type": "enum", "label": "Voice", "options": [ "Kore", "Puck", "Charon", "Fenrir", "Leda", "Orus", "Aoede", "Zephyr", "Callirrhoe", "Autonoe", "Enceladus", "Iapetus", "Umbriel", "Algieba", "Despina", "Erinome", "Algenib", "Rasalgethi", "Laomedeia", "Achernar", "Alnilam", "Schedar", "Gacrux", "Pulcherrima", "Achird", "Zubenelgenubi", "Vindemiatrix", "Sadachbia", "Sadaltager", "Sulafat" ], "default": "Kore" }, { "name": "style_instructions", "type": "string", "label": "Style", "description": "e.g. \"cheerful and friendly\"; billing depends on the provider", "maxLength": 2000 } ] } ] ``` --- Source: https://01router.com/zh/docs/models/elevenlabs-tts-v4 # ElevenLabs Eleven v4 API ElevenLabs Eleven v4: expressive multilingual speech with audio tags, voice selection and delivery controls. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "elevenlabs-tts-v4" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | maxLength: 5000 | | input.voice | string | no | | default: "Rachel" | | input.stability | number | no | | default: 0.5; min: 0; max: 1 | | input.similarity_boost | number | no | | default: 0.75; min: 0; max: 1 | | input.language_code | string | no | ISO 639-1, e.g. en or zh | | | input.seed | integer | no | | min: 0; max: 4294967295 | | input.output_format | enum | no | | default: "mp3_44100_128"; options: [ "mp3_22050_32", "mp3_44100_32", "mp3_44100_64", "mp3_44100_96", "mp3_44100_128", "mp3_44100_192", "pcm_8000", "pcm_16000", "pcm_22050", "pcm_24000", "pcm_44100", "pcm_48000", "ulaw_8000", "alaw_8000", "opus_48000_32", "opus_48000_64", "opus_48000_96", "opus_48000_128", "opus_48000_192" ] | | input.apply_text_normalization | enum | no | | default: "auto"; options: [ "auto", "on", "off" ] | ## 输出字段 | 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": "elevenlabs-tts-v4", "input": { "prompt": "A cinematic landscape at sunrise.", "voice": "Rachel", "stability": 0.5, "similarity_boost": 0.75, "output_format": "mp3_44100_128", "apply_text_normalization": "auto" } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "elevenlabs-tts-v4", "type": "audio", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "voice": "Rachel", "stability": 0.5, "similarity_boost": 0.75, "output_format": "mp3_44100_128", "apply_text_normalization": "auto" }, "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§ion=create): 创建生成任务 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=model-detail): 查询单个模型 调用 /generations 和 /quote 时，将以下参数放入 input；调用 /images/generations 时放在顶层；对话参数放在 /chat/completions 顶层。 选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入，请将示例媒体地址替换为可访问的文件。 ### Provider parameter schemas ```json [ { "provider": "fal", "params": [ { "name": "prompt", "type": "text", "label": "Text", "required": true, "maxLength": 5000 }, { "name": "voice", "type": "string", "label": "Voice", "default": "Rachel" }, { "name": "stability", "type": "number", "label": "Stability", "min": 0, "max": 1, "default": 0.5 }, { "name": "similarity_boost", "type": "number", "label": "Voice similarity", "min": 0, "max": 1, "default": 0.75 }, { "name": "language_code", "type": "string", "label": "Language code", "description": "ISO 639-1, e.g. en or zh" }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 4294967295 }, { "name": "output_format", "type": "enum", "label": "Output format", "options": [ "mp3_22050_32", "mp3_44100_32", "mp3_44100_64", "mp3_44100_96", "mp3_44100_128", "mp3_44100_192", "pcm_8000", "pcm_16000", "pcm_22050", "pcm_24000", "pcm_44100", "pcm_48000", "ulaw_8000", "alaw_8000", "opus_48000_32", "opus_48000_64", "opus_48000_96", "opus_48000_128", "opus_48000_192" ], "default": "mp3_44100_128" }, { "name": "apply_text_normalization", "type": "enum", "label": "Text normalization", "options": [ "auto", "on", "off" ], "default": "auto" } ] }, { "provider": "wavespeed", "params": [ { "name": "prompt", "type": "text", "label": "Text", "required": true, "maxLength": 5000 }, { "name": "voice", "type": "string", "label": "Voice", "default": "Alicia" }, { "name": "stability", "type": "number", "label": "Stability", "min": 0, "max": 1, "default": 0.5 }, { "name": "similarity_boost", "type": "number", "label": "Voice similarity", "min": 0, "max": 1, "default": 0.75 } ] }, { "provider": "openrouter", "params": [ { "name": "prompt", "type": "text", "label": "Text", "required": true, "maxLength": 5000 }, { "name": "voice", "type": "string", "label": "Voice", "default": "george", "options": [ "george", "sarah", "adam", "alice", "bella", "bill", "brian", "callum", "charlie", "chris", "daniel", "eric", "harry", "jessica", "laura", "liam", "lily", "matilda", "river", "roger", "will" ] } ] } ] ``` --- Source: https://01router.com/zh/docs/models/elevenlabs-tts-v4-turbo # ElevenLabs Eleven v4 Turbo API ElevenLabs Eleven v4 Turbo: expressive multilingual speech with audio tags, voice selection and delivery controls. `POST /api/v1/generations` 需要 Bearer API Key ## 输入参数 | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | model | string | yes | 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。 | options: [ "elevenlabs-tts-v4-turbo" ] | | input | object | yes | 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。 | | | provider | string | no | 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。 | | | project | string | no | 可选项目 ID，使用该项目公开的模型目录和路由配置。 | | | callback_url | string | no | 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。 | | | input.prompt | string | yes | | maxLength: 5000 | | input.voice | string | no | | default: "Rachel" | | input.stability | number | no | | default: 0.5; min: 0; max: 1 | | input.similarity_boost | number | no | | default: 0.75; min: 0; max: 1 | | input.language_code | string | no | ISO 639-1, e.g. en or zh | | | input.seed | integer | no | | min: 0; max: 4294967295 | | input.output_format | enum | no | | default: "mp3_44100_128"; options: [ "mp3_22050_32", "mp3_44100_32", "mp3_44100_64", "mp3_44100_96", "mp3_44100_128", "mp3_44100_192", "pcm_8000", "pcm_16000", "pcm_22050", "pcm_24000", "pcm_44100", "pcm_48000", "ulaw_8000", "alaw_8000", "opus_48000_32", "opus_48000_64", "opus_48000_96", "opus_48000_128", "opus_48000_192" ] | | input.apply_text_normalization | enum | no | | default: "auto"; options: [ "auto", "on", "off" ] | ## 输出字段 | 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": "elevenlabs-tts-v4-turbo", "input": { "prompt": "A cinematic landscape at sunrise.", "voice": "Rachel", "stability": 0.5, "similarity_boost": 0.75, "output_format": "mp3_44100_128", "apply_text_normalization": "auto" } }' ``` ## 200 · application/json ```json { "id": "gen_example", "object": "generation", "model": "elevenlabs-tts-v4-turbo", "type": "audio", "provider": "fal", "status": "processing", "input": { "prompt": "A cinematic landscape at sunrise.", "voice": "Rachel", "stability": 0.5, "similarity_boost": 0.75, "output_format": "mp3_44100_128", "apply_text_normalization": "auto" }, "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§ion=create): 创建生成任务 - [GET /api/v1/generations/{id}](https://01router.com/docs/llms-full.txt?locale=zh§ion=poll): 获取结果 - [POST /api/v1/generations/{id}/cancel](https://01router.com/docs/llms-full.txt?locale=zh§ion=cancel): 取消任务 - [POST /api/v1/quote](https://01router.com/docs/llms-full.txt?locale=zh§ion=quote): 报价 - [GET /api/v1/models/{slug}](https://01router.com/docs/llms-full.txt?locale=zh§ion=model-detail): 查询单个模型 调用 /generations 和 /quote 时，将以下参数放入 input；调用 /images/generations 时放在顶层；对话参数放在 /chat/completions 顶层。 选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入，请将示例媒体地址替换为可访问的文件。 ### Provider parameter schemas ```json [ { "provider": "fal", "params": [ { "name": "prompt", "type": "text", "label": "Text", "required": true, "maxLength": 5000 }, { "name": "voice", "type": "string", "label": "Voice", "default": "Rachel" }, { "name": "stability", "type": "number", "label": "Stability", "min": 0, "max": 1, "default": 0.5 }, { "name": "similarity_boost", "type": "number", "label": "Voice similarity", "min": 0, "max": 1, "default": 0.75 }, { "name": "language_code", "type": "string", "label": "Language code", "description": "ISO 639-1, e.g. en or zh" }, { "name": "seed", "type": "integer", "label": "Seed", "min": 0, "max": 4294967295 }, { "name": "output_format", "type": "enum", "label": "Output format", "options": [ "mp3_22050_32", "mp3_44100_32", "mp3_44100_64", "mp3_44100_96", "mp3_44100_128", "mp3_44100_192", "pcm_8000", "pcm_16000", "pcm_22050", "pcm_24000", "pcm_44100", "pcm_48000", "ulaw_8000", "alaw_8000", "opus_48000_32", "opus_48000_64", "opus_48000_96", "opus_48000_128", "opus_48000_192" ], "default": "mp3_44100_128" }, { "name": "apply_text_normalization", "type": "enum", "label": "Text normalization", "options": [ "auto", "on", "off" ], "default": "auto" } ] }, { "provider": "wavespeed", "params": [ { "name": "prompt", "type": "text", "label": "Text", "required": true, "maxLength": 5000 }, { "name": "voice", "type": "string", "label": "Voice", "default": "Alicia" }, { "name": "stability", "type": "number", "label": "Stability", "min": 0, "max": 1, "default": 0.5 }, { "name": "similarity_boost", "type": "number", "label": "Voice similarity", "min": 0, "max": 1, "default": 0.75 } ] }, { "provider": "openrouter", "params": [ { "name": "prompt", "type": "text", "label": "Text", "required": true, "maxLength": 5000 }, { "name": "voice", "type": "string", "label": "Voice", "default": "george", "options": [ "george", "sarah", "adam", "alice", "bella", "bill", "brian", "callum", "charlie", "chris", "daniel", "eric", "harry", "jessica", "laura", "liam", "lily", "matilda", "river", "roger", "will" ] } ] } ] ``` ---