原生 Gemini 格式

Gemini 文字聊天

使用 Gemini 原生格式进行文字对话。

端点

POST https://llm.inhabbit.com/v1beta/models/{model}:generateContent

支持流式请求：

POST https://llm.inhabbit.com/v1beta/models/{model}:streamGenerateContent?alt=sse

路径参数

参数	类型	必需	说明
model	string	是	模型标识，例如 `gemini-2.5-pro`

请求体（application/json）

参数	类型	必需	说明
contents	array<object>	否	消息内容数组
generationConfig	object	否	生成配置
safetySettings	array<object>	否	安全过滤设置
tools	array<object>	否	可用工具列表
systemInstruction	object	否	系统级指令

响应（200 OK）

{
  "candidates": [
    {
      "content": {
        "role": "string",
        "parts": [{}]
      },
      "finishReason": "string",
      "safetyRatings": [{}]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 0,
    "candidatesTokenCount": 0,
    "totalTokenCount": 0
  }
}

示例

curl -X POST "https://llm.inhabbit.com/v1beta/models/gemini-2.5-pro:generateContent" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [{"text": "你好，介绍一下你自己。"}]
      }
    ]
  }'

Gemini 媒体识别

支持图像、PDF、音频、视频的识别请求。

注意： 仅支持通过 inlineData 以 base64 方式上传图像、PDF、音频、视频，不支持 fileData.fileUri 或 File API。

端点

POST https://llm.inhabbit.com/v1beta/models/{model}:generateContent

请求体（application/json）

参数	类型	必需	说明
model	string	是	模型名称
contents	array<object>	否	内容数组（含 inlineData）
generationConfig	object	否	生成配置
safetySettings	array<object>	否	安全设置
tools	array<object>	否	工具数组
systemInstruction	object	否	系统指令

示例

curl -X POST "https://llm.inhabbit.com/v1beta/models/gemini-2.5-flash:generateContent" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/jpeg",
              "data": "BASE64_ENCODED_IMAGE"
            }
          },
          {"text": "请描述这张图片的内容。"}
        ]
      }
    ]
  }'

原生 Gemini 格式

本页目录