模型能力
每个模型在模型目录里都标注了能力、状态、输入限制和价格。调用前先确认模型具备对应能力，否则请求会被拒绝。
能力与接口
| 能力 | 含义 | 可用接口 |
|---|---|---|
| 文本（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 和查询地址；视频一律按异步任务处理。
模型状态
| 状态 | 能否调用 | 说明 |
|---|---|---|
| 可用 | 可以 | 正常服务 |
| 性能下降 | 可以 | 可能变慢或失败率升高，详情见服务状态 |
| 即将下架 | 可以 | 到下架日期后停止服务，请提前迁移 |
| 维护中 | 不可以 | 返回 model.unavailable |
| 已下架 | 不可以 | 返回 model.unavailable，不会恢复 |
模型进入即将下架时会发布公告，并邮件通知近 30 天内使用过该模型的用户。
不会被静默替换
你请求的模型 ID 就是实际调用的模型。平台不会在模型不可用时悄悄换成另一个模型，失败时直接返回错误，由你决定是否改用其他模型。
输入限制与参数说明
模型详情页的「输入限制」（如上下文长度、最大输出）和「参数说明」来自运营整理的资料，供选型参考。实际上限以模型本身为准，超出上限的请求可能被模型拒绝。
常见问题
- 即将下架的模型还能用多久？
- 可以一直调用到模型详情页上标注的下架日期，之后返回 model.unavailable，请在此之前迁移到其他模型。
- 模型维护中时会自动切换到别的模型吗？
- 不会。平台不会静默替换你请求的模型，维护期间调用直接返回 model.unavailable。
- 怎么判断模型支不支持图片输入？
- 看模型目录里的能力标签，带「视觉理解」的模型才能在对话中理解图片。