why01 API 文档

主题

Gemini (Google) 接入

调用 Gemini 模型同样推荐 OpenAI 兼容路径。

示例中的模型名仅为占位

本页代码示例里的 model 字段（如 gemini-2.5-pro）只是写法占位——Google 上游模型经常更新，实际能用哪些 Gemini 模型 + 当前型号名永远以 控制台模型 / 定价页 为准。

OpenAI 兼容（推荐） ​

python
from openai import OpenAI

client = OpenAI(
    base_url="https://s1.why01.top/v1",
    api_key="sk-你的key",
)

resp = client.chat.completions.create(
    model="gemini-2.5-pro",
    messages=[{"role": "user", "content": "用一句话介绍 Go 的 goroutine"}],
)
print(resp.choices[0].message.content)

curl：

bash
curl https://s1.why01.top/v1/chat/completions \
  -H "Authorization: Bearer sk-你的key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-pro",
    "messages": [{"role": "user", "content": "你好"}]
  }'

具体 Gemini 模型名以控制台 模型 / 定价页 为准。

Google 原生协议 ​

如果你已经在用 google-generativeai SDK，理论上可以指向本站作 endpoint。但 Google 原生协议的支持取决于上游渠道实现——建议优先 OpenAI 兼容路径，出问题再考虑切原生。

多模态（图片输入） ​

OpenAI 兼容路径下，传图按 OpenAI 标准的 image_url schema：

python
resp = client.chat.completions.create(
    model="gemini-2.5-pro",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "图里是什么？"},
            {"type": "image_url", "image_url": {
                "url": "https://example.com/cat.jpg"
            }}
        ]
    }],
)

具体哪些 Gemini 模型支持视觉、音频，以控制台 模型 / 定价页 标注为准。

长上下文优势 ​

Gemini 1.5 Pro 支持 1M+ token 上下文，调用时直接传长 messages 即可，不需要特殊参数。但注意：

  • 长 prompt 价格按 token 实际计费，1M token 输入会很贵
  • 上游处理超长 prompt 的延迟可能 > 30s，客户端 HTTP timeout 要相应调大

调用失败 ​

参考 错误码速查。