1. 图片生成（Images）
章鱼哥AI接口文档
  • 图片生成（Images）
    • 香蕉（gemini原生格式）
      POST
    • 香蕉（异步）
      POST
    • image2（流式）
      POST
    • gpt-image-2（异步）
      POST
    • 任务查询
      GET
  • 视频生成（Videos）
    • sora创建
      POST
    • Omni创建
      POST
    • veo创建
      POST
    • Veo （延长至15s）
      POST
    • 任务查询
      GET
  • 失效接口
    • sora视频接口
      POST
    • nano banana接口Gemini 原生格式
      POST
    • veo（直出15s）
      POST
  1. 图片生成（Images）

香蕉（gemini原生格式）

开发中
POST
https://otuapi.com/v1beta/models/{model}:generateContent

图片生成接口文档#

接口地址#

POST /v1beta/models/{model}:generateContent

功能说明#

支持文生图和图生图两种模式，同步返回。

支持的模型#

model说明
gemini-3-pro-image-preview专业版，画质强、一致性高
gemini-3.1-flash-image-preview快速版，响应更快，支持更多宽高比和分辨率选项
模型名填写在 URL 路径中，例如：
POST /v1beta/models/gemini-3.1-flash-image-preview:generateContent

请求头#

参数名必填说明
Authorization是Bearer YOUR_API_KEY
Content-Type是application/json

请求参数#

参数名类型必填说明
contentsarray是对话内容列表
contents[].rolestring是固定填 "user"
contents[].partsarray是内容部件数组
contents[].parts[].textstring是图片描述提示词
contents[].parts[].inlineDataobject否参考图片（Base64 方式），图生图时二选一
contents[].parts[].inlineData.mimeTypestring是图片格式，如 image/jpeg、image/png、image/webp
contents[].parts[].inlineData.datastring是图片的纯 Base64 字符串（不含 data:image/jpeg;base64, 前缀）
contents[].parts[].fileDataobject否参考图片（URL 方式），图生图时二选一
contents[].parts[].fileData.mimeTypestring否图片格式，如 image/jpeg、image/png、image/webp，可省略
contents[].parts[].fileData.fileUristring是图片的 HTTP/HTTPS 直链地址
generationConfigobject否生成配置
generationConfig.responseModalitiesarray否返回内容模态，固定传 ["IMAGE"]
generationConfig.imageConfigobject否图片生成配置
generationConfig.imageConfig.aspectRatiostring否输出图片宽高比，见下方支持列表
generationConfig.imageConfig.imageSizestring否输出分辨率：1K / 2K / 4K，仅 gemini-3.1-flash-image-preview 支持

支持的宽高比（aspectRatio）#

两个模型均支持：
1:1  2:3  3:2  3:4  4:3  4:5  5:4  9:16  16:9  21:9
仅 gemini-3.1-flash-image-preview 额外支持：
1:4  4:1  1:8  8:1

请求示例#

文生图#

图生图（单张参考图，Base64 方式）#

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "inlineData": {
            "mimeType": "image/jpeg",
            "data": "/9j/4AAQSkZJRg..."
          }
        },
        {
          "text": "Change the background to a peaceful sunny beach, keep the main subject unchanged"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": ["IMAGE"],
    "imageConfig": {
      "aspectRatio": "1:1"
    }
  }
}

图生图（单张参考图，URL 方式）#

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "fileData": {
            "mimeType": "image/jpeg",
            "fileUri": "https://example.com/your-image.jpg"
          }
        },
        {
          "text": "Change the background to a peaceful sunny beach, keep the main subject unchanged"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": ["IMAGE"],
    "imageConfig": {
      "aspectRatio": "1:1"
    }
  }
}

图生图（多张参考图）#

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "inlineData": {
            "mimeType": "image/jpeg",
            "data": "/9j/4AAQSkZJRg..."
          }
        },
        {
          "inlineData": {
            "mimeType": "image/png",
            "data": "iVBORw0KGgoAAAANSU..."
          }
        },
        {
          "text": "Blend the style of both images and generate a new landscape"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": ["IMAGE"]
  }
}

响应参数#

参数名类型说明
creatednumber生成时间戳（Unix 秒）
modelstring使用的模型名
candidatesarray结果列表
candidates[].content.parts[].image_url.urlstring生成的图片 URL
candidates[].finishReasonstring完成原因，正常为 "STOP"
dataarray原始数据，data[0].url 可直接取图片地址

响应示例#

{
  "created": 1780125491,
  "model": "gemini-3.1-flash-image-preview",
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "image_url": {
              "url": "https://cdn.example.com/output/xxx.png"
            }
          }
        ]
      },
      "finishReason": "STOP"
    }
  ],
  "data": [
    {
      "url": "https://cdn.example.com/output/xxx.png"
    }
  ]
}

提取图片地址#

图片 URL 有两个等价的取法：

注意事项#

1.
同步接口：图片生成完毕后一次性返回，建议客户端超时时间设置为 120 秒以上
2.
text 为必填：无论文生图还是图生图，parts 中必须包含 text 字段
3.
参考图片格式：支持 image/jpeg、image/png、image/webp，单张建议不超过 5MB
4.
传图两种方式：inlineData（Base64）和 fileData（URL 直链）均可，同一请求中可混用；fileData 使用 fileUri 字段传入图片 HTTP/HTTPS 地址
5.
参考图片数量：最多 14 张
6.
imageSize 字段：仅 gemini-3.1-flash-image-preview 支持，gemini-3-pro-image-preview 请勿传此参数
7.
图片 URL 有效期：返回的图片链接请及时下载或转存，不建议长期依赖直链

请求参数

Path 参数

Header 参数

Body 参数application/json必填

示例
{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "fileData": {
                        "mimeType": "image/jpeg",
                        "fileUri": "https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png"
                    }
                },
                {
                    "text": "做个广告"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "IMAGE"
        ],
        "imageConfig": {
            "aspectRatio": "21:9"
        }
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://otuapi.com/v1beta/models/:generateContent' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "fileData": {
                        "mimeType": "image/jpeg",
                        "fileUri": "https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png"
                    }
                },
                {
                    "text": "做个广告"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "IMAGE"
        ],
        "imageConfig": {
            "aspectRatio": "21:9"
        }
    }
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "created": 1780125491,
    "model": "gemini-3.1-flash-image-preview",
    "candidates": [
        {
            "content": {
                "parts": [
                    {
                        "image_url": {
                            "url": "https://cdn.example.com/output/xxx.png"
                        }
                    }
                ]
            },
            "finishReason": "STOP"
        }
    ],
    "data": [
        {
            "url": "https://cdn.example.com/output/xxx.png"
        }
    ]
}
修改于 2026-05-31 09:59:44
下一页
香蕉（异步）
Built with