Docs

模型 API

Gemini 原生内容生成

使用 generateContent 和 streamGenerateContent，正确构造 contents、parts 与 generationConfig。

更新于

POST/v1beta/models/{model_action}

生成内容

Gemini 原生接口路径为 POST /v1beta/models/{model}:generateContent。contents 是对话数组，parts 承载文本或目标模型支持的多模态内容。路径中的模型必须使用当前目录中的可用 ID。

cURL
curl --fail-with-body "https://api.token4ai.cloud/v1beta/models/YOUR_MODEL_ID:generateContent" \
  -H "x-goog-api-key: $TOKEN4AI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"contents":[{"role":"user","parts":[{"text":"Explain vector search."}]}],"generationConfig":{"maxOutputTokens":256}}'

读取候选结果

结果通常位于 candidates[].content.parts[].text。检查 finishReason 和 usageMetadata；安全过滤或无可用候选时可能没有普通文本。应用需要明确展示“未生成结果”，不要把空数组当作网络故障无限重试。

原生流式接口

流式路径使用 :streamGenerateContent?alt=sse。该接口名称决定流式模式，不需要把 Chat Completions 的 messages 直接粘贴进请求。SDK 集成前，先用原生 REST 请求验证模型、凭证与路由，再按 SDK 的自定义端点配置使用根地址。

cURL
curl -N --fail-with-body "https://api.token4ai.cloud/v1beta/models/YOUR_MODEL_ID:streamGenerateContent?alt=sse" \
  -H "x-goog-api-key: $TOKEN4AI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"contents":[{"role":"user","parts":[{"text":"Hello"}]}]}'

继续阅读

模型目录与能力选择视觉输入与图像生成流式响应与连接管理