文本生成图像 API 参考

    通过 Gate.AI 文生图接口调用 OpenAI、Qwen、Seedream 等供应商的图像模型。该接口使用 JSON 请求体，同步返回图片 URL 与计费信息，无需 job_id 轮询或 Webhook。

    字段值
    Base URLhttps://api.gate.ai/openai/v1
    认证Authorization: Bearer <API_KEY>
    格式OpenAI 兼容；使用 JSON 请求体

    图像接口路径位于 /openai/v1 下；生成结果 data[].url 为短时 S3 预签名地址，请尽快下载或转存，落盘对象 TTL 30 天。

    文本生成图像

    POST/images/generations

    根据文本 prompt 同步生成图片，成功后返回 OpenAI 兼容的图像结果，data[].url 为生成图片地址。

    请求参数

    名称位置类型必选说明
    Authorizationheaderstring是Gate.AI API Key。格式：Bearer <API_KEY>
    Content-Typeheaderstring是请求体格式：application/json

    请求体

    名称类型必选说明
    modelstring是图像模型 ID，如 gpt-image-1、qwen-image-2.0-pro、seedream-4.0；缺失返回 400 model is required
    promptstring是图像文本描述。gpt-image-1 上限 32000 字符
    ninteger否生成张数，1–10，默认 1；多图按张计费
    sizestring否输出尺寸。gpt-image-1 支持 1024x1024、1536x1024、1024x1536 或 auto，并参与费用预估
    response_formatstring否url 或 b64_json。gpt-image-1 不支持该参数，传入可能被上游拒绝
    streamboolean否透传字段；当前图像为同步链路，不据其分流

    示例

    json
    1{2  "model": "gpt-image-1",3  "prompt": "A golden retriever running on a sunny beach, cinematic",4  "n": 1,5  "size": "1024x1024"6}

    返回字段说明

    名称类型说明
    createdinteger生成时间戳（秒）
    dataarray结果数组，长度等于 n
    data[].urlstring图片 S3 预签名 URL，短时有效，落盘 30 天
    usageobject用量。OpenAI 系为 token 明细；Qwen 系为 width、height、image_count
    model_extend.coststring实际计费金额（USD），扣款以此为准
    model_extend.line_itemsarray计费分项。token 计费含 input/output/cache；按张计费含 billing_unit、rate_usd_per_image、resolution_tier
    model_extend.providerstring实际上游 provider，如 openai、qwen
    size / quality / output_format / backgroundstring部分模型回显的入参
    modelstring仅 Qwen 系在顶层回显

    返回示例

    json
    1{2  "created": 1781604363,3  "data": [4    {5      "url": "https://ai-gateway-file.s3.ap-northeast-1.amazonaws.com/multimodal/image/2026/06/16/example-0.png?X-Amz-Expires=600&X-Amz-Signature=..."6    }7  ],8  "size": "1024x1024",9  "quality": "low",10  "output_format": "png",11  "background": "opaque",12  "usage": {13    "input_tokens": 10,14    "output_tokens": 196,15    "total_tokens": 206,16    "output_tokens_details": {17      "image_tokens": 196,18      "text_tokens": 019    }20  },21  "model_extend": {22    "cost": "0.006322",23    "provider": "openai",24    "total_tokens": "206",25    "line_items": [26      {27        "kind": "uncached_input",28        "tokens": 10,29        "rate_usd_per_million": "5.0000000000",30        "amount_usd": "0.0000500000"31      },32      {33        "kind": "output",34        "tokens": 196,35        "rate_usd_per_million": "32.0000000000",36        "amount_usd": "0.0062720000"37      }38    ]39  }40}

    返回结果

    状态码状态码含义说明数据模型
    200OK成功，同步返回图片结果与计费信息。ImageResponse
    400Bad Request请求体错误、JSON 无效，或 model / prompt 缺失。OpenAIErrorResponse
    401UnauthorizedAPI Key 无效或缺失。OpenAIErrorResponse
    402Payment Required余额不足，响应中包含当前余额与预估费用。InsufficientBalanceResponse
    404Not Found模型不存在，或图像端点未启用。OpenAIErrorResponse
    413Payload Too Large请求体过大，默认上限 8 MiB。OpenAIErrorResponse
    429Too Many Requests请求过于频繁，请降低调用频率。OpenAIErrorResponse
    500Internal Server Error服务内部错误。OpenAIErrorResponse
    502Bad Gateway上游图像服务失败。OpenAIErrorResponse