请求路径
https://api-models.com/v1beta/models/<MODEL_ID>:generateContent<MODEL_ID>使用控制台显示的完整模型 ID。:generateContent前是冒号，不是斜杠。- 请求体中不再填写另一个模型 ID。
curl 请求
curl "https://api-models.com/v1beta/models/<MODEL_ID>:generateContent" \
-H "x-goog-api-key: $API_MODELS_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [{
"parts": [
{"text": "解释什么是幂等请求。"}
]
}]
}'请求体
| 字段 | 用途 | 说明 |
|---|---|---|
contents | 消息列表 | 至少包含一条内容 |
parts | 内容片段 | 文本请求至少包含一个 part |
text | 文本输入 | 放在 part 中 |
generationConfig | 生成参数 | 可选，按模型支持情况使用 |
先测试最小请求
确认文本请求成功后，再加入历史消息、多模态输入和生成参数。部分新模型会忽略或拒绝旧的采样参数，新增参数前请查看对应模型说明。
迁移步骤
- 将服务域名改为
api-models.com。 - 保留
/v1beta/models/{model}:generateContent路径结构。 - 使用 API Models 的 API Key。
- 将路径中的模型 ID 改为控制台显示值。
- 发送最小文本请求，确认后再恢复其他参数。
错误排查
| 状态码 | 检查项 |
|---|---|
| 400 | contents、parts 和 JSON 格式 |
| 401 | x-goog-api-key 的值和请求头名称 |
| 403 | 令牌分组与模型权限 |
| 404 | 模型 ID、v1beta 和 :generateContent |
| 429 | 余额、额度和并发限制 |
| 5xx | 记录请求 ID、时间和脱敏请求体后联系支持 |