请输入
菜单

Gemini 图片生成(原生格式)

通过 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[] 是 用 parts[].text 提供图片描述;编辑时可同时提供图片内容块
generationConfig.responseModalities Body string[] 是 通常使用 ["TEXT", "IMAGE"];以模型支持为准
generationConfig.imageConfig Body object 否 图片配置,例如 aspectRatio、imageSize;可选值以模型为准

调用示例

curl -X POST 'https://ailink.nativex.com/v1beta/models/MODEL_ID:generateContent' \
  -H 'Authorization: Bearer sk-xxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "contents": [
    {
      "parts": [
        {
          "text": "画一只坐在窗边的橘猫,水彩风格。"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ]
  }
}'

响应

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

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "BASE64_IMAGE"
            }
          }
        ]
      }
    }
  ]
}
字段或结果 说明
candidates[].content.parts[] 可能同时包含 text 和 inlineData
inlineData.data Base64 图片数据,解码后保存

错误处理

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

最近修改: 2026-10-28