快速結論
- 支持 Chat Completions 接入,便于快速迁移现有 SDK。
- 支持流式输出与工具调用,适合 Agent 场景。
- 建议先收敛 system/messages 参数,再进入生产环境。
關鍵參數
- model | string | 必填 | gemini-3.5-flash-official | - | 模型标识,使用 ToAPIs 真值。
- messages | object[] | 必填 | - | - | 按时间顺序组织的对话消息。
- max_tokens | integer | 必填 | - | >=1 | 最大输出 token 数。
- stream | boolean | 選填 | false | - | 是否启用流式返回。
- tools | object[] | 選填 | - | - | 函数调用定义集合。
常見錯誤
- 400 invalid_request_error: 觸發=请求体字段缺失或类型错误。; 修正=校验 model/messages/max_tokens 参数。; 重試=修复参数后重试。
- 401 authentication_error: 觸發=API Key 缺失或无效。; 修正=检查 Authorization 头与密钥权限。; 重試=修复鉴权后重试。







