OneMux/Documentación/Modelos de imágenes

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ámetroObligatorioDescripción
modelSíID de un modelo de imágenes disponible actualmente
promptSíDescripción del contenido de la imagen
sizeNoTamaño de la imagen; el modelo determina los valores admitidos
qualityNoCalidad de la imagen; el modelo determina los valores admitidos
nNoCantidad de imágenes generadas; el modelo determina el rango admitido
response_formatNob64_json o url; solo está disponible en los modelos compatibles
backgroundNoFondo transparente u opaco; solo está disponible en los modelos compatibles
output_formatNopng, 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.