Gemini 生成

Gemini generateContent 兼容接口，异步文生图 / 带参考图生成（带参考图即图生图编辑）。

POST https://www.rightapi.ai/draw/v1beta/models/{model}:generateContent

鉴权头：Authorization: Bearer sk-xxxxx，也可用 Gemini 习惯的 x-goog-api-key: sk-xxxxx。
请求体带 "async": true 立即返回任务号；不传则等待结果（默认最多 60 秒，超时同样返回任务号）。
不支持 :streamGenerateContent（流式请求不进异步通道）。

请求示例

文生图

curl -sS -X POST "https://www.rightapi.ai/draw/v1beta/models/nano-banana-fast:generateContent" \
  -H "Authorization: Bearer sk-xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "async": true,
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "生成一张 16:9 的未来城市雨夜海报" }
        ]
      }
    ],
    "generationConfig": {
      "imageConfig": { "aspectRatio": "16:9", "imageSize": "2K" }
    }
  }'

带参考图

curl -sS -X POST "https://www.rightapi.ai/draw/v1beta/models/nano-banana-fast:generateContent" \
  -H "Authorization: Bearer sk-xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "async": true,
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "参考图片，把它改成高级杂志封面风格" },
          {
            "inline_data": {
              "mime_type": "image/png",
              "data": "{BASE64_IMAGE}"
            }
          }
        ]
      }
    ],
    "generationConfig": {
      "imageConfig": { "aspectRatio": "4:3", "imageSize": "2K" }
    }
  }'

响应

提交成功后立即返回 task_id，拿去任务查询轮询即可。

{
  "task_id": "task_0123456789abcdef0123456789abcdef",
  "status": "processing",
  "progress": 0,
  "message": "任务id: task_0123456789abcdef0123456789abcdef，任务还在处理中，请稍后到异步任务中查看结果"
}

参数

字段	必填	说明
{model}	是	路径里的模型名，如 nano-banana-fast
async	是	固定 true，立即返回任务号
contents[].parts[].text	是	提示词文本，多个 part 会拼接
contents[].parts[].inline_data	否	参考图，mime_type + base64 data；写多个 part 即多图参考
generationConfig.imageConfig.aspectRatio	否	比例 1:1、16:9、9:16、4:3（SDK 形态）
generationConfig.imageConfig.imageSize	否	仅 1K、2K、4K（SDK 形态）
generationConfig.responseFormat.image.aspectRatio	否	比例的 REST 形态写法，与上面的 SDK 形态等价（imageSize 同理）