> ## Documentation Index
> Fetch the complete documentation index at: https://omnirelay.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 模型列表

> 查看当前空间启用的模型。

`GET /v1/models` 返回 Key 所属工作区可调用的启用模型，按 Key 模型白名单和有效
渠道/运行时筛选。请以自己的响应选择模型。停用模型会从列表消失，新请求返回
`404 model_unavailable`；Key 仅允许其他模型时返回 `403 model_not_allowed`。

```bash cURL theme={null}
curl https://api.omnirelay.ai/v1/models \
  -H "Authorization: Bearer $OMNIRELAY_API_KEY"
```

```python Python theme={null}
for model in client.models.list():
    print(model.id, model.owned_by)
```

```javascript JavaScript theme={null}
for await (const model of client.models.list()) {
  console.log(model.id, model.owned_by);
}
```

以下为已开通工作空间响应的部分字段示例；不是所有账户的固定列表。

```json theme={null}
{
  "object": "list",
  "data": [
    {
      "id": "gpt-5.4-mini",
      "object": "model",
      "owned_by": "OpenAI",
      "mode": "live",
      "context_length": 400000,
      "capabilities": {
        "text": true,
        "stream": true,
        "system": true,
        "developer": false,
        "reasoning_content": false,
        "tools": true,
        "vision": false,
        "structured_output": true,
        "json_object": true,
        "json_schema": true,
        "responses": true,
        "embeddings": false
      },
      "limits": {
        "output_tokens": 256,
        "default_output_tokens": 64
      },
      "reasoning_efforts": [
        "none"
      ],
      "default_reasoning_effort": "none"
    }
  ]
}
```

## 字段说明

每个条目都保留 OpenAI 的标准字段（`id`、`object`、`owned_by`），现有客户端不受影响。其余字段说明模型支持什么、你需要付多少：

| 字段 | 含义 |
| - | - |
| `name` | 显示名称。 |
| `context_length` | 上下文窗口大小，单位为 token。 |
| `mode` | `live` 表示调用真实模型服务方。 |
| `capabilities` | 该模型在本网关支持的能力。请求用到标记为 `false` 的能力时会被明确拒绝，而不是被静默忽略。 |
| `pricing` | 输入/输出费率，单位见 `pricing_unit`。费率为客户基价，折扣在整次请求费用取整后应用。 |
| `list_pricing` | 折扣前的原价。 |
| `discount` | 你的工作区在该模型上相对原价减免的比例：`0.2` 表示减免 20%（即八折）。 |
| `limits` | 网关限制，真实模型包括 `output_tokens` 最大值和 `default_output_tokens` 默认值，可能小于模型厂家上限。 |
| `reservation` | 当前客户价格下最低、默认和最大输出对应的费用预留，单位微美元，不是最终扣费。`minimum_customer_hold` 与 `default_customer_hold` 对应最短请求输出 1 Token 和默认输出；`maximum_customer_hold` 对应输入达到硬上限且输出最大。提示词越长预留越多，约每字节 1 个输入 Token。 |
| `reasoning_efforts`、`default_reasoning_effort` | 允许的推理强度，以及省略时显式注入的强度。 |
| `context_verified`、`context_basis` | 上下文合同是否核验；`input-plus-output` 表示物理联合上下文。 |
| `max_input_tokens` | 核验输入硬上限，不是本次提示词的实测 Token 数。 |
| `token_budget_mode` | `provider-context-ceiling` 以模型独立的输入硬上限封顶输入预留。 |
| `input_bound_basis` | `provider-enforced-input-ceiling`：输入预留为估算值，即请求体字节数的三分之一加 4,096 Token 固定开销，不超过模型服务方强制的输入硬上限。资金足够时，结算最多可达预留的两倍。 |
| `context_fit_validation` | `provider`：由模型服务方判断能否放入上下文，不是本地准确分词。 |
| `reservation_basis` | `independent-input-output-ceilings`：分别预留输入和请求输出上界，不扩大物理上下文。 |
| `price_version`、`cache_pricing`、`input_tiers` | 冻结价格标识及客户缓存/阶梯基价；不公开内部成本或路由。 |
| `reasoning_price`、`request_fee_microusd` | 客户推理输出每百万 Token 基价，以及微美元固定请求费；GPT 5.4 Mini 无固定请求费。 |
| `customer_discount_bps`、`customer_discount_source` | 真实价格比例，以基点表示（`10000` 为原价），来自工作区或模型；模型覆盖不叠加。 |

价格为整数，单位是每百万 token 的微美元：`2500000` 即每百万 token 2.50 美元。

## 当前接入的真实文本模型

截至 2026-10-11，已核验生产目录有 19 个真实文本调用 ID，全部支持 SSE：`claude-fable-5`、`claude-fable-5-1`、`claude-opus-4-8`、`claude-opus-5`、`claude-sonnet-5`、`claude-sonnet-5-5`、`deepseek-v4-pro`、`gemini-3.1-pro-preview`、`gemini-3.6-flash`、`glm-5.3`、`gpt-5.4-mini`、`gpt-5.6-luna`、`gpt-5.6-sol`、`gpt-5.6-terra`、`gpt-6-astra`、`gpt-6-luna`、`gpt-6-sol`、`gpt-6.1-sol` 和 `kimi-k3`。DeepSeek V4 Pro 和 GLM 5.3 可返回推理内容。这是接入快照，不表示所有工作空间均开放；最终以自己的 Key 返回为准。本次新增 `gemini-3.1-pro-preview`、`gemini-3.6-flash`、`kimi-k3`，`gpt-5.6-luna` 恢复可用。DeepSeek V3.2 系列（`deepseek-v3.2-exp`、`deepseek-v3.2-exp-thinking`、`deepseek-v3.2-thinking`）、Claude Haiku 4.5、Claude Opus 4.7 和 Claude Sonnet 4.6 已下线，不再可调用。

多数已接入文本模型最多输出 128,000 Token、默认 32,000（Gemini 3.1 Pro Preview 和 Gemini 3.6 Flash 最多 65,536）；DeepSeek V4 Pro、GLM 5.3 和 Kimi K3 默认且最多 4,096；GPT 5.4 Mini 默认 64、最多 256。只有 `capabilities.stream: true` 才能流式调用；只有 `capabilities.reasoning_content: true` 才可能返回推理文本。`reasoning_efforts` 为空时不要传推理强度。GPT 5.4 Mini 另支持函数工具、JSON object/schema 和 Responses；读取 `capabilities.tools`、`json_object`、`json_schema`、`responses` 确认权限。指定函数名选择、视觉与采样仍未开放，需按 `capabilities.named_tool_choice` 判断指定函数选择是否可用。

公开目录的「待接通」条目不能作为可调用模型；图像和视频尚无公开生成端点，计费未核实的模型也未开放。

### GPT 5.4 Mini 示例

显式启用的工作区可以包含 `gpt-5.4-mini`、`mode: live`，不代表所有账户或目录模型
均可调用。物理上下文为 400,000 Token；服务输出默认 64、最大 256 Token。
支持文本、`system` 消息和 SSE；仅允许推理强度 `none`，省略时显式注入。
支持函数工具、JSON object/schema 及 Responses；严格工具、图片和采样参数仍被拒绝。
`capabilities` 包含 `system`、`developer`、`reasoning_content`，便于客户端检查差异。

已启用模型的部分字段示例，按无客户折扣展示：

```json theme={null}
{
  "id": "gpt-5.4-mini", "mode": "live", "context_length": 400000,
  "pricing": { "input": 750000, "output": 4500000 },
  "cache_pricing": { "read": 75000, "write": 0, "unit": "micro-USD / 1M tokens" },
  "discount": 0, "customer_discount_bps": 10000,
  "limits": { "output_tokens": 256, "default_output_tokens": 64 },
  "reasoning_efforts": ["none"], "default_reasoning_effort": "none",
  "context_verified": true, "context_basis": "input-plus-output", "max_input_tokens": 400000,
  "token_budget_mode": "provider-context-ceiling",
  "input_bound_basis": "provider-enforced-input-ceiling",
  "context_fit_validation": "provider",
  "reservation_basis": "independent-input-output-ceilings"
}
```

最高预留金额随工作区价格设置变化，不是实际费用，
也不表示可用上下文为 400,256 Token。模型服务方仍可能拒绝无法放入的提示词。
详见[用量与计费](https://omnirelay.ai/docs/cn/general/usage-billing.md)。

完整 schema 见 [列出模型](https://omnirelay.ai/docs/cn/api-reference/models/list-models.md)。

## 图片模型

工作区可以调用时，图片模型（`gpt-image-2`、`gpt-image-2.5`）也会出现在列表中。它们按张计费而非按 token 计费，条目字段与文本模型不同：

```json theme={null}
{
  "id": "gpt-image-2",
  "object": "model",
  "owned_by": "OpenAI",
  "name": "GPT Image 2",
  "mode": "live",
  "capabilities": { "image_generation": true, "image_edits": true },
  "pricing_unit": "microUSD-per-image",
  "pricing": { "per_image": { "1K": 134000, "2K": 201000, "4K": 268000 } },
  "list_pricing": { "per_image": { "1K": 134000, "2K": 201000, "4K": 268000 } },
  "discount": 0,
  "max_images": 4,
  "size_tiers": { "1K": "longest side up to 1024 px", "2K": "longest side up to 2048 px; also size omitted or auto", "4K": "longest side up to 4096 px" },
  "price_version": "…"
}
```

`pricing.per_image` 是折扣后的每张价格（micro-USD），`list_pricing.per_image` 是折扣前价格；图片模型没有 `context_length`、`limits` 或 token 价格。调用方式见[图片生成与编辑](https://omnirelay.ai/docs/cn/images/image-generation.md)。

## 视频模型

视频模型（`doubao-seedance-2-0-260128`）在你的工作区可调用时出现在列表中。它们按每百万输出 tokens 计价，通过[视频任务接口](https://omnirelay.ai/docs/cn/videos/video-generation.md)调用，因此条目与文本模型不同：

```json theme={null}
{
  "id": "doubao-seedance-2-0-260128",
  "object": "model",
  "type": "video",
  "owned_by": "ByteDance",
  "name": "Seedance 2.0",
  "mode": "live",
  "capabilities": { "video_generation": true, "text_to_video": true, "image_to_video": false },
  "pricing_unit": "microUSD-per-million-output-tokens",
  "pricing": { "output": 25000000 },
  "list_pricing": { "output": 25000000 },
  "discount": 0,
  "resolutions": ["480p", "720p"],
  "ratios": ["16:9", "4:3", "1:1", "3:4", "9:16", "21:9", "adaptive"],
  "duration": { "min": 4, "max": 10, "default": 5 },
  "token_rule": "output tokens = width x height x (24 x duration + 1) / 1024",
  "price_version": "…"
}
```

`pricing.output` 是折扣后每百万输出 tokens 的价格（micro-USD），`list_pricing.output` 是折扣前价格。没有 `context_length` 和输入价格。

## 开通前浏览模型

登录后即可在**控制台 → 模型广场**查看平台支持的模型与价格；工作空间开通核验完成前，所有模型均为不可用且没有调用入口。浏览模型不代表获得 API 调用权限。点击信息图标仅弹出详情，页面 URL 不变；**真实模型服务**状态模块仅位于总览。

浏览目录不授予调用权限。`GET /v1/models` 仍是该 Key 实际可调用的模型列表，受工作空间开通、运行时/渠道及 Key 限制影响。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.