Models

模型 ID 是调用 RouteAPI 时最重要的参数之一。请求中的 model 必须是当前账户可用的模型。

Endpoint

GET /v1/models

示例：

curl https://www.routeapi.ai/v1/models \
  -H "Authorization: Bearer $ROUTEAPI_KEY"

模型 ID

调用接口时使用模型 ID，而不是控制台中的展示名称。

{
  "model": "gpt-4o"
}

如果 RouteAPI 配置了模型映射，请以控制台或模型列表接口返回的 ID 为准。

建议展示的模型字段

字段	说明
id	调用时使用的模型 ID
name	展示名称
context_length	最大上下文长度
input_price	输入价格
output_price	输出价格
supports_stream	是否支持流式输出
supports_tools	是否支持工具调用
supports_vision	是否支持图像输入
supports_json_schema	是否支持结构化输出

模型不可用排查

当请求返回模型不可用、无权限或服务侧错误时，按以下顺序排查：

1. 模型 ID 是否拼写正确。
2. 请求参数是否包含当前模型不支持的可选参数。

最佳实践

• 为生产应用固定模型 ID，不要依赖展示名称。
• 为关键业务准备可替代的模型方案。
• 对需要工具调用或结构化输出的场景，提前确认模型能力。
• 在上线前使用同一个 Token 做模型列表和一次真实调用验证。