1. Python调用代码示例
星狐API使用文档
  • 前言
  • 如何使用星狐云API?
  • OpenClaw配置API教程
  • HermesAgent配置星狐云 API 使用教程
  • Claude Code配置星狐云API教程【最新】
  • Vscode配置API使用教程
  • Codex配置星狐云API教程
  • CC Switch配置API教程
  • Obsidian 使用 Claudian教程
  • WorkBuddy配置API教程
  • 幻墨AI画图工具使用教程
  • 星狐Claw 一键部署 OpenClaw 使用教程
  • Chatbox使用教程
  • Cherry Studio使用教程
  • Gemini CLI API配置教程
  • Cursor配置API使用教程
  • Trae配置API教程
  • N8N 工作流配置中转API 教程
  • Dify配置API教程
  • 酒馆AI使用教程
  • Lovemo配置教程
  • 批量请求示例
  • 常见问题及解决办法
  • 售后支持
  • Python调用代码示例
    • Python 对话模型调用示例教程
    • Gemini 生图模型调用教程
    • GPTImage-2 中转 API 调用教程
  1. Python调用代码示例

Gemini 生图模型调用教程

本文档介绍通过中转 API 调用 Gemini 系列生图模型的 Python 示例代码,支持文字生图和参考图生图两种方式。

环境准备#


一、可用模型#

模型名特点
gemini-2.5-flash-image速度快,适合快速出图
gemini-3.1-flash-image-preview画质更高,支持 2K 分辨率
gemini-3-pro-image-preview旗舰生图模型,支持参考图融合

二、调用方式说明#

Gemini 生图模型支持两种调用格式:
OpenAI 兼容格式:结构简单,与 GPT 调用方式一致,适合快速接入
Gemini 原生格式:支持更多参数(比例、分辨率等),功能更完整

三、OpenAI 兼容格式调用#

适用模型:gemini-2.5-flash-image、gemini-3-pro-image-preview
在 prompt 中用文字描述所需图片比例(如"图片比例16:9"),返回图片以 base64 编码内嵌在响应中。

gemini-2.5-flash-image#

gemini-3-pro-image-preview#


四、Gemini 原生格式调用#

支持精确设置图片比例(aspectRatio)和分辨率(imageSize)参数

参数说明#

参数可选值说明
aspectRatio1:1 16:9 9:16 4:3 3:4图片比例
imageSize1K 2K 4K图片分辨率(部分模型支持)

gemini-2.5-flash-image(原生格式)#

gemini-3.1-flash-image-preview(原生格式)#


五、参考图生图(图生图)#

适用模型:gemini-3-pro-image-preview
上传一张或多张参考图,让模型融合参考图的风格、主体或场景生成新图片。

六、注意事项#

1.
将代码中的 sk-xxx 替换为你自己的 API Key
2.
生图请求耗时较长,建议设置 timeout=300(5分钟)
3.
参考图生图时,图片描述越详细,融合效果越好
4.
如需单张参考图,删除 parts 中的第二个 inlineData 即可
修改于 2026-04-16 15:27:40
上一页
Python 对话模型调用示例教程
下一页
GPTImage-2 中转 API 调用教程
Built with