GPT-Image-2 API 与 Nano Banana 2 API 接入指南

GPT-Image-2 API 与 Nano Banana 2 API 模型对比

创建任务时不传 model 即使用默认模型；需要另一模型时，按下表传入精确编码。

文生图、图生图与参考图编辑 API 场景

同一个创建接口同时承接纯文本生成与带图编辑。业务端只需根据场景决定是否传入 image 数组。

创建与查询流程

生图和图片编辑采用异步任务模式。业务端应保存创建接口返回的任务 ID，并按需查询结果。

1. 1. 提交任务POST 调用 image_generation，传入 apikey、prompt 和可选模型参数。
2. 2. 保存 task_id从创建响应中取得任务 ID，避免重复创建相同任务。
3. 3. 查询结果GET 调用状态接口，使用 task_id 获取任务状态及最终图片。

提交 image_generation 任务

请求地址为 POST https://5555api.com/data/api/imageGeneration。其中 apikey 和 prompt 必填，其余参数按业务需要选填。

cURL 示例

curl -X POST "https://5555api.com/data/api/imageGeneration" \
  -H "Content-Type: application/json" \
  -d '{
    "apikey": "YOUR_API_KEY",
    "prompt": "一张适合产品详情页的极简摄影图",
    "model": "gpt-image-2",
    "n": 1,
    "size": "1:1",
    "imageSize": "2K"
  }'

查询 image_generation_status

查询接口编码为 image_generation_status，请求地址为 GET https://5555api.com/data/api/imageGeneration/status，单次消耗 2 金豆。

cURL 示例

curl -G "https://5555api.com/data/api/imageGeneration/status" \
  --data-urlencode "apikey=YOUR_API_KEY" \
                  --data-urlencode "task_id=YOUR_TASK_ID"

JavaScript 完整异步轮询示例

以下示例覆盖创建任务、读取 task_id、轮询状态、识别最终图片和失败状态。生产环境应从服务端安全读取 API Key。

const API_KEY = process.env.QINGYU_API_KEY;

async function createImage(prompt, model = 'gpt-image-2', image = []) {
  const createResponse = await fetch(
    'https://5555api.com/data/api/imageGeneration',
    {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ apikey: API_KEY, prompt, model, image })
    }
  );
  const createResult = await createResponse.json();
  if (createResult.code !== 200 || !createResult.data?.task_id) {
    throw new Error(createResult.msg || '创建生图任务失败');
  }

  const taskId = createResult.data.task_id;
  for (let attempt = 0; attempt < 100; attempt += 1) {
    await new Promise(resolve => setTimeout(resolve, 3000));
    const query = new URLSearchParams({ apikey: API_KEY, task_id: taskId });
    const statusResponse = await fetch(
      `https://5555api.com/data/api/imageGeneration/status?${query}`
    );
    const statusResult = await statusResponse.json();
    if (statusResult.code !== 200) {
      throw new Error(statusResult.msg || '查询生图任务失败');
    }

    const task = statusResult.data;
    const imageResult = task?.data?.[0]?.url || task?.data?.[0]?.b64_json;
    if (imageResult || task?.status === 'completed') return task;
    if (task?.status === 'failed' || task?.status === 'error' || task?.error) {
      throw new Error('生图任务执行失败');
    }
  }
  throw new Error('生图任务等待超时');
}

常见问题

相关 API 与开发资源

继续查看轻语API开放平台的接口分类和可直接体验的在线工具。