Solicitudes de imágenes
Utilice respuestas de imágenes con una solicitud API predecible.
Verifique el manejo de solicitudes de imágenes a través del punto final de imágenes compatible con OpenAI con URL devueltas o cargas útiles b64_json mientras mantiene las indicaciones seguras, las credenciales del lado del servidor y el uso de imágenes visibles.
Última actualización: July 12, 2026. Examples uso safe placeholders y hacer no incluir real clave APIs, secretos, customer cargas útiles, o sensible prompts.
Ruta predeterminada
Comience con una imagen, un tamaño cuadrado estándar y un formato de respuesta de URL. Agregue tamaños más grandes o base64 solo cuando el flujo de trabajo los necesite.
Ruta de instalación
Cuatro pasos desde la solicitud hasta la forma de activo devuelta.
Step 1
Autenticar del lado del servidor
Utilice una clave API con imágenes: alcance de escritura desde código confiable del lado del servidor.
Sección abiertaStep 2
Enviar un aviso
Publique un mensaje seguro, un recuento de imágenes, un tamaño y un formato de respuesta en el punto final de imágenes.
Sección abiertaStep 3
Leer activos devueltos
Utilice las URL devueltas o las cargas útiles b64_json según el formato de respuesta que solicitó su aplicación.
Sección abiertaStep 4
Ver uso de imágenes
Las solicitudes de imágenes registran el volumen de solicitudes, tokens de aviso y elementos de imagen devueltos para registros y revisión de límite de velocidad.
Sección abiertaPunto final
Publique mensajes en el punto final de las imágenes.
Utilice la ruta de imágenes /v1 con una clave del lado del servidor con ámbito antes de que los flujos de trabajo de imágenes lleguen a los clientes. Mantenga seguro el contenido rápido y evite colocar datos confidenciales en las solicitudes de imágenes.
| Artículo | Valor | Notas |
|---|---|---|
| Método | POST | Envíe JSON al punto final de imágenes. |
| Punto final | https://unlimitedcodex.com/v1/images/generations | Utilice la ruta de imágenes /v1 compatible con OpenAI. |
| Autorización | ficha al portador | Utilice una clave API con ámbito con imágenes: acceso de escritura. |
| tipo de contenido | aplicación/json | El cuerpo de la solicitud debe ser válido JSON. |
Solicitar forma
Mantenga la primera solicitud pequeña.
Comience con una imagen y una URL de salida mientras valida el flujo. Aumente el recuento, el tamaño o la base64 en línea solo después de que su interfaz de usuario y el manejo de tarifas estén listos.
| campo | Estado | Notas |
|---|---|---|
| modelo | Recomendado | Pase un valor de modelo de imagen explícitamente. Utilice el valor del modelo de los detalles de configuración entregados. |
| rápido | Requerido | Envíe un mensaje no vacío de hasta 4000 caracteres. Evite secretos, datos regulados y detalles que identifiquen al cliente. |
| n | Opcional | Solicite de 1 a 4 imágenes. El valor predeterminado es 1. |
| tamaño | Opcional | Utilice 256x256, 512x512, 1024x1024, 1024x1792 o 1792x1024. El valor predeterminado es 1024x1024. |
| formato_respuesta | Opcional | Utilice la URL para obtener una referencia de activo recuperable o b64_json para datos base64 en línea. |
const response = await fetch("https://unlimitedcodex.com/v1/images/generations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.UCX_API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "ucx-image-1",
prompt: "A clean product illustration of an API usage dashboard.",
n: 1,
size: "1024x1024",
response_format: "url"
})
});
const body = await response.json();
if (!response.ok) {
throw new Error(body.error?.code ?? "image_request_failed");
}
const firstImageUrl = body.data[0].url;Forma de respuesta
Lea el formato de recurso que solicitó su aplicación.
La respuesta incluye metadatos de solicitud y un elemento de datos por imagen devuelta. Utilice url o b64_json según el formato de respuesta.
| campo | Significado | Notas |
|---|---|---|
| identificación | ID de solicitud de imagen | Úselo para registros y escalamiento de soporte. |
| creado | marca de tiempo Unix | Indica cuándo se creó la respuesta. |
| modelo | cadena modelo | Coincide con el valor del modelo solicitado. |
| tamaño | tamaño solicitado | Coincide con el tamaño aceptado por el punto final. |
| datos[].url | activo URL | Se devuelve cuando el formato_respuesta es la URL. |
| datos[].b64_json | datos de activos base64 | Se devuelve cuando el formato_respuesta es b64_json. |
{
"id": "img_example",
"created": 1783372800,
"model": "ucx-image-1",
"size": "1024x1024",
"data": [
{
"url": "https://unlimitedcodex.com/v1/images/example.png",
"revised_prompt": "A clean product illustration of an API usage dashboard."
}
]
}{
"model": "ucx-image-1",
"prompt": "A simple square app icon for an internal tool.",
"n": 1,
"size": "512x512",
"response_format": "b64_json"
}Límites y errores
Planifique el uso de imágenes y respuestas completas.
Los flujos de trabajo de solicitud de imágenes pueden generar picos de uso más pronunciados que las solicitudes de solo texto. Verifique el ajuste del paquete y el manejo 429 antes de lanzar campañas o trabajos por lotes.
El punto final de la imagen actual no transmite el progreso parcial; la respuesta regresa después de que se completa la solicitud.
Cada elemento de imagen devuelto se registra para visibilidad de uso y cada llamada cuenta como una solicitud.
El texto rápido también contribuye a las estimaciones de costos y tokens.
Utilice valores de n pequeños al validar un flujo de trabajo, luego aumente solo cuando el producto necesite múltiples variaciones.
Maneje las respuestas de tasa 429 antes de que los trabajos de imágenes de fondo generen una falla visible para el usuario.
FAQ
Preguntas sobre solicitud de imágenes.
¿A qué punto final de imagen debo llamar?
Utilice POST /v1/images/generations con una clave de portador API, JSON cuerpo de solicitud, modelo, mensaje, recuento de imágenes opcional, tamaño opcional y formato_respuesta opcional.
¿Qué alcance necesita una clave de imagen?
Utilice una clave API con imágenes: alcance de escritura. Manténgalo en el lado del servidor y nunca lo exponga en el código del navegador, paquetes móviles, registros o mensajes de soporte.
¿Pueden las solicitudes de imágenes transmitir el progreso?
No. El punto final actual devuelve una respuesta completa una vez finalizada la solicitud. Cree estados de carga orientados al usuario y manejo del tiempo de espera en su aplicación.
¿Debo solicitar URL o b64_json?
Utilice la URL cuando su aplicación pueda recuperar o almacenar una referencia de activo. Utilice b64_json cuando su aplicación necesite datos de imágenes en línea y pueda manejar cuerpos de respuesta más grandes.
Herramientas gratuitas
Planificar el volumen de solicitudes de imágenes
Valide cargas útiles, calcule el impacto de la cuota, compare costos de paquetes y cree fragmentos de solicitudes antes del lanzamiento.
Validador de solicitudes
Valide las cargas útiles de chat, incrustaciones y imágenes JSON con reglas compatibles con unlimitedcodex OpenAI.
Estimador de cuotas
Convierta MAU y solicite suposiciones en tokens mensuales, solicitudes y advertencias de umbral de cuota.
Calculadora de costos
Calcule el gasto mensual OpenAI y compárelo con paquetes fijos unlimitedcodex semanales o mensuales.
Generador de solicitudes
Cree la finalización del chat JSON visualmente y exporte fragmentos de cURL, JavaScript o Python.
Siguiente paso
Combine el manejo de solicitudes de imágenes con límites de velocidad y manejo de errores.
Antes de que los clientes dependan de la salida de imágenes, confirme la política de avisos, el uso de imágenes, el comportamiento de reintento y el almacenamiento de respuestas.