Gemini - Codeflare

文本生成

选择支持 gemini 的平台模型。使用网关根地址、x-goog-api-key 和 Gemini 的 contents 格式，不要把 OpenAI SDK 的 /v1 Base URL 直接拼接到 /v1beta 前。

cURL

curl "https://YOUR-REGION.example/v1beta/models/MODEL_ID:generateContent" \
  -H "x-goog-api-key: $CODEFLARE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"contents":[{"role":"user","parts":[{"text":"Hello"}]}],"generationConfig":{"maxOutputTokens":256}}'

MODEL_ID 应替换为平台模型 ID；包含特殊字符时需按 URL 路径段编码。响应采用 Gemini 原生候选格式。

流式输出与计数

使用 POST /v1beta/models/MODEL_ID:streamGenerateContent?alt=sse 读取流式结果；模型路由需要支持流式。POST /v1beta/models/MODEL_ID:countTokens 的计数请求需要渠道能力，不收生成费用。网关也支持 /v1/models/MODEL_ID:ACTION 路径。GET /v1beta/models 返回 Gemini 风格目录；GET /v1/models 保留 OpenAI 风格。

能力边界

多模态输入、推理、工具和其他生成配置受所选模型与上游能力限制。此生成入口不等于支持供应商的所有媒体服务。不要自动重试不确定执行的请求。