生成图片
图片生成
用 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-4K | 1024x1024、2048x2048、4096x4096 |
gpt-image-2.5、gpt-image-2.6、gpt-image-2.6-flare、gpt-image-2.6-sunburst | 1024x1024、2048x2048 |
gpt-image-2.5-flare、gpt-image-2.5-sunburst | 1024x1024 |
- 默认值:省略
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。