MiniMax H3 Image Highspeed

Ejemplo rápido

Envía una solicitud de imagen, guarda el id devuelto y consulta el estado hasta que la tarea sea completed o failed. Esta API utiliza tareas asíncronas y resultados mediante URL.

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"minimax-h3-image-highspeed","prompt":"An amber bottle on pale limestone in soft morning light","area":"1K","aspect_ratio":"3:2"}'

Endpoint y encabezados

POST https://api.seedrouter.ai/v1/images/generations

Guarda la clave en tu servidor. Una respuesta HTTP correcta confirma la recepción de una tarea; no significa que su imagen esté lista.

Parámetros

Se aceptan 13 campos. Solo model y prompt son obligatorios. Omite los campos opcionales para usar los valores predeterminados; ningún campo acepta null. El Playground ofrece el modelo fijo y diez entradas editables. El formato de respuesta URL y la entrega de tareas sin streaming son fijos.

Dependencias de tamaño y prompt

Un size explícito debe contener dimensiones enteras positivas con un área entre 655.360 y 20.000.000 de píxeles, ambos límites incluidos. El ancho dividido por el alto debe estar entre 1/3 y 3. Por ejemplo, 2048x1152 es válido. Al usar dimensiones explícitas, omite tanto aspect_ratio como area, aunque su valor fuera auto.

Si omites el tamaño o usas auto, utiliza aspect_ratio y area juntos. El área es un tamaño objetivo; revisa el archivo entregado para conocer las dimensiones exactas. No representa un precio fijo por imagen.

Configurar disable_prompt_enhanced: true requiere un tamaño explícito en píxeles o una relación de aspecto fija. Con la mejora desactivada, el modelo lee aproximadamente los primeros 4096 tokens del prompt. El límite de envío de 32.000 caracteres sigue vigente. La edición siempre mejora los prompts, por lo que se rechaza true cuando hay images.

No se aceptan campos de máscara, semilla, estilo, calidad, prompt negativo, fondo ni resolución independiente. Los parámetros desconocidos devuelven un error antes del envío. Esta API no ofrece streaming, imágenes base64 ni salida WebP.

Imágenes de referencia

Usa URL HTTP(S) accesibles públicamente sin credenciales incrustadas. Cada imagen debe ser JPEG, PNG, WebP, HEIC o HEIF; tener como máximo 64 MiB; 128–8192 píxeles en cada lado; y una proporción entre el lado largo y el corto de como máximo 4. Mantén el cuerpo JSON en 64 MiB o menos. Los archivos de imagen se referencian mediante URL; sus bytes no se incrustan en el cuerpo JSON.

Asigna un propósito claro a cada referencia y describe qué debe permanecer sin cambios. El orden de la matriz identifica <Picture 1>, <Picture 2> y así sucesivamente.

{
  "model": "minimax-h3-image-highspeed",
  "prompt": "Use <Picture 1> as the product and <Picture 2> as the setting. Preserve the product's shape and label. Match the setting's light and perspective.",
  "images": [
    {"image_url": "https://example.com/product.jpg"},
    {"image_url": "https://example.com/setting.jpg"}
  ],
  "aspect_ratio": "3:2",
  "area": "2K",
  "n": 1,
  "output_format": "png"
}

Sustituye las URL ilustrativas por tus propios archivos de imagen accesibles.

Facturación

La facturación tiene tres categorías de tokens: entrada de texto, entrada de imagen y salida de imagen. Multiplica el uso real de cada categoría por su tarifa vigente. La cantidad de resultados, las dimensiones de las imágenes y las imágenes de referencia afectan al uso; los nombres de resolución no definen una factura fija. Las solicitudes fallidas no se cobran. Consulta los precios actuales.

Respuesta de la tarea y consultas de estado

Una solicitud aceptada devuelve una tarea asíncrona:

{"id":"task_example","model":"minimax-h3-image-highspeed","status":"processing"}

curl https://api.seedrouter.ai/v1/tasks/task_example \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Una respuesta completada contiene URL de imágenes en output.data. Cada imagen entregada incluye su size y puede incluir revised_prompt (la descripción mejorada). output.created es la hora de creación en segundos Unix, y output.output_format identifica el formato entregado. output.usage expone los recuentos de tokens de entrada de texto, entrada de imagen y salida de imagen, así como la cantidad de generated_images entregadas. Las URL y los ID siguientes son ilustrativos:

{
  "id": "task_example",
  "model": "minimax-h3-image-highspeed",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.jpg"}]}
}

Consulta el estado cada 10–20 segundos. Un tiempo de espera agotado del cliente no significa que la tarea haya fallado: conserva su ID y sigue consultando en lugar de enviar una solicitud duplicada. Las respuestas públicas no contienen saldos de cuenta ni costes.

Errores

Los errores HTTP usan {"error":{"code":integer,"message":string}}. Una tarea fallida tiene status: "failed" y un error. Corrige los parámetros no válidos antes de un nuevo envío. Consulta el directorio de errores compartido y el ciclo de vida de la tarea.

Páginas relacionadas

• Playground y precios de MiniMax H3 Image Highspeed
• MiniMax H3 Image