Gemini OpenAI协议API

请求协议

Http

Header

参数名	值
Authorization	Bearer {YOUR AK}
Content-Type	application/json

请求url

https://genaiapi.cloudsway.net/v1/ai/{YOUR ENDPOINT}/google/chat/completions

请求Body

Google 模型 Chat Completions API 支持参数

基础参数

参数	支持情况	说明
messages	✅ 支持	支持以下消息类型： - 系统消息 - 用户消息（支持text和image_url类型，image_url支持Cloud Storage URI或base64编码） - 助手消息 - 工具消息 - 函数消息（已弃用，但保持兼容）
model	✅ 支持	模型名称
max_tokens/max_completion_tokens	✅ 支持	响应最大token数
temperature	✅ 支持	采样温度
top_p	✅ 支持	核采样参数
n	✅ 支持	生成结果数量
stream	✅ 支持	流式输出
stop	✅ 支持	停止序列
presence_penalty	✅ 支持	存在惩罚
frequency_penalty	✅ 支持	频率惩罚
seed	✅ 支持	对应Gemini的GenerationConfig.seed

多模态输入

参数	支持情况	说明
input_audio	✅ 支持	支持URI或blob格式，所有有效MIME类型
image_url	✅ 支持	支持URI或blob格式，detail参数全请求统一

工具和函数

参数	支持情况	说明
tools	✅ 支持	工具定义
tool_choice	✅ 支持	选项：none, auto, required(ANY模式), validated(VALIDATED模式)
functions	⚠️ 已弃用	保持兼容
function_call	⚠️ 已弃用	保持兼容

Gemini特有参数

{
  "extra_body": {
    "google": {
      "safety_settings": "安全设置",
      "cached_content": "缓存内容",
      "thinking_config": "思考配置"
    }
  },
  "extra_part": {
    "google": {
      "thought": "显式标记思考内容"
    }
  }
}

请求demo

curl --location 'https://genaiapi.cloudsway.net/v1/ai/{YOUR ENDPOINT}/google/chat/completions' \
--header 'Authorization: Bearer {YOUR AK}' \
--header 'Content-Type: application/json' \
--data '{
    "temperature": 1,
    "model": "gemini-2.5-flash",
    "messages": [
        {
            "role": "user",
            "content": "hi"

        }
    ],
    "stream": false
}'