Gemini 原生格式

接口地址

POST https://api.yomiapi.com/v1beta/models/{model}:generateContent

流式输出使用 :streamGenerateContent 动作并附加 alt=sse 查询参数:

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

鉴权方式

• 请求头: x-goog-api-key: YOUR_API_KEY,Google 原生风格。
• URL 参数: ?key=YOUR_API_KEY。
• 通用方式: Authorization: Bearer YOUR_API_KEY。

cURL 示例

curl https://api.yomiapi.com/v1beta/models/{模型id}:generateContent \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "用三点概括向量数据库的用途"}]
    }]
  }'

Python 示例

使用 Google 官方 google-genai SDK,将 base_url 指向平台即可:

pip install google-genai

from google import genai

client = genai.Client(
    api_key="YOUR_API_KEY",
    http_options={"base_url": "https://api.yomiapi.com"}
)

response = client.models.generate_content(
    model="模型广场在售的模型 id",
    contents="用三点概括向量数据库的用途"
)
print(response.text)

可用模型

与 OpenAI 兼容格式的取舍

• 选原生格式: 迁移已有 Google SDK 项目;需要 contents/parts 多模态结构，或 generationConfig、安全设置等 Gemini 专属请求字段时。
• 选 OpenAI 兼容: 希望与其他模型共用一套代码，通过 /v1/chat/completions 调用;文本、图像输入与 Function Calling 均已支持。