---
title: "Integración de generación de imágenes"
description: "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."
headingIds: {"API y configuración":"section-1","Generar y guardar una imagen":"section-2","Confirma el soporte del modelo antes de añadir parámetros":"section-3","Resolución de problemas":"section-4"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentación mantenida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fuentes y correcciones](https://1zheai.com/en/editorial/).

¿Encontraste un error? [Contacta con soporte](mailto:support@1zheai.com) indicando la dirección de la página y una descripción. No envíes claves de API ni credenciales de cuenta.

</aside>
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 ](/es/docs/api-models/) y luego confirma la API de imágenes y sus parámetros en el [catálogo de modelos de la consola ](https://1zheai.com/model-catalog?lng=es).

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:

```python
import base64
import os
from pathlib import Path
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ONEZHE_API_KEY"],
    base_url="https://1zheai.com/v1",
    timeout=300.0,
    max_retries=0,
)
result = client.images.generate(
    model=os.environ.get("ONEZHE_IMAGE_MODEL", "gpt-image-1.5"),
    prompt="一只白色陶瓷茶杯放在浅灰色桌面上，柔和自然光，无文字。",
)
if not result.data:
    raise RuntimeError("响应没有图片数据，请检查错误信息与调用日志。")
item = result.data[0]
if item.b64_json:
    target = Path("generated-image.png")
    target.write_bytes(base64.b64decode(item.b64_json, validate=True))
    print(f"图片已保存到 {target.resolve()}")
elif item.url:
    print("返回的是图片地址，请及时下载：", item.url)
else:
    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 ](https://developers.openai.com/api/reference/resources/images/methods/generate). 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 ](/es/docs/retries/).