可用模型
准确的价格见主站 价格页。按 token 计费的模型,图越大、质量越高越贵;
gemini-nano-banana-2.1 和 gemini-3-pro-image 在价格页上会显示一张 1K、2K、4K 图大约多少钱。按次计费的模型每次调用一口价。
接口地址与鉴权
- Gemini 图像模型(推荐):
POST https://www.ruapi.ai/v1beta/models/模型ID:generateContent,谷歌原生格式 - Gemini 图像模型走 OpenAI 兼容格式:
POST https://www.ruapi.ai/v1/chat/completions,只限gemini-nano-banana-2.1和gemini-3.1-flash-image - GPT Image:
POST https://www.ruapi.ai/v1/images/generations(生成),POST https://www.ruapi.ai/v1/images/edits(编辑) - OpenAI SDK 的 Base URL:
https://www.ruapi.ai/v1(Google GenAI SDK 填https://www.ruapi.ai,见下文)。完整地址由 SDK 自己拼出来 - 鉴权:RuAPI 密钥
sk-...(在控制台「令牌管理」里创建)。谷歌原生格式可以放在请求头x-goog-api-key: sk-你的KEY里(Google GenAI SDK 就是这样发的),也可以用Authorization: Bearer sk-你的KEY;其他接口用Authorization: Bearer sk-你的KEY
下面的 curl 示例会把图片直接存到当前文件夹,换上自己的密钥就能用。macOS、Linux,以及 Windows 下的 Git Bash 或 WSL 都能运行;Windows 自带的命令行(cmd、PowerShell)请用 Python 示例。如果回复里没有图片,命令会把接口的完整回复打印出来,原因就写在里面。
方式一:Gemini Image —— 谷歌原生格式(推荐)
请求发到https://www.ruapi.ai/v1beta/models/模型ID:generateContent,格式和谷歌的 Gemini API 一样。图片放在单独的字段里返回:candidates[0].content.parts[].inlineData.data(base64),旁边可能还有一段文字。
文生图
图片参数
参数写在generationConfig.imageConfig 里(Python SDK 里是 types.ImageConfig):
图生图(编辑)
把原图作为inlineData(base64)和文字要求放在一起发。下面的示例可以直接运行:它会先把一张测试图下载成 photo.png;要改自己的图,换成自己的文件就行。
多轮连续修图
用 SDK 的话,client.chats 最方便:SDK 会自动把模型之前的回复(包括图片)带回去。
支持的输入图片格式
image/png、image/jpeg、image/webp、image/heic、image/heif。其他格式会被拒绝,报错 mime type is not supported by Gemini。
方式二:Gemini Image —— 走 OpenAI 兼容的 /v1/chat/completions
gemini-nano-banana-2.1 和 gemini-3.1-flash-image 也可以走 https://www.ruapi.ai/v1/chat/completions,比如你的代码或客户端只支持 OpenAI 格式。写法和跟文本模型对话完全一样,只是回复里带的是图片。其他 Gemini 图像模型在这种格式下经常只回文字,请用「方式一」。
文生图
图生图(编辑)
要改一张已有的图,按 vision 模型的格式传进去即可:content 用数组,里面放 text 和 image_url 两部分。url 既可以是公网链接,也可以是 data URI。下面的示例可以直接运行;要改你自己的图,把 url 里的链接换掉。
输入图的宽高比会被保留,结果不会被裁成正方形。
多轮连续修图
模型的回复可以原样塞回messages 里当作 assistant 消息——其中的 Markdown data URI 会被识别,图片将作为下一轮的输入。这样就能做「改成黑白」→「再加个白边」这种连续编辑。
方式三:GPT Image —— 走 /v1/images/generations
gpt-image-2 用的是 OpenAI 标准的图片生成格式,请求发到 https://www.ruapi.ai/v1/images/generations。请求里没有 messages,只有 prompt。gpt-image-2.6-flare、gpt-image-2.6-sunburst、gpt-image-2.5-flare 和 gpt-image-2.5-sunburst 调用方法相同,改 model 即可。GPT Image 2.6 的新参数和单张图价格见 GPT Image 2.6 介绍。
参数
响应
常见问题
为什么 Gemini 图像模型不能走 /v1/images/generations?
为什么 Gemini 图像模型不能走 /v1/images/generations?
因为它们不是 OpenAI 意义上的图像生成模型,而是会输出图片的多模态模型。请用谷歌原生格式发到
https://www.ruapi.ai/v1beta/models/模型ID:generateContent(见「方式一」);gemini-nano-banana-2.1 和 gemini-3.1-flash-image 也可以发到 https://www.ruapi.ai/v1/chat/completions(见「方式二」)。如果发到了 /v1/images/generations,会返回 400 错误,错误信息里写了正确的地址。走 /v1/chat/completions 时模型只回文字、不出图
走 /v1/chat/completions 时模型只回文字、不出图
OpenAI 兼容格式下能稳定出图的只有
gemini-nano-banana-2.1 和 gemini-3.1-flash-image。gemini-3-pro-image(nano-banana-pro)、gemini-3.1-flash-lite-image 和其他 Gemini 图像模型请用谷歌原生格式调,见「方式一」。用这两个模型时,提示词里请明确写「生成一张图片:……」。Google GenAI SDK 能用吗?
Google GenAI SDK 能用吗?
能。填 RuAPI 的密钥和
http_options={"base_url": "https://www.ruapi.ai"}(不带 /v1beta),其他代码不用改,示例见「方式一」。RuAPI 没有 Interactions API,请用 generate_content 和 chats。报错「Function calling is not enabled for this model」
报错「Function calling is not enabled for this model」
你的客户端在请求里带了工具(
tools),开了 MCP 或插件的智能体、聊天客户端会这样做。图像模型不支持工具。在这个对话里关掉工具和 MCP(或者单独建一个不带工具的助手)再试。这类失败的请求不收费。content 里那一大串 base64 是什么?
content 里那一大串 base64 是什么?
那就是图片。走
/v1/chat/completions 时,图片以  的形式嵌在文字里。上面的示例会自动把它取出来存成文件。谷歌原生格式(见「方式一」)里图片放在单独的字段里返回。修照片选哪个模型?
修照片选哪个模型?
gemini-nano-banana-2.1 或 gemini-3.1-flash-image,修图的性价比都不错。要细节最多,用谷歌原生格式调 gemini-3-pro-image。gemini-2.5-flash-image 谷歌将在 2027 年 3 月 15 日停用,新项目最好别用。gpt-image-2 也能修图,但要发到单独的地址 https://www.ruapi.ai/v1/images/edits。生成的结果保存多久?
生成的结果保存多久?
不保存。我们不存生成的图片:图片只在这次请求的回复里出现一次。请马上存下来,之后拿不到了。
Gemini 回复里有 usage 和 token 数,按这个扣费吗?
Gemini 回复里有 usage 和 token 数,按这个扣费吗?
看模型。
gemini-nano-banana-2.1、gemini-3-pro-image、gemini-3.1-flash-image 和 gemini-3.1-flash-lite-image 按 token 计费,按 usage(原生格式里是 usageMetadata)扣费。按次计费的模型(gemini-3-pro-image-preview、gemini-3.1-flash-image-preview、gemini-2.5-flash-image)每次调用一口价,usage 只是参考,不影响扣费。模型只回了文字的调用也要收费,所以请明确要求它生成图片。报错「Your request was rejected by the safety system」
报错「Your request was rejected by the safety system」
这是 OpenAI 的内容审核:它认为这条发给
gpt-image-2 的请求违反了规则。审核有时会误判,比如描述小孩或名人的时候。换个说法再试。被拒的请求不收费。