LensAPI/简体中文控制台
生成图片图片生成
本页目录概述

生成图片

图片生成

用 Image-2 分组调用图片生成接口,保存结果并核对费用。

使用 Image-2 分组#

为图片生成单独创建 Image-2 Key,并按认证教程设置 LENSAPI_API_KEY。当前开放 8 款图片模型,完整型号和尺寸见下表;可用性及价格以模型与价格为准。

本页只介绍 POST /v1/images/generations。不要将这里的调用方式扩展理解为已支持图片编辑、视频或所有兼容图片参数。

先生成一张简单图片#

把下面的 Python 示例保存为 create_image.py。它使用标准库,发送一次实际图片生成请求,并将返回图片保存到当前目录。运行前先核对目标模型价格。

import base64
import json
import os
from pathlib import Path
import urllib.error
import urllib.request

request = urllib.request.Request(
    "https://lensapi.top/v1/images/generations",
    data=json.dumps({
        "model": "gpt-image-2",
        "prompt": "极简编辑插画:浅色背景上的蓝色玻璃棱镜,无文字",
        "n": 1,
        "size": "1024x1024",
        "response_format": "b64_json",
    }).encode("utf-8"),
    headers={
        "Authorization": "Bearer " + os.environ["LENSAPI_API_KEY"],
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
    item = result["data"][0]
    if item.get("b64_json"):
        image_bytes = base64.b64decode(item["b64_json"])
    elif item.get("url", "").startswith("https://"):
        # 下载结果地址时不携带 LensAPI API Key。
        with urllib.request.urlopen(item["url"], timeout=60) as image_response:
            image_bytes = image_response.read()
    else:
        raise RuntimeError("未找到可保存的图片,请检查返回字段。")
    extension = ".bin"
    if image_bytes.startswith(b"\x89PNG\r\n\x1a\n"):
        extension = ".png"
    elif image_bytes.startswith(b"\xff\xd8\xff"):
        extension = ".jpg"
    elif image_bytes[:4] == b"RIFF" and image_bytes[8:12] == b"WEBP":
        extension = ".webp"
    output = Path("lensapi-image" + extension)
    output.write_bytes(image_bytes)
    print("已保存:", output.resolve())
except urllib.error.HTTPError as error:
    print("HTTP", error.code)
    print(error.read().decode("utf-8", errors="replace"))

结果可能通过编码数据或 URL 返回。代码会识别常见 PNG、JPEG 与 WebP 格式,其他格式保存为 .bin。下载图片时不携带 API Key,也不把请求认证头转发给结果文件所在的其他域名。

费用先按具体模型确认#

Image-2 当前按型号固定收费:gpt-image-2-4K 为 ¥0.15/张;gpt-image-2 及其余当前已开放图片模型为 ¥0.10/张,不按图片 Token 计价。同一型号在支持的尺寸内单价不变。当前每次仅支持一张,使用 n=1;需要多张请分次请求。完整生效规则见模型与价格,充值支付金额与到账额度请分别核对。

调用前请核对完整模型 ID 和当前计费规则;先以一张图片测试,再到使用日志核对扣费。价格展示不代表接口支持所有可选参数,也不自动适用于以后新增的模型。

当前开放规格(2026-11-12 验收)#

模型支持的 size
gpt-image-2、gpt-image-2-4K1024x1024、2048x2048、4096x4096
gpt-image-2.5、gpt-image-2.6、gpt-image-2.6-flare、gpt-image-2.6-sunburst1024x1024、2048x2048
gpt-image-2.5-flare、gpt-image-2.5-sunburst1024x1024
  • 默认值:省略 size 时使用 1024x1024;数量为 n=1。仅开放表中的尺寸,1k、2k、auto 及未列出的宽高写法不适用。
  • 返回方式:使用 response_format=b64_json,将 data[0].b64_json 解码为图片。当前不开放 URL 返回格式。
  • 接口范围:仅 POST /v1/images/generations 的非流式生成。图片编辑、批量生成、Responses 图片工具和图片流式暂未开放。
  • SDK:可使用 OpenAI Python SDK 的默认响应解析。部分扩展尺寸及响应字段不兼容 SDK 的严格校验模式;保存图片后应按文件实际像素尺寸核对结果。
  • 耗时:单张验收样本约 20–45 秒,复杂图片可能更久;建议客户端超时设为 180 秒以上。该样本范围不是耗时保证。

生成较慢或失败时#

图片生成需要等待完整结果。客户端超时后先查看日志,确认请求是否已处理,再决定是否重试;立即重复提交可能创建另一张图片并产生额外费用。收到参数错误时按本页规格修改,不要重复提交相同请求。

遇到 HTTP 524 或长时间等待后没有图片时,保留请求时间、模型、等待时长、错误信息与请求 ID(如有)。先检查客户端已经收到或保存的结果,再核对使用日志及余额变化;状态不明确时按524 与长任务排查步骤整理反馈,避免盲目重试。

超时状态本身不能证明请求未执行,也不能保证自动退费或重试不会重复计费。增加客户端超时只延长本地等待,不能保证解决服务链路返回的 524。

继续阅读:用量与计费 · 响应慢时怎么检查。

输入关键词,搜索接入指南、模型与常见问题。