Felo API PlatformFelo API Platform
Volver a los modelos

MiniMax H3 Image API

MiniMax-H3-Image es un modelo de MiniMax que genera imágenes de hasta 4096 por 4096 píxeles y permite editar con múltiples imágenes de referencia.

MiniMax-H3-Image es un modelo de generación y edición de imágenes de MiniMax. Acepta entradas de texto e imagen y produce imágenes de hasta 4096 por 4096 píxeles, es decir, 16 megapíxeles. Admite generación a partir de texto y edición con hasta 16 imágenes de referencia, lo que ofrece un control creativo amplio sobre el resultado final.

El modelo resulta adecuado para tareas como publicidad y branding, comercio electrónico, diseño de producto, UI/UX, videojuegos, arte conceptual, exploración de productos e iteraciones de maquetación. También está pensado para ediciones puntuales que deben mantener coherentes partes del encuadre. Según su documentación, ofrece el mejor seguimiento de instrucciones entre los modelos de código abierto, y la variante H3-Image-Context-IR amplía instrucciones breves en otros idiomas a descripciones detalladas en inglés.

La inferencia usa ajustes fijos: num_inference_steps 6 y guidance_scale 1. El prompt se trunca a 4096 tokens y no se admiten prompts negativos. El área mínima de generación va de 1024 a 16777216 píxeles, con un valor predeterminado de 4194304 (2048 por 2048); si se solicita un tamaño menor, la imagen se genera en un lienzo mayor con la misma relación de aspecto y se redimensiona con interpolación LANCZOS. Se distribuye bajo la MiniMax-H3-Image Community License Agreement.

Actualizado:

ID DEL MODELO

minimax-h3-image
Entrada
text / image
Salida
image

Aspectos destacados

  • Salida de 16 megapíxeles a 4096 por 4096
  • Edición con hasta 16 imágenes de referencia
  • Generación texto-imagen y edición multirreferencia
  • Ajustes de inferencia fijos y sencillos
  • Prompt truncado a 4096 tokens
  • Licencia comunitaria de MiniMax

Proveedores

1 proveedores

Compara los precios de API entre proveedores. Selecciona un proveedor para ver todos los cargos y condiciones.

Proveedor · Detalles de precio
Disponibilidad

Inicio rápido

Envía una tarea de imagen, consulta su estado y guarda las imágenes. Los ejemplos usan curl y la biblioteca estándar de Python 3.

POST https://openapi.felo.ai/api/v1/images/generations

1Configura tu clave de API

Crea una clave en tu cuenta de Felo API Platform y configúrala como variable de entorno.

export FELO_API_KEY="YOUR_API_KEY"

2Haz tu primera solicitud

Los valores opcionales dependen del modelo y se omiten en el ejemplo. Confírmalos en Playground. Los campos van al mismo nivel que model y prompt, sin envoltorio input.

curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -o created.json \
  -d '{
  "prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
  "model": "minimax-h3-image"
}'

3Consultar tarea

La respuesta incluye task_id. Consulta cada 3 segundos mientras esté queued o running; termina con succeeded, failed o interrupted. Espera máxima: 30 minutos. Conserva created.json para continuar sin volver a enviar la tarea.

python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen

task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800

while task["status"] in ("queued", "running"):
    if time.monotonic() >= deadline:
        raise TimeoutError(f"Keep task_id={task_id} to resume polling")
    time.sleep(3)
    with urlopen(Request(url, headers=headers), timeout=60) as response:
        task = json.load(response)
    if task.get("task_id") != task_id or task.get("kind") != "image":
        raise ValueError("Unexpected task response")
    print(task["status"])

if task["status"] != "succeeded":
    raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
    raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY

4Descargar salida

Tras el éxito, guarda outputs de task.json. Admite URL HTTPS, objetos URL y b64_json. Descarga pronto las URL firmadas; no necesitas la clave API para descargar imágenes.

python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen

task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
    raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}

for index, output in enumerate(task["outputs"], 1):
    item = output if isinstance(output, dict) else {}
    url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
    mime = item.get("media_type") or "image/png"
    if url and url.startswith("https://"):
        with urlopen(url, timeout=60) as response:
            data = response.read()
            mime = response.headers.get_content_type()
    elif url and url.startswith("data:image/") and ";base64," in url:
        header, encoded = url.split(",", 1)
        mime = header[5:].split(";", 1)[0]
        data = base64.b64decode(encoded, validate=True)
    elif item.get("b64_json"):
        data = base64.b64decode(item["b64_json"], validate=True)
    else:
        raise ValueError("Unrecognized image output")
    path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
    path.write_bytes(data)
    print(path)
PY
input_references

Para editar imágenes, sustituye la URL de ejemplo por tu URL HTTPS o una data URL de imagen en base64. Envía una vez y sigue los mismos pasos de consulta y guardado.

curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -o created.json \
  -d '{
  "prompt": "Keep the product and framing. Replace the background with a sunlit marble countertop.",
  "model": "minimax-h3-image",
  "input_references": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/product.png"
      }
    }
  ]
}'

Parámetros compatibles

  • n
  • size
  • resolution
  • aspect_ratio
  • output_format
  • input_references

¿Prefieres la referencia completa?

Referencia de la API →

Preguntas frecuentes

¿Qué es MiniMax H3 Image?

MiniMax-H3-Image es un modelo de generación y edición de imágenes de MiniMax. Acepta entradas de texto e imagen y produce imágenes de hasta 4096 por 4096 píxeles, es decir, 16 megapíxeles. Admite generación a partir de texto y edición con hasta 16 imágenes de referencia, lo que ofrece un control creativo amplio sobre el resultado final. El modelo resulta adecuado para tareas como publicidad y branding, comercio electrónico, diseño de producto, UI/UX, videojuegos, arte conceptual, exploración de productos e iteraciones de maquetación. También está pensado para ediciones puntuales que deben mantener coherentes partes del encuadre. Según su documentación, ofrece el mejor seguimiento de instrucciones entre los modelos de código abierto, y la variante H3-Image-Context-IR amplía instrucciones breves en otros idiomas a descripciones detalladas en inglés. La inferencia usa ajustes fijos: num_inference_steps 6 y guidance_scale 1. El prompt se trunca a 4096 tokens y no se admiten prompts negativos. El área mínima de generación va de 1024 a 16777216 píxeles, con un valor predeterminado de 4194304 (2048 por 2048); si se solicita un tamaño menor, la imagen se genera en un lienzo mayor con la misma relación de aspecto y se redimensiona con interpolación LANCZOS. Se distribuye bajo la MiniMax-H3-Image Community License Agreement.

¿Cómo se cobra el uso?

Tu factura depende del proveedor que uses, de sus precios y de tu uso. Las entradas más largas u otras condiciones pueden tener precios distintos. Se factura según el costo real de generación. Consulta tu factura para el importe final.

¿Qué tipos de entrada admite MiniMax-H3-Image?

Admite entradas de texto y de imagen, y produce imágenes como salida. Esto cubre tanto la generación a partir de texto como la edición con imágenes de referencia.

¿Cuántas imágenes de referencia puedo usar al editar?

La edición con múltiples referencias admite hasta 16 imágenes de referencia.

¿Qué resolución de salida alcanza?

Genera imágenes de hasta 4096 por 4096 píxeles, lo que equivale a 16 megapíxeles.

¿Puedo cambiar los pasos de inferencia o la escala de guiado?

No. Los ajustes son fijos: num_inference_steps 6 y guidance_scale 1. Cualquier otro valor devuelve un error HTTP 400.

¿Se admiten prompts negativos?

No, los prompts negativos no son compatibles y se rechazan.

¿En qué se diferencia de MiniMax-H3-Image-PE?

MiniMax-H3-Image-PE es una variante que se puede desplegar localmente y ejecutar con un servidor SGLang local.

Modelos relacionados