# 模型能力

https://omnimodel.me/docs/capabilities?lang=zh

每个模型在[模型目录](/catalog)里都标注了能力、状态、输入限制和价格。调用前先确认模型具备对应能力，否则请求会被拒绝。

## 能力与接口

| 能力 | 含义 | 可用接口 |
| --- | --- | --- |
| 文本（chat） | 对话与文本生成 | `/v1/chat/completions`、`/v1/responses`、`/anthropic/v1/messages`、`/v1beta/models/{模型}:generateContent` |
| 视觉理解（vision） | 在对话里理解图片 | 同文本接口，在消息里附图片 |
| 向量（embedding） | 生成文本向量 | `/v1/embeddings`、`/v1beta/models/{模型}:embedContent` |
| 图片（image） | 生成或编辑图片 | `/v1/images/generations`、`/v1/images/edits` |
| 语音（audio） | 语音转写 | `/v1/audio/transcriptions` |
| 语音合成（speech） | 文字转语音 | `/v1/audio/speech` |
| 视频（video） | 异步生成视频 | `/v1/modelhub/video/tasks`，用任务接口查询结果 |

向量、图片和语音接口会先检查模型能力，不具备时返回 `model.unavailable`。图片接口最多等待 120 秒，超时返回 202 和查询地址；视频一律按异步任务处理。

## 模型状态

| 状态 | 能否调用 | 说明 |
| --- | --- | --- |
| 可用 | 可以 | 正常服务 |
| 性能下降 | 可以 | 可能变慢或失败率升高，详情见[服务状态](/status) |
| 即将下架 | 可以 | 到下架日期后停止服务，请提前迁移 |
| 维护中 | 不可以 | 返回 `model.unavailable` |
| 已下架 | 不可以 | 返回 `model.unavailable`，不会恢复 |

模型进入即将下架时会发布公告，并邮件通知近 30 天内使用过该模型的用户。

## 不会被静默替换

你请求的模型 ID 就是实际调用的模型。平台不会在模型不可用时悄悄换成另一个模型，失败时直接返回错误，由你决定是否改用其他模型。

## 输入限制与参数说明

模型详情页的「输入限制」（如上下文长度、最大输出）和「参数说明」来自运营整理的资料，供选型参考。实际上限以模型本身为准，超出上限的请求可能被模型拒绝。

## 常见问题

### 即将下架的模型还能用多久？

可以一直调用到模型详情页上标注的下架日期，之后返回 model.unavailable，请在此之前迁移到其他模型。

### 模型维护中时会自动切换到别的模型吗？

不会。平台不会静默替换你请求的模型，维护期间调用直接返回 model.unavailable。

### 怎么判断模型支不支持图片输入？

看模型目录里的能力标签，带「视觉理解」的模型才能在对话中理解图片。