Felo API PlatformFelo API Platform
Kembali ke model

MiniMax H3 Image Highspeed API

MiniMax H3 Image Highspeed adalah model gambar open-weights dari MiniMax yang menghasilkan dan mengedit gambar dari teks maupun gambar, dengan mode kecepatan tinggi 3–4 kali lebih cepat dari mode standar.

MiniMax H3 Image Highspeed adalah varian yang dioptimalkan untuk kecepatan dalam lini MiniMax H3 Image. Model ini menerima input teks dan gambar serta menghasilkan gambar, sehingga bisa dipakai untuk pembuatan gambar dari prompt maupun penyuntingan gambar yang sudah ada. Sebagai model open-weights, model ini dapat dijalankan sendiri, termasuk secara lokal pada perangkat keras yang tergolong sederhana menurut laporan pengguna, misalnya kartu grafis 6 GB dengan RAM sistem 16 GB untuk resolusi 2 megapiksel ke atas pada 20 langkah lebih.

Keunggulan utamanya ada pada kecepatan: mode Highspeed diklaim 3 sampai 4 kali lebih cepat daripada mode standar, sementara mode standar sendiri 1,5 sampai 2 kali lebih cepat dari sejumlah model pesaing. Model ini menghasilkan gambar pada resolusi asli sekitar 16 megapiksel dan mendukung rasio aspek dari 1:3 hingga 3:1. Satu generasi dapat menggabungkan hingga 16 gambar referensi, membaca prompt panjang, dan merender teks panjang yang padat, sehingga cocok untuk poster, infografis, layar UI, materi pemasaran, prototipe cepat, pemrosesan batch, komposisi kompleks, serta menjaga konsistensi karakter dalam adegan multi-elemen.

Ada beberapa keterbatasan yang perlu diperhatikan. Rasio kompresi spasial efektif 32x membuat hasil bisa jauh lebih buram pada resolusi tertentu, dan detail halus kadang kurang tajam. Model ini juga tergolong berat karena memakai encoder teks 32b, dan parameter serta batasannya sama persis dengan versi standar.

Diperbarui:

ID MODEL

minimax-h3-image-highspeed
Masukan
text / image
Keluaran
image

Sorotan

  • Mode Highspeed 3–4 kali lebih cepat
  • Resolusi asli sekitar 16 megapiksel
  • Rasio aspek 1:3 hingga 3:1
  • Hingga 16 gambar referensi
  • Model open-weights
  • Merender teks panjang dan padat

Penyedia

1 penyedia

Bandingkan harga API antarpenyedia. Pilih penyedia untuk melihat semua biaya dan ketentuan.

Penyedia · Detail harga
Ketersediaan

Mulai cepat

Kirim tugas gambar, periksa status, lalu simpan gambar. Contoh menggunakan curl dan pustaka standar Python 3.

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

1Siapkan kunci API

Buat kunci dari akun Felo API Platform Anda dan tetapkan sebagai variabel lingkungan.

export FELO_API_KEY="YOUR_API_KEY"

2Kirim permintaan pertama

Nilai opsional berbeda per model dan tidak ditetapkan di sini. Periksa di Playground. Kolom sejajar dengan model dan prompt, tanpa pembungkus 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"
}'

3Polling tugas

Pengiriman mengembalikan task_id. Periksa setiap 3 detik saat queued atau running; berhenti saat succeeded, failed, atau interrupted. Tunggu maksimal 30 menit. Simpan created.json untuk melanjutkan pemeriksaan tanpa mengirim ulang.

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

4Unduh output

Setelah berhasil, simpan outputs dari task.json. Mendukung URL HTTPS, objek URL, dan b64_json. Segera unduh URL bertanda tangan; unduhan gambar tidak memerlukan kunci API.

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

Untuk mengedit gambar, ganti URL contoh dengan URL gambar HTTPS atau data URL gambar base64 Anda. Kirim sekali, lalu ikuti langkah pemeriksaan dan penyimpanan yang sama.

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

Parameter yang didukung

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

Ingin referensi lengkap?

Referensi API →

Pertanyaan umum

Mengenal MiniMax H3 Image Highspeed?

MiniMax H3 Image Highspeed adalah varian yang dioptimalkan untuk kecepatan dalam lini MiniMax H3 Image. Model ini menerima input teks dan gambar serta menghasilkan gambar, sehingga bisa dipakai untuk pembuatan gambar dari prompt maupun penyuntingan gambar yang sudah ada. Sebagai model open-weights, model ini dapat dijalankan sendiri, termasuk secara lokal pada perangkat keras yang tergolong sederhana menurut laporan pengguna, misalnya kartu grafis 6 GB dengan RAM sistem 16 GB untuk resolusi 2 megapiksel ke atas pada 20 langkah lebih. Keunggulan utamanya ada pada kecepatan: mode Highspeed diklaim 3 sampai 4 kali lebih cepat daripada mode standar, sementara mode standar sendiri 1,5 sampai 2 kali lebih cepat dari sejumlah model pesaing. Model ini menghasilkan gambar pada resolusi asli sekitar 16 megapiksel dan mendukung rasio aspek dari 1:3 hingga 3:1. Satu generasi dapat menggabungkan hingga 16 gambar referensi, membaca prompt panjang, dan merender teks panjang yang padat, sehingga cocok untuk poster, infografis, layar UI, materi pemasaran, prototipe cepat, pemrosesan batch, komposisi kompleks, serta menjaga konsistensi karakter dalam adegan multi-elemen. Ada beberapa keterbatasan yang perlu diperhatikan. Rasio kompresi spasial efektif 32x membuat hasil bisa jauh lebih buram pada resolusi tertentu, dan detail halus kadang kurang tajam. Model ini juga tergolong berat karena memakai encoder teks 32b, dan parameter serta batasannya sama persis dengan versi standar.

Bagaimana penggunaan ditagih?

Tagihan Anda bergantung pada penyedia yang digunakan, tarifnya, dan penggunaan Anda. Masukan yang lebih panjang atau ketentuan lain dapat memiliki harga berbeda. Ditagih berdasarkan biaya pembuatan sebenarnya. Lihat tagihan Anda untuk jumlah akhir.

Input apa saja yang didukung MiniMax H3 Image Highspeed?

Model ini menerima input teks dan input gambar, lalu menghasilkan gambar sebagai keluaran.

Berapa banyak gambar referensi yang bisa digabungkan dalam satu generasi?

Satu generasi dapat menggabungkan hingga 16 gambar referensi.

Apa perbedaan MiniMax H3 Image Highspeed dengan versi standar?

Mode Highspeed berjalan 3 sampai 4 kali lebih cepat daripada mode standar, tetapi memakai parameter dan batasan yang sama.

Apakah model ini bisa dijalankan secara lokal?

Ya, model ini open-weights dan dapat berjalan lokal pada perangkat keras sederhana. Seorang pengguna melaporkan menghasilkan gambar 5 sampai 10 megapiksel dengan VRAM 16 GB.

Resolusi dan rasio aspek apa yang didukung?

Model menghasilkan gambar pada resolusi asli sekitar 16 megapiksel dan mendukung rasio aspek dari 1:3 hingga 3:1.

Model terkait