Gemini GenerateContent

Gemini 兼容接口将模型名称放在 URL 路径中。

POSThttps://www.hoofox.com/v1beta/models/{model}:generateContent

最小请求

curl "https://www.hoofox.com/v1beta/models/gemini-3-flash:generateContent" \
  -H "Authorization: Bearer $HOOFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [{"text": "你好，请用一句话回复"}]
      }
    ]
  }'

请求结构

字段	说明
contents	对话内容数组
role	user 或 model
parts	文本或媒体内容
generationConfig	温度、最大输出 Token 等生成参数
systemInstruction	系统级说明
tools	可供模型调用的工具

流式请求

将动作改为 streamGenerateContent 并添加 alt=sse：

/v1beta/models/{model}:streamGenerateContent?alt=sse

模型名称位于 URL 中

请直接从模型广场复制模型标识，并替换 {model}。不要保留大括号。