OpenAI / Google · POST /v1/images/generations · 同步文生图 / 异步文生图 / 异步图生图

POST 
/v1/images/generations

基本信息

• Base URL：https://api.horver.ai
• 端点：POST /v1/images/generations
• Content-Type：application/json
• 用途：OpenAI / Google 图片生成统一入口。标题中已经写明真实请求路径，下面按厂商和同步/异步拆开。

路径总览

厂商	模式	场景	请求路径	查询路径
OpenAI	同步生图	同步文生图	POST /v1/images/generations	无需查询，响应直接返回图片
OpenAI	异步生图	异步文生图	POST /v1/images/generations + "async": true	GET /v1/images/generations/{task_id}
OpenAI	异步生图	异步图生图	POST /v1/images/generations + "async": true + 参考图 URL	GET /v1/images/generations/{task_id}
Google	异步生图	异步文生图	POST /v1/images/generations	GET /v1/images/generations/{task_id}

OpenAI

同步生图 / 同步文生图

使用 model=gpt-image-2 或 gpt-image-2-all，不传 async 或传 false。成功响应直接返回 data[].b64_json 或 data[].url，客户端保存即可。

异步生图 / 异步文生图

同样使用 POST /v1/images/generations，传 "async": true，不要传参考图。提交成功后返回 task_id。

异步生图 / 异步图生图

仍然使用 POST /v1/images/generations，传 "async": true，并通过 images / image / metadata.urls 传参考图 URL 或 Data URL。提交成功后返回 task_id。

异步查询

OpenAI 异步任务统一用 GET /v1/images/generations/{task_id} 查询。

Google

同步生图

Google Nano Banana 同步返回请使用 Gemini 原生路径：POST /v1beta/models/{model}:generateContent。

异步生图 / 异步文生图

使用 POST /v1/images/generations，模型可用 nano-banana-2 或 nano-banana-pro。提交成功后返回任务对象。

异步查询

Google 图片任务同样用 GET /v1/images/generations/{task_id} 查询。

参数要点

• model：OpenAI 用 gpt-image-2 / gpt-image-2-all；Google 用 nano-banana-2、nano-banana-pro 或对应 text-to-image / edit 别名。
• prompt：必填。Nano Banana 最长 10000 字符。
• size：决定 1K / 2K / 4K 档位。quality 不改变档位。
  • 1K：长边 ≤ 1536，如不传、auto、1024x1024、1536x1024、1024x1536
  • 2K：长边 1537–2048，如 2048x2048、2048x1152、1152x2048；1792x1024、1008x1792 也按 2K
  • 4K：长边 > 2048，如 3840x2160、2160x3840；4K 受总像素上限 8,294,400 约束，1:1 的 4K 是 2880x2880
  • 计费档按请求的 size 定，不按实际交付尺寸；quality 不改变档位；显式传 resolution / image_size（1K / 2K / 4K）时以它为准。
  • 2K / 4K 尺寸沿用 OpenAI 官方口径：2048x2048（2K square）、2048x1152（2K landscape）、3840x2160（4K landscape）、2160x3840（4K portrait）。2560x1440 以上属于实验性分辨率，不保证每次都按该尺寸交付。出处：OpenAI 图像生成指南
  • 自定义 WIDTHxHEIGHT：两边为 16 的倍数，最长边 ≤ 3840，长宽比 ≤ 3:1，总像素 655,360–8,294,400。
• quality：gpt-image-2 可传 low、medium、high、auto；不传时本站默认 high。
• n：同步 gpt-image-2 为生成张数，1 到 10。
• async：传 true 时返回任务，不直接返回图片。
• aspect_ratio：Nano Banana 异步任务只接受 auto、1:1、9:16、16:9。
• resolution：Nano Banana Pro 可传 1k、2k、4k，后端会映射为上游模型名。
• images / image / image_urls / input_reference：异步图生图参考图，Nano Banana 最多 5 张，支持公网 URL 或完整 Data URL。

返回说明

• 同步成功：返回 OpenAI 兼容图片响应，通常是 data[].b64_json。
• 异步提交成功：返回 id / task_id / status / progress。
• 查询异步任务：调用 GET /v1/images/generations/{task_id}。

cURL：gpt-image-2 同步文生图

curl --location --request POST 'https://api.horver.ai/v1/images/generations' \
  --header 'Authorization: Bearer sk-xxx' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "model": "gpt-image-2",
    "prompt": "一个小男孩，清晰自然光，单主体，背景简洁",
    "size": "1536x1024",
    "quality": "high",
    "n": 1
  }'

cURL：gpt-image-2 异步图生图

curl --location --request POST 'https://api.horver.ai/v1/images/generations' \
  --header 'Authorization: Bearer sk-xxx' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "model": "gpt-image-2",
    "prompt": "基于参考图做一张更有科技感的产品广告图，保留主体轮廓",
    "size": "1920x1080",
    "images": ["https://example.com/reference.png"],
    "async": true
  }'

cURL：Google Nano Banana 文生图

curl --location --request POST 'https://api.horver.ai/v1/images/generations' \
  --header 'Authorization: Bearer sk-xxx' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "model": "nano-banana-2",
    "prompt": "一张干净的产品海报，白底，柔和棚拍光",
    "resolution": "4k",
    "aspect_ratio": "16:9"
  }'

鉴权提示

在线运行面板应使用 Authorization: Bearer sk-xxx。请把环境变量 token 设置为控制台复制的完整 API Key；不要把 Bearer 写进 token 变量。

Request

Responses

200

Response Headers