Integración de generación de imágenes

Genera imágenes con la API de imágenes de OpenAI, guarda los resultados en Base64 y resuelve problemas de permisos de modelos y tiempos de espera.

El catálogo público de modelos de este sitio enumera actualmente gpt-image-1.5 y chatgpt-image-latest (verificado el 2026-10-16). Antes de usarlos, consulta primero los modelos disponibles para tu clave y luego confirma la API de imágenes y sus parámetros en el catálogo de modelos de la consola .

Esta página ofrece ejemplos de integración siguiendo el protocolo de imágenes de OpenAI; no se realizó ninguna generación de imágenes de pago durante esta actualización de la documentación, por lo que los ejemplos siguientes no deben considerarse probados en todas las combinaciones de modelo, tamaño y calidad.

API y configuración

Endpoint completo: POST https://1zheai.com/v1/images/generations
URL base del SDK de OpenAI: https://1zheai.com/v1
Usa la variable de entorno ONEZHE_API_KEY en este sitio.
Instala el SDK de Python: python -m pip install openai.

Generar y guardar una imagen

Guárdala como generate-image.py y luego ejecuta python generate-image.py en la terminal:

1
import base64
2
import os
3
from pathlib import Path
4
from openai import OpenAI
5

6
client = OpenAI(
7
    api_key=os.environ["ONEZHE_API_KEY"],
8
    base_url="https://1zheai.com/v1",
9
    timeout=300.0,
10
    max_retries=0,
11
)
12
result = client.images.generate(
13
    model=os.environ.get("ONEZHE_IMAGE_MODEL", "gpt-image-1.5"),
14
    prompt="一只白色陶瓷茶杯放在浅灰色桌面上，柔和自然光，无文字。",
15
)
16
if not result.data:
17
    raise RuntimeError("响应没有图片数据，请检查错误信息与调用日志。")
18
item = result.data[0]
19
if item.b64_json:
20
    target = Path("generated-image.png")
21
    target.write_bytes(base64.b64decode(item.b64_json, validate=True))
22
    print(f"图片已保存到 {target.resolve()}")
23
elif item.url:
24
    print("返回的是图片地址，请及时下载：", item.url)
25
else:
26
    raise RuntimeError("响应没有 b64_json 或 url。")

El ejemplo usa el formato de salida predeterminado. Si especificas JPEG / WebP u otro formato, cambia la extensión del archivo en consecuencia al guardarlo. No escribas la cadena Base64 directamente en un archivo de texto y la renombres a PNG.

Confirma el soporte del modelo antes de añadir parámetros

Verifica primero con una solicitud que contenga solo model y prompt. Parámetros como el tamaño, la calidad, el fondo transparente y el formato de salida no se admiten de forma universal en todos los modelos de imágenes; no copies directamente nombres de modelos o parámetros propietarios de otros proveedores.

Cuando se devuelva data[].b64_json, realiza la decodificación Base64; cuando se devuelva data[].url, descárgalo de inmediato y no trates la URL temporal como almacenamiento permanente. La aplicación debe organizar su propio almacenamiento de resultados.

Resolución de problemas

Situación	Método de solución
400 parámetro no admitido	Elimina los parámetros opcionales como el tamaño personalizado y la calidad, y luego verifica uno por uno
403 / 404	Comprueba el ID del modelo de imagen, los permisos de la clave y la ruta completa de la API
Espera prolongada	Establece un tiempo de espera razonable para la generación y muestra un estado en curso para evitar envíos repetidos por clics continuos
Sin imagen después del tiempo de espera	Comprueba primero los registros de llamada; no recibir un resultado no significa que el origen no haya procesado la solicitud
Quiero editar una imagen existente	La edición de imágenes es una API y un método de entrada diferentes; el ejemplo de texto a imagen de esta página no puede sustituirla directamente

Para la referencia de parámetros del protocolo, consulta Referencia de generación de imágenes de OpenAI . Las tarifas se basan en el catálogo de modelos en tiempo real de este sitio; para la estrategia de reintentos, consulta Tiempos de espera y reintentos .