واجهة API لـ MiniMax H3 Image
مرجع API كامل لنماذج MiniMax H3 Image لتوليد الصور من النصوص وتحرير الصور.
إصدارات النموذج
تدعم واجهة API هذه إصدارين من النموذج:
مقارنة سريعة
نسب العرض إلى الارتفاع المدعومة
1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9
أدخل النسبة كقيمتين رقميتين منفصلتين لـ width وheight، وليس كأبعاد بالبكسل. إذا حُذفت القيمتان، تكون النسبة الافتراضية 1:1؛ وإلا، فأدخل القيمتين باستخدام أحد أزواج الأعداد الصحيحة المدعومة.
MiniMax H3 Image (توليد الصور من النصوص)
نقطة النهاية
POST /api/v1/image/task
المصادقة {#}
Authorization: Bearer YOUR_API_KEY
معلمات الطلب
مطلوبة
اختيارية
ملاحظة: يجب أن تكون نسبة العرض إلى الارتفاع إحدى النسب الـ 15 المدعومة المذكورة أعلاه.
مثال على الطلب
javascript
MiniMax H3 Image Edit (تحرير الصور)
نقطة النهاية
POST /api/v1/image/task
معلمات الطلب
مطلوبة
اختيارية
ملاحظة: يجب أن تكون نسبة العرض إلى الارتفاع إحدى النسب الـ 15 المدعومة المذكورة أعلاه.
مثال على الطلب
javascript
مثال على تحرير صورة واحدة
javascript
مثال على دمج صور متعددة
javascript
تنسيق الاستجابة
الاستجابة الأولية
json
استجابة الاستعلام الدوري
أرسل استعلامات دورية إلى GET /api/v1/image/{task_id} للتحقق من الحالة. توفّر استجابات الاستعلام الدوري الناجحة عناوين URL للصور المُولّدة ضمن data.task_result.images[].url.
قيم الحالة
submitted: تم قبول المهمةprocessing: جارٍ توليد الصورةsucceed: اكتمل توليد الصورةfailed: فشل توليد الصورة
أفضل الممارسات
- الأوصاف التفصيلية: صِف الموضوع والإضاءة والتكوين، مع إبقاء الوصف ضمن 5000 حرف
- اختيار الدقة: مرّر
1kأو2kأو4kصراحةً في كل طلب - نسبة العرض إلى الارتفاع: استخدم قيمتين متوافقتين للنسبة في
widthوheight، أو احذفهما معًا للحصول على1:1 - جودة تحرير الصور: قدّم 1-16 صورة مرجعية تستوفي متطلبات التنسيق والأبعاد المدعومة