请输入
菜单

Gemini 文本对话

通过 generateContent 发送原生 Gemini 消息。

请求

项目 说明
方法 POST
路径 /v1beta/models/{model}:generateContent
网关地址 https://ailink.nativex.com
认证 Authorization: Bearer sk-xxxx,替换为你的 API Key
请求格式 application/json

示例中的 MODEL_ID 请替换为「模型广场」中支持本接口的模型名称。模型、参数支持范围与可用权限以当前账户为准。

参数说明

参数 位置 类型 必填 说明
model Path string 是 Gemini 模型名称
contents Body object[] 是 消息列表,每条含 role 与 parts;常用角色为 user、model
systemInstruction Body object 否 系统指令,使用 parts 提供内容
generationConfig Body object 否 生成设置,例如 temperature、topP、maxOutputTokens
safetySettings Body object[] 否 模型支持的安全设置
tools Body object[] 否 工具定义

调用示例

curl -X POST 'https://ailink.nativex.com/v1beta/models/MODEL_ID:generateContent' \
  -H 'Authorization: Bearer sk-xxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "请用一句话介绍自己。"
        }
      ]
    }
  ]
}'

响应

以下为便于阅读的简化结构示例,标识、链接、文本及用量均为示意值。

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "你好!有什么可以帮助你?"
          }
        ]
      },
      "finishReason": "STOP"
    }
  ]
}
字段或结果 说明
candidates[].content.parts[] 模型输出的内容块
candidates[].finishReason 结束原因
usageMetadata 用量元数据

错误处理

非成功响应时,先查看 HTTP 状态和错误正文。检查 API Key、模型名称、账户额度及参数;遇到限流时降低并发并稍后重试。

流式调用

路径改为 /v1beta/models/{model}:streamGenerateContent?alt=sse,请求体保持原生 Gemini 结构。curl 添加 -N,逐条解析 SSE 数据。

最近修改: 2026-10-28