跳转到主要内容
RuAPI 提供两类图像生成模型:Gemini Image(俗称 Nano Banana)和 GPT Image。两者的调用方式不一样,这是开始之前最需要弄清楚的一点。用 USDT 付款,不需要境外银行卡。
Gemini 图像模型不能走 /v1/images/generations。 最稳的是谷歌原生格式 POST https://www.ruapi.ai/v1beta/models/模型ID:generateContent:图片放在单独的字段里返回,不用解析 Markdown。走 OpenAI 兼容的 /v1/chat/completions,能稳定出图的只有 gemini-nano-banana-2.1 和 gemini-3.1-flash-image。

可用模型

准确的价格见主站 价格页。按 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),旁边可能还有一段文字。

文生图

Google GenAI SDK 只要改地址:http_options={"base_url": "https://www.ruapi.ai"},不带 /v1beta,SDK 会自己加上。SDK 把密钥放在 x-goog-api-key 请求头里发送,RuAPI 认这个头。RuAPI 没有 Interactions API(client.interactions),请用 generate_content。

图片参数

参数写在 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 图像模型在这种格式下经常只回文字,请用「方式一」。
图片是以 Markdown data URI 的形式内联在 choices[0].message.content 里的——没有单独的图片字段。响应长这样:
base64 要从正文里取出来。下面的示例会自动取出并存成图片文件。

文生图

模型偶尔只回一句话、不出图,这样的调用也要按用掉的 token 计费。为了避免这种情况,提示词里请明确写「生成一张图片:……」;如果还是没有图,换个说法再试。
一次响应里可能有多张图,所以 Python 示例里用的是 findall 而不是 search;curl 命令只保存第一张。模型几乎总会在图片旁边附一句简短的文字说明。

图生图(编辑)

要改一张已有的图,按 vision 模型的格式传进去即可:content 用数组,里面放 text 和 image_url 两部分。url 既可以是公网链接,也可以是 data URI。下面的示例可以直接运行;要改你自己的图,把 url 里的链接换掉。
输入图的宽高比会被保留,结果不会被裁成正方形。

多轮连续修图

模型的回复可以原样塞回 messages 里当作 assistant 消息——其中的 Markdown data URI 会被识别,图片将作为下一轮的输入。这样就能做「改成黑白」→「再加个白边」这种连续编辑。
每一轮都是一次独立的付费调用。另外,带 base64 图片的历史会让请求体迅速膨胀,别把超过两三张的历史图都塞进上下文。

方式三: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 介绍。

参数

响应

图片只在 b64_json 里返回,它就是 base64 编码的 PNG 文件本身。响应里没有图片链接,我们也不保存生成的图片:请立刻存好,之后无法再次获取。
usage.output_tokens 是图片 token,价格就按它算。把 quality 降到 low 能让它成倍减少,适合出草稿和做测试。

常见问题

因为它们不是 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 错误,错误信息里写了正确的地址。
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 图像模型请用谷歌原生格式调,见「方式一」。用这两个模型时,提示词里请明确写「生成一张图片:……」。
能。填 RuAPI 的密钥和 http_options={"base_url": "https://www.ruapi.ai"}(不带 /v1beta),其他代码不用改,示例见「方式一」。RuAPI 没有 Interactions API,请用 generate_content 和 chats。
你的客户端在请求里带了工具(tools),开了 MCP 或插件的智能体、聊天客户端会这样做。图像模型不支持工具。在这个对话里关掉工具和 MCP(或者单独建一个不带工具的助手)再试。这类失败的请求不收费。
那就是图片。走 /v1/chat/completions 时,图片以 ![image](data:image/png;base64,...) 的形式嵌在文字里。上面的示例会自动把它取出来存成文件。谷歌原生格式(见「方式一」)里图片放在单独的字段里返回。
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-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 只是参考,不影响扣费。模型只回了文字的调用也要收费,所以请明确要求它生成图片。
这是 OpenAI 的内容审核:它认为这条发给 gpt-image-2 的请求违反了规则。审核有时会误判,比如描述小孩或名人的时候。换个说法再试。被拒的请求不收费。