Felo API PlatformFelo API Platform
العودة إلى النماذج

MiniMax H3 Image API

نموذج صور من MiniMax يتيح توليد الصور وتحريرها بدقة تصل إلى 4096 في 4096 بكسل مع دعم حتى 16 صورة مرجعية والالتزام القوي بالتعليمات.

MiniMax-H3-Image هو نموذج من MiniMax لتوليد الصور وتحريرها، يقبل النصوص والصور كمدخلات وينتج صورًا. يدعم التوليد من النص وتحرير الصور باستخدام حتى 16 صورة مرجعية، ما يتيح تحكمًا إبداعيًا واسعًا مع الحفاظ على اتساق أجزاء من الإطار عند إجراء تعديلات محددة. يصل حجم الصورة المولدة إلى 4096 في 4096 بكسل (16 ميغابكسل)، وهو ما يجعله مناسبًا للأعمال التي تتطلب تفاصيل غنية وواقعية عالية.

تتضمن الاستخدامات المعلنة الإعلان والعلامات التجارية والتجارة الإلكترونية وتصميم المنتجات وواجهات المستخدم وتجربة المستخدم والألعاب والفن التصوري واستكشاف المنتجات وتكرارات التخطيط. ويشير التوثيق إلى أن النموذج يتمتع بأقوى اتباع للتعليمات بين النماذج مفتوحة المصدر، كما أن H3-Image-Context-IR يوسّع المطالبات القصيرة بلغات أخرى إلى أوصاف إنجليزية مفصلة.

يعمل النموذج بإعدادات استنتاج ثابتة هي num_inference_steps 6 وguidance_scale 1، ولا يدعم المطالبات السلبية ويرفضها. تُقتطع المطالبات عند 4096 رمزًا، ويُرجع أي قيمة مختلفة عن القيم الثابتة لـ num_inference_steps وguidance_scale خطأ HTTP 400. يتوفر تحت اتفاقية ترخيص MiniMax-H3-Image Community License Agreement، ويتطلب الاستخدام التجاري الذي يحتاج إلى إذن كتابي منفصل طلبًا عبر platform.minimax.io/license.

آخر تحديث:

MODEL ID

minimax-h3-image
الإدخال
text / image
الإخراج
image

أبرز الميزات

  • توليد صور بدقة 16 ميغابكسل
  • تحرير الصور مع حتى 16 مرجعًا
  • اتباع قوي للتعليمات
  • تحكم إبداعي عبر صور مرجعية متعددة
  • إعدادات استنتاج ثابتة
  • توسيع المطالبات قصيرة اللغة

المزوّدون

1 مزوّدون

قارن أسعار API بين المزوّدين. اختر مزوّدًا لعرض جميع الرسوم والشروط.

المزوّد · تفاصيل التسعير
التوافر

البدء السريع

أرسل مهمة صورة، ثم استعلم عن حالتها واحفظ الصور. تستخدم الأمثلة curl ومكتبة Python 3 القياسية فقط.

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

1احصل على مفتاح API

أنشئ مفتاحًا من حسابك على Felo API Platform وعيّنه كمتغير بيئة.

export FELO_API_KEY="YOUR_API_KEY"

2أرسل طلبك الأول

تختلف القيم الاختيارية حسب النموذج ولا تُضبط هنا. تحقق منها في Playground. توضع الحقول بجانب model وprompt دون تغليفها داخل 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"
}'

3الاستعلام عن المهمة

يعيد الإرسال task_id. استعلم كل 3 ثوانٍ أثناء queued أو running، وتوقف عند succeeded أو failed أو interrupted. الحد الأقصى للانتظار 30 دقيقة. احتفظ بملف created.json لاستئناف الاستعلام دون إعادة الإرسال.

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تنزيل الإخراج

بعد النجاح، احفظ outputs من task.json. تُدعم روابط HTTPS وكائنات URL وb64_json. نزّل الروابط الموقعة سريعًا؛ تنزيل الصور لا يحتاج إلى مفتاح 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

لتعديل الصور، استبدل الرابط التجريبي برابط صورتك HTTPS أو data URL لصورة base64. أرسل مرة واحدة ثم اتبع خطوات الاستعلام والحفظ نفسها.

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

المعاملات المدعومة

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

تفضّل المرجع الكامل؟

مرجع API →

الأسئلة الشائعة

ما هو MiniMax H3 Image?

MiniMax-H3-Image هو نموذج من MiniMax لتوليد الصور وتحريرها، يقبل النصوص والصور كمدخلات وينتج صورًا. يدعم التوليد من النص وتحرير الصور باستخدام حتى 16 صورة مرجعية، ما يتيح تحكمًا إبداعيًا واسعًا مع الحفاظ على اتساق أجزاء من الإطار عند إجراء تعديلات محددة. يصل حجم الصورة المولدة إلى 4096 في 4096 بكسل (16 ميغابكسل)، وهو ما يجعله مناسبًا للأعمال التي تتطلب تفاصيل غنية وواقعية عالية. تتضمن الاستخدامات المعلنة الإعلان والعلامات التجارية والتجارة الإلكترونية وتصميم المنتجات وواجهات المستخدم وتجربة المستخدم والألعاب والفن التصوري واستكشاف المنتجات وتكرارات التخطيط. ويشير التوثيق إلى أن النموذج يتمتع بأقوى اتباع للتعليمات بين النماذج مفتوحة المصدر، كما أن H3-Image-Context-IR يوسّع المطالبات القصيرة بلغات أخرى إلى أوصاف إنجليزية مفصلة. يعمل النموذج بإعدادات استنتاج ثابتة هي num_inference_steps 6 وguidance_scale 1، ولا يدعم المطالبات السلبية ويرفضها. تُقتطع المطالبات عند 4096 رمزًا، ويُرجع أي قيمة مختلفة عن القيم الثابتة لـ num_inference_steps وguidance_scale خطأ HTTP 400. يتوفر تحت اتفاقية ترخيص MiniMax-H3-Image Community License Agreement، ويتطلب الاستخدام التجاري الذي يحتاج إلى إذن كتابي منفصل طلبًا عبر platform.minimax.io/license.

كيف تُحتسب فاتورة الاستخدام؟

تعتمد فاتورتك على المزوّد الذي تستخدمه وأسعاره واستخدامك. قد تختلف الأسعار مع المدخلات الأطول أو الشروط الأخرى. تُحتسب الفاتورة وفق تكلفة التوليد الفعلية. راجع فاتورتك للمبلغ النهائي.

ما أنواع المدخلات التي يدعمها MiniMax-H3-Image؟

يدعم إدخال النص وإدخال الصور، وينتج صورًا. يمكنه التوليد من النص وتحرير الصور باستخدام حتى 16 صورة مرجعية.

ما أقصى دقة للصورة الناتجة؟

يولد صورًا بحجم 4096 في 4096 بكسل، أي 16 ميغابكسل. ويمكن ضبط min_generation_area من 1024 إلى 16777216 بكسل، والقيمة الافتراضية 4194304 بكسل (2048 في 2048).

هل يدعم المطالبات السلبية؟

لا، لا يدعم المطالبات السلبية ويرفضها. كما أن الإعدادات num_inference_steps 6 وguidance_scale 1 ثابتة، وأي قيم أخرى تُرجع خطأ HTTP 400.

كم طول المطالبة الذي يمكن استخدامه؟

تُقتطع المطالبات عند 4096 رمزًا. لتحسين المطالبات القصيرة بلغات أخرى، يمكن استخدام H3-Image-Context-IR الذي يوسّعها إلى أوصاف إنجليزية مفصلة.

ما الفرق بين MiniMax-H3-Image وMiniMax-H3-Image-PE؟

MiniMax-H3-Image-PE هو نسخة قابلة للنشر محليًا ويمكن تشغيلها باستخدام خادم SGLang محلي. أما MiniMax-H3-Image فهو النموذج الأساسي الموصوف هنا.

هل يمكن استخدام النموذج تجاريًا؟

يُصدر بموجب اتفاقية ترخيص MiniMax-H3-Image Community License Agreement. الاستخدام التجاري الذي يتطلب إذنًا كتابيًا منفصلًا يجب طلبه عبر platform.minimax.io/license.

نماذج ذات صلة