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
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.
| Kullanılabilirlik | |
|---|---|
Geçmiş istatistikler canlı durum kontrolü değildir. Eksik veri kesinti anlamına gelmez.
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")
PY4Çı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)
PYinput_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.