Gemini 内容生成

POST /v1beta/models/{model}:generateContent

身份验证

将 NeonAPI 密钥放入 Authorization: Bearer YOUR_API_KEY 请求头，在可信应用环境中保管密钥。

可用性与兼容性

调用前核对模型的协议、权限、报价和支持参数。不支持的参数可能被拒绝。示例中的密钥与模型均为占位符。

路径与查询参数

字段	In	类型	必填
`model`	`path`	`string`	是

请求参数

application/json

字段	类型	必填	约束	含义
`contents`	`object[]`	是	—	包含 parts 的 Gemini 内容轮次。
`generationConfig`	`object`	是	—	Gemini 生成与模态设置。

完整字段定义、嵌套对象和引用结构可在下载的规范中查看。

请求示例

export NEON_API_KEY="YOUR_API_KEY"
curl https://neon-api.com/v1beta/models/YOUR_MODEL_ID:generateContent \
  -H "Authorization: Bearer $NEON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Draw a constellation"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ]
  }
}'

响应说明

实际字段因模型与协议而异。下方结构描述文档中的成功响应；流式请求使用对应协议的事件。

状态码	含义
200	请求成功

响应结构

字段	类型	必填	约束	含义
`candidates`	`object[]`	否	—	—
`usageMetadata`	`object`	否	—	—

下载用户侧 OpenAPI 规范

另见常见错误与流式响应和异步任务。