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

MiniMax H3 Image Highspeed API

نموذج مفتوح الأوزان من MiniMax H3 Image مخصص لتوليد الصور وتحريرها بسرعة عالية تتفوق على النماذج المنافسة.

MiniMax H3 Image Highspeed هو النموذج المُحسَّن للسرعة ضمن سلسلة MiniMax H3 Image المفتوحة الأوزان، وهو نموذج متعدد الوسائط يستقبل النصوص والصور وينتج صوراً. يعتمد النموذج على بنية MiniMax H3 العامة، ويأتي بنفس المعاملات والحدود التي يقدمها الإصدار القياسي، لكنه يقدم وضع Highspeed الذي يجعله أسرع بثلاث إلى أربع مرات من الوضع القياسي، بينما يكون الوضع القياسي نفسه أسرع بمقدار مرة ونصف إلى مرتين من بعض النماذج المنافسة.

ينتج النموذج صوراً بدقة أصلية تصل إلى نحو 16 ميغابكسل، ويدعم نسب عرض إلى ارتفاع من 1:3 حتى 3:1، ما يجعله مناسباً للتخطيطات المتنوعة. يمكنه دمج ما يصل إلى 16 صورة مرجعية في توليد واحد، ويرسم النصوص الطويلة والكثيفة، ويقرأ المطالبات النصية الطويلة. من أبرز استخداماته توليد الصور من النصوص، وتحرير الصور، وإنشاء الملصقات والإنفوجرافيك وواجهات المستخدم والمواد التسويقية، والنماذج الأولية السريعة، والمعالجة بالدفعات، والتركيبات المعقدة، والحفاظ على اتساق الشخصيات، وبناء مشاهد متعددة العناصر.

يمكن تشغيل النموذج محلياً على أجهزة متواضعة؛ فقد أفاد مستخدم بتوليد صور بدقة 5 إلى 10 ميغابكسل باستخدام 16 غيغابايت من ذاكرة الفيديو، وآخر بالوصول إلى دقة تزيد على 2 ميغابكسل بأكثر من 20 خطوة باستخدام 6 غيغابايت من ذاكرة الفيديو و16 غيغابايت من ذاكرة النظام. من قيوده أن نسبة الضغط المكاني الفعلية البالغة 32 ضعفاً قد تجعل الصور أكثر ضبابية عند بعض الدقات، وأنه يفتقر إلى التفاصيل الدقيقة، كما أنه ثقيل بسبب مشفر النصوص بحجم 32 مليار معلمة.

آخر تحديث:

MODEL ID

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

أبرز الميزات

  • وضع Highspeed أسرع 3 إلى 4 مرات من الوضع القياسي
  • دقة أصلية تصل إلى نحو 16 ميغابكسل
  • دعم نسب عرض إلى ارتفاع من 1:3 إلى 3:1
  • دمج حتى 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-highspeed"
}'

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-highspeed",
  "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 Highspeed?

MiniMax H3 Image Highspeed هو النموذج المُحسَّن للسرعة ضمن سلسلة MiniMax H3 Image المفتوحة الأوزان، وهو نموذج متعدد الوسائط يستقبل النصوص والصور وينتج صوراً. يعتمد النموذج على بنية MiniMax H3 العامة، ويأتي بنفس المعاملات والحدود التي يقدمها الإصدار القياسي، لكنه يقدم وضع Highspeed الذي يجعله أسرع بثلاث إلى أربع مرات من الوضع القياسي، بينما يكون الوضع القياسي نفسه أسرع بمقدار مرة ونصف إلى مرتين من بعض النماذج المنافسة. ينتج النموذج صوراً بدقة أصلية تصل إلى نحو 16 ميغابكسل، ويدعم نسب عرض إلى ارتفاع من 1:3 حتى 3:1، ما يجعله مناسباً للتخطيطات المتنوعة. يمكنه دمج ما يصل إلى 16 صورة مرجعية في توليد واحد، ويرسم النصوص الطويلة والكثيفة، ويقرأ المطالبات النصية الطويلة. من أبرز استخداماته توليد الصور من النصوص، وتحرير الصور، وإنشاء الملصقات والإنفوجرافيك وواجهات المستخدم والمواد التسويقية، والنماذج الأولية السريعة، والمعالجة بالدفعات، والتركيبات المعقدة، والحفاظ على اتساق الشخصيات، وبناء مشاهد متعددة العناصر. يمكن تشغيل النموذج محلياً على أجهزة متواضعة؛ فقد أفاد مستخدم بتوليد صور بدقة 5 إلى 10 ميغابكسل باستخدام 16 غيغابايت من ذاكرة الفيديو، وآخر بالوصول إلى دقة تزيد على 2 ميغابكسل بأكثر من 20 خطوة باستخدام 6 غيغابايت من ذاكرة الفيديو و16 غيغابايت من ذاكرة النظام. من قيوده أن نسبة الضغط المكاني الفعلية البالغة 32 ضعفاً قد تجعل الصور أكثر ضبابية عند بعض الدقات، وأنه يفتقر إلى التفاصيل الدقيقة، كما أنه ثقيل بسبب مشفر النصوص بحجم 32 مليار معلمة.

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

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

ما أنواع المدخلات والمخرجات التي يدعمها النموذج؟

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

كيف يختلف MiniMax H3 Image Highspeed عن الإصدار القياسي من السلسلة؟

يقدم وضع Highspeed أداءً أسرع بثلاث إلى أربع مرات من الوضع القياسي، مع استخدام نفس المعاملات والحدود التي يستخدمها الإصدار القياسي.

ما الدقات ونسب العرض إلى الارتفاع المدعومة؟

ينتج النموذج صوراً بدقة أصلية تصل إلى نحو 16 ميغابكسل، ويدعم نسب عرض إلى ارتفاع تتراوح من 1:3 إلى 3:1.

هل يمكن تشغيل النموذج محلياً على أجهزة محدودة؟

نعم، يمكن تشغيله محلياً على أجهزة متواضعة؛ فقد أفاد مستخدم بتوليد صور بدقة 5 إلى 10 ميغابكسل باستخدام 16 غيغابايت من ذاكرة الفيديو، وآخر بالوصول إلى دقة تزيد على 2 ميغابكسل بأكثر من 20 خطوة باستخدام 6 غيغابايت من ذاكرة الفيديو و16 غيغابايت من ذاكرة النظام.

ما أبرز قيود النموذج؟

قد يكون الناتج أكثر ضبابية عند بعض الدقات بسبب نسبة الضغط المكاني الفعلية البالغة 32 ضعفاً، كما يفتقر إلى التفاصيل الدقيقة، وهو ثقيل بسبب مشفر النصوص بحجم 32 مليار معلمة.

نماذج ذات صلة