Felo API PlatformFelo API Platform
Modellere dön

MiniMax H3 Image API

MiniMax-H3-Image, 4096 x 4096 piksele kadar görsel üreten, 16 referans görselle düzenlemeyi destekleyen ve güçlü talimat takibi sunan bir görsel modelidir.

MiniMax-H3-Image, MiniMax tarafından geliştirilen ve metin ile görsel girdilerini alıp görsel çıktısı üreten bir modeldir. 4096 x 4096 piksel, yani 16 megapiksellik çözünürlükte görsel üretebilir. Metinden görsel üretiminin yanı sıra 16 adede kadar referans görselle çok referanslı görsel düzenlemeyi destekler. Belgeler, modelin açık kaynak modeller arasında en güçlü talimat takibini sunduğunu belirtir.

Model, reklam ve marka çalışmaları, e-ticaret, ürün tasarımı, UI/UX, oyun geliştirme ve konsept sanat gibi alanlarda kullanılabilir. Ürün keşfi, yerleşim iterasyonları ve karenin bazı bölümlerini tutarlı tutan odaklı düzenlemeler için de uygundur. Pratik hesaplama maliyetinde yüksek çözünürlüklü çıktı, zengin detay ve gerçekçilik ile çok referanslı görseller aracılığıyla güçlü yaratıcı kontrol sunar.

Çıkarım ayarları sabittir: num_inference_steps 6 ve guidance_scale 1 olarak kullanılır. Negatif istemler desteklenmez ve reddedilir. Bu sabit değerlerin dışındaki num_inference_steps ve guidance_scale değerleri HTTP 400 hatası döndürür. İstemler 4096 tokene kadar kesilir. H3-Image-Context-IR, diğer dillerdeki kısa istemleri ayrıntılı İngilizce açıklamalara genişletir. Model, MiniMax-H3-Image Community License Agreement kapsamında yayımlanmıştır.

Güncellendi:

MODEL ID

minimax-h3-image
Giriş
text / image
Çıkış
image

Öne çıkanlar

  • 16 megapiksel çözünürlük
  • 16 referans görsele kadar düzenleme
  • Güçlü talimat takibi
  • Sabit çıkarım ayarları
  • Çok dilli istem genişletme

Sağlayıcılar

1 sağlayıcı

Sağlayıcılar arasındaki API fiyatlarını karşılaştırın. Tüm ücretleri ve koşulları görmek için bir sağlayıcı seçin.

Sağlayıcı · Fiyat ayrıntıları
Kullanılabilirlik

Hızlı başlangıç

Görsel görevini gönderin, durumunu sorgulayın ve görselleri kaydedin. Örnekler curl ve Python 3 standart kitaplığını kullanır.

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

1API anahtarınızı alın

Felo API Platform hesabınızdan bir anahtar oluşturun ve ortam değişkeni olarak ayarlayın.

export FELO_API_KEY="YOUR_API_KEY"

2İlk isteğinizi yapın

İsteğe bağlı değerler modele göre değişir ve burada ayarlanmaz. Playground’da doğrulayın. Alanlar input içinde değil, model ve prompt ile aynı düzeydedir.

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

3Görevi yokla

Gönderim task_id döndürür. queued veya running durumunda 3 saniyede bir sorgulayın; succeeded, failed veya interrupted durumunda durun. En fazla 30 dakika bekleyin. Yeniden göndermeden sorgulamayı sürdürmek için created.json dosyasını saklayın.

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

4Çıktıyı indir

Başarıdan sonra task.json içindeki outputs verilerini kaydedin. HTTPS URL, URL nesnesi ve b64_json desteklenir. İmzalı URL’leri gecikmeden indirin; görsel indirmek API anahtarı gerektirmez.

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

Düzenleme için örnek URL’yi kendi HTTPS görsel URL’niz veya base64 görsel data URL’nizle değiştirin. Bir kez gönderip aynı sorgulama ve kaydetme adımlarını izleyin.

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

Desteklenen parametreler

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

Tam referansı mı tercih edersiniz?

API referansı →

Sık sorulan sorular

Model tanıtımı: MiniMax H3 Image?

MiniMax-H3-Image, MiniMax tarafından geliştirilen ve metin ile görsel girdilerini alıp görsel çıktısı üreten bir modeldir. 4096 x 4096 piksel, yani 16 megapiksellik çözünürlükte görsel üretebilir. Metinden görsel üretiminin yanı sıra 16 adede kadar referans görselle çok referanslı görsel düzenlemeyi destekler. Belgeler, modelin açık kaynak modeller arasında en güçlü talimat takibini sunduğunu belirtir. Model, reklam ve marka çalışmaları, e-ticaret, ürün tasarımı, UI/UX, oyun geliştirme ve konsept sanat gibi alanlarda kullanılabilir. Ürün keşfi, yerleşim iterasyonları ve karenin bazı bölümlerini tutarlı tutan odaklı düzenlemeler için de uygundur. Pratik hesaplama maliyetinde yüksek çözünürlüklü çıktı, zengin detay ve gerçekçilik ile çok referanslı görseller aracılığıyla güçlü yaratıcı kontrol sunar. Çıkarım ayarları sabittir: num_inference_steps 6 ve guidance_scale 1 olarak kullanılır. Negatif istemler desteklenmez ve reddedilir. Bu sabit değerlerin dışındaki num_inference_steps ve guidance_scale değerleri HTTP 400 hatası döndürür. İstemler 4096 tokene kadar kesilir. H3-Image-Context-IR, diğer dillerdeki kısa istemleri ayrıntılı İngilizce açıklamalara genişletir. Model, MiniMax-H3-Image Community License Agreement kapsamında yayımlanmıştır.

Kullanım nasıl faturalandırılır?

Faturanız kullandığınız sağlayıcıya, fiyatlarına ve kullanımınıza bağlıdır. Daha uzun girişler veya başka koşullar farklı fiyatlara tabi olabilir. Gerçek üretim maliyetine göre faturalandırılır. Kesin tutar için faturanızı kontrol edin.

MiniMax-H3-Image hangi girdi türlerini destekler?

Metin ve görsel girdilerini kabul eder; metinden görsel üretimi ve çok referanslı görsel düzenleme yapabilir.

Kaç referans görsel kullanılabilir?

Görsel düzenleme için 16 adede kadar referans görsel desteklenir.

Çıktı çözünürlüğü nedir?

Model 4096 x 4096 piksel, yani 16 megapiksellik görseller üretebilir.

İstem uzunluğu sınırı var mı?

İstemler 4096 tokene kadar kesilir; bu sınırı aşan kısımlar dikkate alınmaz.

MiniMax-H3-Image ile MiniMax-H3-Image-PE arasındaki fark nedir?

MiniMax-H3-Image-PE, yerel bir SGLang sunucusuyla çalıştırılabilen yerel olarak dağıtılabilir bir varyanttır.

Negatif istem kullanılabilir mi?

Hayır, negatif istemler desteklenmez ve reddedilir.

İlgili modeller