跳至主要內容

画图接口

Right Code2026/10/24大约 3 分钟

画图接口

Right Code 画图接口统一走异步模式：提交任务拿到 task_id，再轮询任务查询接口取结果。按模型协议分两类：

  • OpenAI 生成：GPT Image 系列模型，走 OpenAI Images 协议，提供文生图和独立的图片编辑接口（/v1/images/edits）。
  • Gemini 生成：Gemini 图像模型（Nano Banana 系列），走 Gemini generateContent 协议，文生图和参考图编辑都在同一个接口里完成。

可用模型

模型定位调用方式
gpt-image-2GPT Image 2 基础模型OpenAI 生成
gpt-image-2.5-flare速度优先，适合日常高质量图片生成OpenAI 生成
gpt-image-2.5-sunburst能力优先，适合对编辑精度要求高的场景OpenAI 生成
gemini-3-pro-image-previewNano Banana Pro，画质和理解能力优先Gemini 生成
gemini-nano-banana-2.1Nano Banana 2 系列，速度优先Gemini 生成

质量档位

xhigh 和 max 是 GPT Image 2.5 新增的质量档位，只能用于 gpt-image-2.5-flare 和 gpt-image-2.5-sunburst。gpt-image-2 仍只支持 auto、low、medium、high。

基础信息

项值
基础地址https://rightapi.ai
鉴权头Authorization: Bearer sk-xxxxx
请求格式Content-Type: application/json（OpenAI 图片编辑上传文件时用 multipart/form-data）
结果形态图片 URL（不返回 base64）

接口一览

接口方法与路径用途
OpenAI 生成 · 文生图POST /v1/images/generationsGPT Image 文生图
OpenAI 生成 · 图片编辑POST /v1/images/edits图生图、换背景、多图融合（支持上传文件或 JSON 传图）
Gemini 生成POST /v1beta/models/{model}:generateContentGemini 文生图 / 带参考图编辑
任务查询GET /v1/tasks/{task_id}轮询异步任务结果

怎么选

对比项OpenAI 生成Gemini 生成
模型gpt-image-2、gpt-image-2.5-flare、gpt-image-2.5-sunburstgemini-3-pro-image-preview、gemini-nano-banana-2.1
模型写在哪请求体 model 字段请求路径 /v1beta/models/{model}:generateContent
尺寸写法size 像素值，如 1024x1024、1536x1024aspectRatio 比例 + imageSize 档位（1K / 2K / 4K）
质量控制quality：auto / low / medium / high，2.5 模型另有 xhigh / max通过 imageSize 档位控制
文生图✅ /v1/images/generations✅ generateContent
参考图 / 图片编辑✅ /v1/images/edits，支持上传文件、URL、base64✅ 同一接口，parts 里加 inline_data（base64）
多图参考✅✅
局部重绘（mask）❌ 参数会被接收但暂不生效❌
完成后的结果data[].urlcandidates[].content.parts[].text（文本即图片 URL）

可用的模型名以渠道与模型中列出的为准。

异步流程

  1. 提交请求，请求体带 "async": true，立即返回 task_id。
  2. 每隔几秒轮询一次 GET /v1/tasks/{task_id}。
  3. 返回里出现 data（OpenAI 生成）或 candidates（Gemini 生成）即为完成，从中取图片 URL；status 为 failed / expired / canceled 则按失败处理。

提交 + 轮询的完整代码见任务查询 · 完整示例。

提示

不带 "async": true 时，接口会先等结果（默认最多 60 秒），超时同样返回 task_id。图片生成耗时波动较大，建议始终带 "async": true，统一按轮询处理。

提交就失败

参数错误、余额不足、上游拒绝等会在提交阶段直接返回失败，此时 status 为 failed，看 error 字段：

{
  "task_id": "task_0123456789abcdef0123456789abcdef",
  "status": "failed",
  "error": "上游 HTTP 404: 404 page not found",
  "message": "任务id: task_0123456789abcdef0123456789abcdef 处理失败"
}

常见 HTTP 错误

状态码常见原因处理建议
400JSON / 表单格式错误，缺少 model、prompt，或 size、aspectRatio 等取值不被模型支持先用文档里的最小请求验证，再逐个加参数
401未传 API Key、Key 无效或已过期检查 Authorization: Bearer sk-xxxxx
403Key 被禁用，或分组未开通该模型检查 Key 状态和所属分组
404模型名不存在或路径写错核对模型名和请求路径
429触发限流或余额不足降低并发，检查余额
5xx暂无可用上游或上游临时不可用稍后重试

注意事项

  • 结果统一为图片 URL，response_format 不生效；拿到 URL 后建议自行下载保存。
  • 局部重绘（mask）、图片变体（variations）暂不支持。
  • 参考图较大时建议先压缩再上传，能明显加快生成速度。