MiniMax H3 Image API
MiniMax H3 Image es el modelo de generación y edición de imágenes de MiniMax, lanzado el 11 de noviembre de 2026. En APIMart lo llamas con el ID de modelo minimax-h3-image para texto a imagen y edición con imágenes de referencia en 1K, 2K o 4K.
Aspectos destacados del servicio
- Descuentos Oficiales
- Pago por uso
- Rápido y baja latencia
Image link valid for 72 hours
Precios de MiniMax H3 Image API
Precios transparentes sin tarifas ocultas. Paga solo por lo que uses.
| Variante | Nivel | Precio OroPrecio actual | Precio Platino | Precio Diamante | Precio oficial | Tu ahorro |
|---|---|---|---|---|---|---|
minimax-h3-imageLos precios son estimados; el costo real se factura por tokens. | 1K/2K | 0.1891Credits/img~$0.0189/img | 0.1797Credits/img~$0.018/img | 0.1702Credits/img~$0.017/img | 0.2364Credits/img~$0.0236/img | 20% |
| 4K | 0.628Credits/img~$0.0628/img | 0.5966Credits/img~$0.0597/img | 0.5652Credits/img~$0.0565/img | 0.785Credits/img~$0.0785/img | 20% |
* Los costos reales dependen del resultado final.
* Se cobra por tokens. Las filas son estimaciones de texto a imagen para una sola imagen: la salida de imagen más unos 2.000 tokens de entrada de texto por la mejora del prompt. Las imágenes de referencia añaden tokens de entrada de imagen. El campo cost de cada tarea muestra el cargo real.
MiniMax H3 Image API: texto a imagen y edición de imágenes hasta 4K
Genera imágenes a partir de un prompt o edita con hasta 16 imágenes de referencia. Elige 1K, 2K o 4K con cualquier relación de aspecto entre 1:3 y 3:1, o indica los píxeles exactos, hasta 20 millones. Una solicitud devuelve hasta 10 imágenes, y la mejora del prompt integrada amplía por ti los prompts cortos.
MiniMax H3 Image API: ejemplo de texto a imagen y edición de imágenes
Llama a MiniMax H3 Image en APIMart con una sola solicitud POST. La generación es asíncrona: envía una tarea y luego consulta el endpoint de tareas para obtener las URL de las imágenes.
- 1
Autentica las solicitudes a MiniMax H3 Image API
Guarda tu key de APIMart en la variable de entorno APIMART_API_KEY y envíala como Authorization: Bearer <key> en cada solicitud.
- 2
Envía una tarea de MiniMax H3 Image
Envía POST /v1/images/generations con model minimax-h3-image, tu prompt, size y resolution. Añade image_urls para editar con imágenes de referencia. El ID de la tarea está en data[0].task_id.
- 3
Obtén las imágenes generadas
Consulta GET /v1/tasks/{task_id} cada 3 a 5 segundos hasta que status sea completed y luego lee las URL de las imágenes en data.result.images[0].url. Los resultados se conservan 72 horas, así que descárgalos a tiempo.
Consulta la documentación de MiniMax H3 Image API para ver todos los parámetros, las reglas de tamaño y los campos de la respuesta.
curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-image",
"prompt": "Una cafetería acogedora junto al mar al atardecer, fotorrealista, tonos cálidos",
"size": "16:9",
"resolution": "2K"
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "minimax-h3-image",
"prompt": "Una cafetería acogedora junto al mar al atardecer, fotorrealista, tonos cálidos",
"size": "16:9",
"resolution": "2K"
}
resp = requests.post(f"{API_BASE}/v1/images/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
# 2. Poll the task until it finishes
for _ in range(200):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()["data"]
if task["status"] == "completed":
print(task["result"]["images"][0]["url"][0])
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
time.sleep(3)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-image",
"prompt": "Ponle a la persona de la primera imagen la chaqueta de la segunda imagen y deja el fondo sin cambios",
"image_urls": [
"https://example.com/person.jpg",
"https://example.com/jacket.png"
],
"resolution": "2K"
}'TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"Parámetros de MiniMax H3 Image API
| Parámetro | Tipo | Obligatorio | Por defecto | Descripción |
|---|---|---|---|---|
model | string | Sí | Por defecto: minimax-h3-image | Usa minimax-h3-image. |
prompt | string | Sí | Por defecto: — | Descripción de la imagen, de 1 a 32.000 caracteres tras eliminar los espacios iniciales y finales. |
size | string | Opcional | Por defecto: auto | auto, una relación de aspecto como 16:9 (de 1:3 a 3:1) o píxeles como 2048x1152 (de 655.360 a 20.000.000 píxeles en total). |
aspect_ratio | string | Opcional | Por defecto: — | Otra forma de enviar la relación de aspecto, por ejemplo 16:9. Si se indica, prevalece sobre size. |
resolution | string | Opcional | Por defecto: 4K | 1K, 2K o 4K. No se puede usar cuando size está en píxeles. |
n | integer | Opcional | Por defecto: 1 | Número de imágenes, de 1 a 10. |
image_urls | string[] | Opcional | Por defecto: — | Hasta 16 imágenes de referencia como URL o data URI en Base64. Al añadirlas se pasa al modo de edición. |
prompt_optimizer | boolean | Opcional | Por defecto: true | Amplía el prompt antes de generar. false solo funciona en texto a imagen con un size explícito. |
output_format | string | Opcional | Por defecto: jpeg | jpeg, png o webp. |
output_compression | integer | Opcional | Por defecto: 95 | Calidad de compresión de 0 a 100. Se ignora con png. |
watermark | boolean | Opcional | Por defecto: false | Añade a la imagen una marca de agua visible de contenido generado por IA. |
