Modelos de imágenes
Genera y edita imágenes mediante la API de modelos de imágenes de OneMux.
Descripción de la API
Los modelos de imágenes usan una API Images independiente. No envíes solicitudes de generación de imágenes a /v1/chat/completions.
- Generación de imágenes:
POST https://api.onemux.net/v1/images/generations - Edición de imágenes:
POST https://api.onemux.net/v1/images/edits - Autenticación:
Authorization: Bearer YOUR_API_KEY - Modelo: usa el ID real del modelo de imágenes que devuelve la API de la lista de modelos actual
Primero, obtén los modelos disponibles actualmente:
curl https://api.onemux.net/v1/models \
-H "Authorization: Bearer $ONEMUX_API_KEY"
La compatibilidad de los modelos de imágenes con parámetros como generación, edición, imágenes de referencia, tamaño, calidad y formato de salida depende de la lista de modelos y de las capacidades reales del proveedor ascendente.
Generación de imágenes
Usa /v1/images/generations para enviar una solicitud de generación de imágenes a partir de texto.
curl https://api.onemux.net/v1/images/generations \
-H "Authorization: Bearer $ONEMUX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_IMAGE_MODEL_ID",
"prompt": "一只坐在窗边的橘猫,午后自然光,写实摄影风格",
"size": "1024x1024",
"quality": "medium"
}'
Parámetros habituales:
| Parámetro | Obligatorio | Descripción |
|---|---|---|
model | Sí | ID de un modelo de imágenes disponible actualmente |
prompt | Sí | Descripción del contenido de la imagen |
size | No | Tamaño de la imagen; el modelo determina los valores admitidos |
quality | No | Calidad de la imagen; el modelo determina los valores admitidos |
n | No | Cantidad de imágenes generadas; el modelo determina el rango admitido |
response_format | No | b64_json o url; solo está disponible en los modelos compatibles |
background | No | Fondo transparente u opaco; solo está disponible en los modelos compatibles |
output_format | No | png, jpeg, webp; solo está disponible en los modelos compatibles |
No uses en otros modelos de imágenes los parámetros que admite un modelo concreto. Si se produce un error model_not_found, invalid_model o de parámetro no admitido, comprueba primero el ID del modelo y sus capacidades.
Edición de imágenes
Usa /v1/images/edits para editar imágenes existentes. Los modelos de imágenes compatibles con OpenAI suelen usar multipart/form-data para subir imágenes:
curl https://api.onemux.net/v1/images/edits \
-H "Authorization: Bearer $ONEMUX_API_KEY" \
-F "model=YOUR_IMAGE_MODEL_ID" \
-F "image[]=@input.png" \
-F "prompt=将背景改为浅蓝色,保持主体和文字不变" \
-F "size=1024x1024"
Puedes pasar varias imágenes de referencia repitiendo image[], por ejemplo:
-F "image[]=@person.png" \
-F "image[]=@product.png"
La cantidad y el formato de las imágenes, las máscaras, las URL de imágenes de referencia y el formato de edición JSON dependen del modelo y del canal del proveedor ascendente. Usa estos parámetros únicamente cuando el modelo los admita explícitamente.
Llamadas desde Python
from openai import OpenAI
import os
client = OpenAI(
api_key=os.environ["ONEMUX_API_KEY"],
base_url="https://api.onemux.net/v1",
)
result = client.images.generate(
model="YOUR_IMAGE_MODEL_ID",
prompt="一张简洁的蓝色科技风产品海报",
size="1024x1024",
)
print(result.data[0].b64_json or result.data[0].url)
La edición de imágenes suele requerir enviar directamente archivos multipart. Si la versión actual del SDK de Python no admite los parámetros de edición del modelo que necesitas, usa la solicitud cURL anterior.
Respuesta
Las respuestas satisfactorias suelen incluir el array data:
{
"created": 1760000000,
"data": [
{
"b64_json": "iVBORw0KGgo..."
}
]
}
Algunos modelos devuelven una URL de imagen cuando se solicita response_format como url:
{
"created": 1760000000,
"data": [
{
"url": "https://example.com/generated-image.png"
}
]
}
Si recibes Base64, guarda el archivo según el formato real de la imagen. Si recibes una URL, descarga y guarda la imagen cuanto antes para evitar que caduque la dirección temporal.
Facturación
Los modelos de imágenes no usan un sistema de facturación unificado basado en Tokens. OneMux factura según las reglas vigentes de cada modelo, que pueden incluir:
- Facturación por cantidad de imágenes generadas
- Facturación por resolución de imagen o nivel de calidad
- Facturación por Tokens de entrada o salida de imágenes, o por otro consumo del proveedor ascendente
Consulta las condiciones actuales del modelo correspondiente en el catálogo de modelos para conocer los precios, las unidades de facturación y las especificaciones admitidas. Por lo general, las solicitudes fallidas no generan el coste de las imágenes de una solicitud satisfactoria, pero el comportamiento concreto depende de lo que indique la página y de la respuesta del servidor.
Preguntas frecuentes
¿Por qué no puedo usar la API de chat para generar imágenes?
Los modelos de imágenes usan una ruta Images independiente. Si envías la solicitud a /v1/chat/completions o a otra API que no corresponda, puede que recibas un error indicando que el modelo no admite ese endpoint o que hay parámetros no válidos.
¿Por qué puedo consultar el nombre del modelo, pero la solicitud sigue fallando?
Comprueba si el modelo permite generar o editar imágenes, si tu API Key actual tiene los permisos necesarios, si los parámetros de la solicitud están dentro de los valores admitidos por el modelo y si el canal correspondiente del proveedor ascendente está disponible.
¿Por qué recibo Base64 en lugar de un enlace a la imagen?
El formato de la respuesta depende del modelo o de la configuración response_format. Si recibes b64_json, tendrás que decodificarlo y guardarlo en el cliente. Si recibes url, tendrás que descargar la imagen desde la dirección devuelta.
¿Qué hago si la generación de imágenes tarda mucho?
Las solicitudes de alta resolución, gran calidad o edición compleja pueden tardar más. Configura un tiempo de espera razonable en el cliente y no vuelvas a enviar la misma solicitud solo porque se haya agotado el tiempo de espera, ya que podrías crear tareas o cargos duplicados.
GPT Image 2.6: SVG, GIF y complejidad
La serie GPT Image 2.6 incorpora salida SVG, salida de GIF animado y el parámetro complexity. Estas capacidades solo están disponibles en los modelos y canales de proveedores ascendentes que las admiten.
Generar SVG
SVG se usa para generar imágenes, no para editarlas. Al llamar a la API de generación, configura output_format como svg y establece n en 1. Los datos de imagen de la respuesta están en Base64; decodifícalos y guárdalos como un archivo .svg.
{
"model": "YOUR_GPT_IMAGE_2_6_MODEL_ID",
"prompt": "一个简洁的蓝色几何图形标志",
"output_format": "svg",
"n": 1
}
Algunas configuraciones de proveedores ascendentes también pueden requerir un objeto svg adicional, como svg.model. Añádelo solo cuando las instrucciones del modelo o del canal lo requieran explícitamente. No todos los modelos de imágenes ni todos los canales admiten SVG.
Generar GIF animado
Los modelos GPT Image 2.6 que admiten esta capacidad pueden establecer output_format como gif en la API de generación de imágenes. Si el modelo lo admite, puedes usar frame_count y frame_duration_ms para configurar la cantidad de fotogramas y la duración de cada uno. GIF es una capacidad de generación; no des por sentado que la API de edición de imágenes también puede devolver GIF.
{
"model": "YOUR_GPT_IMAGE_2_6_MODEL_ID",
"prompt": "一只蓝色小鸟循环拍打翅膀的动画",
"output_format": "gif",
"frame_count": 6,
"frame_duration_ms": 200
}
Parámetro de complejidad
La serie GPT Image 2.6 admite complexity: low, medium y high. Para modificaciones sencillas, puedes probar un nivel de complejidad bajo; para imágenes con mucho texto o diseños complejos, prueba un nivel más alto. Este parámetro es distinto de quality. Una complejidad mayor puede hacer que la generación tarde más.
{
"model": "YOUR_GPT_IMAGE_2_6_MODEL_ID",
"prompt": "一张细节丰富的城市街景编辑插画",
"complexity": "high",
"quality": "high"
}
Los parámetros anteriores no son compatibles con todos los modelos. Si la API indica que un parámetro no es compatible, quita los parámetros opcionales o comprueba las capacidades del modelo y del canal seleccionados.