Felo API PlatformFelo API Platform
Volver a los modelos

MiniMax H3 Image Highspeed API

MiniMax H3 Image Highspeed es la variante rápida de la línea de generación y edición de imágenes MiniMax H3 Image, con pesos abiertos y hasta 16 imágenes de referencia por generación.

MiniMax H3 Image Highspeed es una variante optimizada para velocidad dentro de la línea MiniMax H3 Image. Acepta texto e imágenes como entrada y produce imágenes, por lo que sirve tanto para generar desde cero a partir de un prompt como para editar material existente. En una sola generación puede combinar hasta 16 imágenes de referencia, lo que facilita mantener la consistencia de personajes y construir escenas con múltiples elementos.

Su modo Highspeed es de 3 a 4 veces más rápido que el modo estándar, y el modo estándar de la familia es de 1,5 a 2 veces más rápido que algunos modelos de la competencia. Genera imágenes en resoluciones nativas cercanas a los 16 megapíxeles y admite relaciones de aspecto de 1:3 a 3:1. Utiliza los mismos parámetros y límites que la versión estándar, y al ser de pesos abiertos puede ejecutarse localmente en hardware modesto; un usuario reportó generar imágenes de 5 a 10 megapíxeles con 16 gigabytes de VRAM.

Es adecuada para generación de texto a imagen, edición de imágenes, carteles, infografías, pantallas de interfaz, materiales de marketing, prototipado rápido y procesamiento por lotes. También rinde en composiciones complejas y en la creación de escenas con varios elementos gracias a la combinación de referencias. Conviene tener en cuenta que su relación de compresión espacial efectiva de 32x puede producir resultados notablemente más borrosos en ciertas resoluciones y que carece de detalle fino; además, resulta pesada por el codificador de texto de 32b.

Actualizado:

ID DEL MODELO

minimax-h3-image-highspeed
Entrada
text / image
Salida
image

Aspectos destacados

  • Modo Highspeed 3 a 4 veces más rápido
  • Hasta 16 imágenes de referencia por generación
  • Resoluciones nativas cercanas a 16 megapíxeles
  • Relaciones de aspecto de 1:3 a 3:1
  • Pesos abiertos y ejecución local
  • Renderiza texto largo y denso

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-highspeed"
}'

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-highspeed",
  "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 Highspeed?

MiniMax H3 Image Highspeed es una variante optimizada para velocidad dentro de la línea MiniMax H3 Image. Acepta texto e imágenes como entrada y produce imágenes, por lo que sirve tanto para generar desde cero a partir de un prompt como para editar material existente. En una sola generación puede combinar hasta 16 imágenes de referencia, lo que facilita mantener la consistencia de personajes y construir escenas con múltiples elementos. Su modo Highspeed es de 3 a 4 veces más rápido que el modo estándar, y el modo estándar de la familia es de 1,5 a 2 veces más rápido que algunos modelos de la competencia. Genera imágenes en resoluciones nativas cercanas a los 16 megapíxeles y admite relaciones de aspecto de 1:3 a 3:1. Utiliza los mismos parámetros y límites que la versión estándar, y al ser de pesos abiertos puede ejecutarse localmente en hardware modesto; un usuario reportó generar imágenes de 5 a 10 megapíxeles con 16 gigabytes de VRAM. Es adecuada para generación de texto a imagen, edición de imágenes, carteles, infografías, pantallas de interfaz, materiales de marketing, prototipado rápido y procesamiento por lotes. También rinde en composiciones complejas y en la creación de escenas con varios elementos gracias a la combinación de referencias. Conviene tener en cuenta que su relación de compresión espacial efectiva de 32x puede producir resultados notablemente más borrosos en ciertas resoluciones y que carece de detalle fino; además, resulta pesada por el codificador de texto de 32b.

¿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 Highspeed?

Admite entrada de texto y de imagen, y produce imágenes como salida. Esto le permite generar imágenes desde un prompt y también editar imágenes existentes.

¿Cuántas imágenes de referencia puede combinar en una generación?

Puede combinar hasta 16 imágenes de referencia en una sola generación, lo que ayuda en composiciones complejas y en la consistencia de personajes.

¿Qué diferencia hay entre Highspeed y la versión estándar?

El modo Highspeed es de 3 a 4 veces más rápido que el modo estándar. Ambos toman los mismos parámetros y límites, y la variante Highspeed es la opción optimizada para velocidad dentro de la línea H3 Image.

¿Qué resolución y relaciones de aspecto maneja?

Genera imágenes en resoluciones nativas cercanas a los 16 megapíxeles y admite relaciones de aspecto de 1:3 a 3:1.

¿Se puede ejecutar localmente?

Sí, es un modelo de pesos abiertos que puede ejecutarse localmente en hardware modesto. Un usuario reportó generar imágenes de 5 a 10 megapíxeles con 16 gigabytes de VRAM.

¿Para qué tareas es más adecuado?

Es adecuado para generación de texto a imagen, edición de imágenes, carteles, infografías, pantallas de interfaz, materiales de marketing, prototipado rápido y procesamiento por lotes, así como para composiciones complejas y escenas con múltiples elementos.

Modelos relacionados