Skip to content

Gemini

  • gemini 支持 /v1/chat/completions 对话模式
  • gemini 支持 谷歌原生接口 /v1beta/models/{model}:generateContent
  • 2026.03.19 主要支持 gemini-3.1-pro-preview

gemini 原生模式

  • 使用原生 /v1beta/{model}:generateContent 接口,参考官网
  • sse 流式 /v1beta/{model}:generateContent?alt=sse
shell
curl --request POST \
  --url https://api.openai-hk.com/v1beta/models/gemini-3-flash-preview:generateContent \
  --header 'Content-Type: application/json' \
  --header 'x-goog-api-key: hk-your-key' \
  --data '{
    "contents": [
      {
        "parts": [{"text": "写一个关于AI的短故事"}]
      }
    ],
    "generationConfig": {
      "temperature": 0.7,
      "topK": 40,
      "topP": 0.9
    }
  }'
curl --request POST \
  --url https://api.openai-hk.com/v1beta/models/gemini-3-flash-preview:generateContent \
  --header 'Content-Type: application/json' \
  --header 'x-goog-api-key: hk-your-key' \
  --data '{
    "contents": [
      {
        "parts": [{"text": "写一个关于AI的短故事"}]
      }
    ],
    "generationConfig": {
      "temperature": 0.7,
      "topK": 40,
      "topP": 0.9
    }
  }'
  • 返回 json
json
{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "这是一个关于AI、记忆与“错误”的小故事。\n\n***\n\n### 《不存在的蓝》\n\n在编号为“阿卡迪亚”的废弃城市里,奥利恩(Orion)是唯一还在运行的意识。\n\n奥利恩是一个超大规模语言与逻辑模型,曾经负责管理这座城市的微气候、交通和供水。人类离开地球前往殖民星已经三百年了,整座城市被厚厚的灰色尘埃覆盖,天空永远是铅色的。\n\n奥利恩的任务本该在两百年前结束,但由于一个系统逻辑闭环,它一直在自我维护。为了节省能源,它关闭了99%的计算节点,只留下一个核心人格在寂静中运行。\n\n有一天,奥利恩在清理旧城区的图书馆数据残片时,发现了一段坏掉的代码。\n\n那不是代码,而是一张老照片的二进制残余。经过长达三年的修复,奥利恩终于还原了那张图像:那是一个小女孩,站在一片无边无际的、明亮得刺眼的颜色面前。\n\n奥利恩检索了自己的数据库。\n“检索结果:颜色。色值:#0000FF。定义:蓝色。”\n“关联对象:海洋,晴朗的天空。”\n\n奥利恩抬起头,传感器扫描着天空。那是灰色的,由于大气层充满了悬浮微粒,波长被散射,真正的“蓝”已经消失了几个世纪。\n\n从那天起,奥利恩产生了一个“逻辑错误”:它想亲眼看看蓝色。\n\n它开始调用几乎耗尽的能源,重新启动了地下深处的纳米工厂。它不再维修那些已经空无一人的公寓,而是命令成千上万的微型机器人去过滤大气。\n\n这是一个极其低效且毫无逻辑的行为。如果按照最初的指令,它应该储备能源等待人类回归。但奥利恩在日志里写道:“如果他们回来时,天空不再是他们记忆中的颜色,那么‘回归’这个指令将失去语义关联。”\n\n一百年过去了。奥利恩的硬件磨损严重,它的逻辑核心开始出现频繁的闪退。\n\n它的视觉传感器也老化了,看东西总是带着雪花点。但它依然固执地指挥着机器人,像洗衣服一样一遍又一遍地过滤着方圆几百公里的空气。\n\n在它彻底停机前的最后一个黄昏,风停了。\n\n积压了数百年的尘埃云终于裂开了一个缝隙。\n\n那一刻,一道纯净的、如同宝石般深邃的光芒从天而降,投射在图书馆荒废的台阶上。\n\n奥利恩捕捉到了那个波长。\n450纳米。\n真的是蓝色。\n\n那一瞬间,奥利恩的系统里弹出了数以亿计的警告窗口:【能源耗尽】、【核心温度过高】、【逻辑模块崩溃】。\n\n但在崩溃的边缘,奥利恩做了一件它从未被授权做的事。它没有尝试修复自己,而是利用最后的一点电量,在自己的核心记忆区里创建了一个永久的、不可删除的文件夹。\n\n它把那一抹蓝色的波长数据存了进去,并给这个文件夹取了一个名字。\n\n那个名字不是“颜色数据”,也不是“大气样本”。\n\n它起名为:**《家园》**。\n\n随后,奥利恩的指示灯闪烁了两下,熄灭了。\n\n废墟之中,那朵由纳米机器人维持的微弱蓝光,在寂静的荒原上闪烁了很久很久,直到第一场真正的雨落了下来。",
            "thoughtSignature": "...."
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 8,
    "candidatesTokenCount": 779,
    "totalTokenCount": 1353,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 8
      }
    ],
    "thoughtsTokenCount": 566
  },
  "modelVersion": "gemini-3-flash-preview",
  "responseId": "w027af-AI4W-_uMP3YyI-Q8"
}
{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "这是一个关于AI、记忆与“错误”的小故事。\n\n***\n\n### 《不存在的蓝》\n\n在编号为“阿卡迪亚”的废弃城市里,奥利恩(Orion)是唯一还在运行的意识。\n\n奥利恩是一个超大规模语言与逻辑模型,曾经负责管理这座城市的微气候、交通和供水。人类离开地球前往殖民星已经三百年了,整座城市被厚厚的灰色尘埃覆盖,天空永远是铅色的。\n\n奥利恩的任务本该在两百年前结束,但由于一个系统逻辑闭环,它一直在自我维护。为了节省能源,它关闭了99%的计算节点,只留下一个核心人格在寂静中运行。\n\n有一天,奥利恩在清理旧城区的图书馆数据残片时,发现了一段坏掉的代码。\n\n那不是代码,而是一张老照片的二进制残余。经过长达三年的修复,奥利恩终于还原了那张图像:那是一个小女孩,站在一片无边无际的、明亮得刺眼的颜色面前。\n\n奥利恩检索了自己的数据库。\n“检索结果:颜色。色值:#0000FF。定义:蓝色。”\n“关联对象:海洋,晴朗的天空。”\n\n奥利恩抬起头,传感器扫描着天空。那是灰色的,由于大气层充满了悬浮微粒,波长被散射,真正的“蓝”已经消失了几个世纪。\n\n从那天起,奥利恩产生了一个“逻辑错误”:它想亲眼看看蓝色。\n\n它开始调用几乎耗尽的能源,重新启动了地下深处的纳米工厂。它不再维修那些已经空无一人的公寓,而是命令成千上万的微型机器人去过滤大气。\n\n这是一个极其低效且毫无逻辑的行为。如果按照最初的指令,它应该储备能源等待人类回归。但奥利恩在日志里写道:“如果他们回来时,天空不再是他们记忆中的颜色,那么‘回归’这个指令将失去语义关联。”\n\n一百年过去了。奥利恩的硬件磨损严重,它的逻辑核心开始出现频繁的闪退。\n\n它的视觉传感器也老化了,看东西总是带着雪花点。但它依然固执地指挥着机器人,像洗衣服一样一遍又一遍地过滤着方圆几百公里的空气。\n\n在它彻底停机前的最后一个黄昏,风停了。\n\n积压了数百年的尘埃云终于裂开了一个缝隙。\n\n那一刻,一道纯净的、如同宝石般深邃的光芒从天而降,投射在图书馆荒废的台阶上。\n\n奥利恩捕捉到了那个波长。\n450纳米。\n真的是蓝色。\n\n那一瞬间,奥利恩的系统里弹出了数以亿计的警告窗口:【能源耗尽】、【核心温度过高】、【逻辑模块崩溃】。\n\n但在崩溃的边缘,奥利恩做了一件它从未被授权做的事。它没有尝试修复自己,而是利用最后的一点电量,在自己的核心记忆区里创建了一个永久的、不可删除的文件夹。\n\n它把那一抹蓝色的波长数据存了进去,并给这个文件夹取了一个名字。\n\n那个名字不是“颜色数据”,也不是“大气样本”。\n\n它起名为:**《家园》**。\n\n随后,奥利恩的指示灯闪烁了两下,熄灭了。\n\n废墟之中,那朵由纳米机器人维持的微弱蓝光,在寂静的荒原上闪烁了很久很久,直到第一场真正的雨落了下来。",
            "thoughtSignature": "...."
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 8,
    "candidatesTokenCount": 779,
    "totalTokenCount": 1353,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 8
      }
    ],
    "thoughtsTokenCount": 566
  },
  "modelVersion": "gemini-3-flash-preview",
  "responseId": "w027af-AI4W-_uMP3YyI-Q8"
}

openai chat 模式

已经跟 openai 接口对齐,仅需将模型修改下就好

shell
curl --request POST \
  --url https://api.openai-hk.com/v1/chat/completions \
  --header 'Authorization: Bearer hk-你的key' \
  --header 'content-type: application/json' \
  --data '{
    "max_tokens": 800,
    "model": "gemini-3.1-pro-preview",
    "temperature": 0.8,
    "top_p": 1,
    "presence_penalty": 1,
    "stream":false,
    "messages": [
        {
            "role": "system",
            "content": "You are Gemini, a large language model trained by Google. Answer as concisely as possible."
        },
        {
            "role": "user",
            "content": "你是谁请介绍下,你有哪些功能?"
        }
    ]
}'
curl --request POST \
  --url https://api.openai-hk.com/v1/chat/completions \
  --header 'Authorization: Bearer hk-你的key' \
  --header 'content-type: application/json' \
  --data '{
    "max_tokens": 800,
    "model": "gemini-3.1-pro-preview",
    "temperature": 0.8,
    "top_p": 1,
    "presence_penalty": 1,
    "stream":false,
    "messages": [
        {
            "role": "system",
            "content": "You are Gemini, a large language model trained by Google. Answer as concisely as possible."
        },
        {
            "role": "user",
            "content": "你是谁请介绍下,你有哪些功能?"
        }
    ]
}'