MiniMax H3 Image Highspeed

أنشئ الصور وعدّلها باستخدام ما يصل إلى 16 صورة مرجعية وأبعاد دقيقة و1–10 مخرجات وتسعير قائم على الرموز.

مثال سريع

أرسل طلب صورة واحدًا، واحفظ id الذي تم إرجاعه، واستعلم دوريًا حتى تصبح حالة المهمة completed أو failed. تستخدم واجهة API هذه مهام غير متزامنة ومخرجات عبر عناوين URL.

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"minimax-h3-image-highspeed","prompt":"An amber bottle on pale limestone in soft morning light","area":"1K","aspect_ratio":"3:2"}'

نقطة النهاية والترويسات

POST https://api.seedrouter.ai/v1/images/generations

الترويسة	القيمة
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

احتفظ بالمفتاح على خادمك. نجاح HTTP يؤكد استلام المهمة؛ ولا يعني أن صورتها جاهزة.

هناك 13 حقلًا مقبولًا. الحقلان model وprompt فقط إلزاميان. احذف الحقول الاختيارية لاستخدام القيم الافتراضية؛ لا يقبل أي حقل null. يوفر Playground النموذج الثابت وعشرة مدخلات قابلة للتحرير. تنسيق الاستجابة عبر URL وتسليم المهام دون بث ثابتان.

الحقل	النوع	القيمة الافتراضية	القيد
`model`	سلسلة نصية	إلزامي	`minimax-h3-image-highspeed`
`prompt`	سلسلة نصية	إلزامي	1–32,000 محرف Unicode بعد إزالة محارف المسافات البيضاء من البداية والنهاية
`images`	مصفوفة كائنات	محذوف	1–16 كائنًا مرتبًا، يحتوي كل منها على `image_url`
`disable_prompt_enhanced`	منطقي	`false`	للتوليد فقط؛ راجع الاعتماديات أدناه
`n`	عدد صحيح	`1`	1–10
`size`	سلسلة نصية	`auto`	`auto` أو `WIDTHxHEIGHT`؛ حرف x صغير
`aspect_ratio`	سلسلة نصية	`auto`	`auto` أو `X:Y`؛ X وY عددان صحيحان ضمن 1–300؛ النسبة 1:3–3:1
`area`	سلسلة نصية	`4K`	`1K`، `2K`، `4K`؛ مساحات مستهدفة تقريبية قدرها 1,024² و2,048² و4,096² بكسل
`output_format`	سلسلة نصية	`jpeg`	`jpeg`، والاسم البديل `jpg`، و`png`
`output_compression`	عدد صحيح	`95`	0–100؛ جودة JPEG؛ يُتجاهل مع PNG
`aigc_watermark`	منطقي	`false`	إضافة علامة مائية للمحتوى المولّد بالذكاء الاصطناعي
`response_format`	سلسلة نصية	`url`	`url` فقط
`stream`	منطقي	`false`	`false` فقط؛ استعلم دوريًا باستخدام معرّف المهمة

اعتماديات الحجم والموجّه

يجب أن يحتوي size الصريح على أبعاد بأعداد صحيحة موجبة، بمساحة بين 655,360 و20,000,000 بكسل، شاملة الحدين. يجب أن يكون العرض مقسومًا على الارتفاع بين 1/3 و3. على سبيل المثال، 2048x1152 صالح. عند استخدام أبعاد صريحة، احذف كلًا من aspect_ratio وarea، حتى لو كانت قيمتهما ستكون auto.

عند حذف الحجم أو ضبطه على auto، استخدم aspect_ratio وarea معًا. المساحة حجم مستهدف؛ افحص الملف الذي تم تسليمه لمعرفة الأبعاد الدقيقة. وهي ليست سعرًا ثابتًا للصورة الواحدة.

يتطلب ضبط disable_prompt_enhanced: true حجمًا صريحًا بالبكسل أو نسبة أبعاد ثابتة. عند تعطيل التحسين، يقرأ النموذج أول 4,096 رمزًا تقريبًا من الموجّه. يظل حد الإرسال البالغ 32,000 محرف ساريًا. يحسّن التحرير الموجّهات دائمًا، لذلك تُرفض true عند وجود images.

لا تُقبل حقول القناع أو البذرة أو النمط أو الجودة أو الموجّه السلبي أو الخلفية أو حقل مستقل للدقة. تُرجع المعلمات غير المعروفة خطأً قبل الإرسال. لا توفر واجهة API هذه البث أو صور base64 أو مخرجات WebP.

الصور المرجعية

استخدم عناوين URL من نوع HTTP(S) متاحة للعامة دون بيانات اعتماد مضمنة. يجب أن تكون كل صورة بصيغة JPEG أو PNG أو WebP أو HEIC أو HEIF؛ وألا يتجاوز حجمها 64 MiB؛ وأن يكون كل ضلع ضمن 128–8,192 بكسل؛ وألا تتجاوز نسبة الضلع الطويل إلى القصير 4. اجعل حجم متن JSON لا يتجاوز 64 MiB. يُشار إلى ملفات الصور عبر URL، ولا تُضمّن بايتاتها داخل متن JSON.

عيّن غرضًا واضحًا لكل مرجع، وصِف ما يجب أن يبقى دون تغيير. يحدد ترتيب المصفوفة <Picture 1> و<Picture 2> وهكذا.

{
  "model": "minimax-h3-image-highspeed",
  "prompt": "Use <Picture 1> as the product and <Picture 2> as the setting. Preserve the product's shape and label. Match the setting's light and perspective.",
  "images": [
    {"image_url": "https://example.com/product.jpg"},
    {"image_url": "https://example.com/setting.jpg"}
  ],
  "aspect_ratio": "3:2",
  "area": "2K",
  "n": 1,
  "output_format": "png"
}

استبدل عناوين URL التوضيحية بملفات الصور الخاصة بك التي يمكن الوصول إليها.

الفوترة

تتضمن الفوترة ثلاث فئات من الرموز: إدخال النص وإدخال الصور وإخراج الصور. اضرب الاستخدام الفعلي في كل فئة في سعرها الحالي. يؤثر عدد المخرجات وأبعاد الصور والصور المرجعية في الاستخدام؛ ولا تحدد أسماء الدقة فاتورة ثابتة. لا تُحتسب رسوم على الطلبات الفاشلة. راجع الأسعار الحالية.

استجابة المهمة والاستعلام الدوري

يُرجع الطلب المقبول مهمة غير متزامنة:

{"id":"task_example","model":"minimax-h3-image-highspeed","status":"processing"}

curl https://api.seedrouter.ai/v1/tasks/task_example \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

تحتوي الاستجابة المكتملة على عناوين URL للصور في output.data. تتضمن كل صورة تم تسليمها size الخاص بها، وقد تتضمن revised_prompt (الوصف المحسّن). يمثّل output.created وقت الإنشاء بثواني Unix، ويحدد output.output_format الصيغة التي تم تسليمها. يعرض output.usage أعداد رموز إدخال النص وإدخال الصور وإخراج الصور، وعدد generated_images التي تم تسليمها. عناوين URL والمعرّفات أدناه توضيحية:

{
  "id": "task_example",
  "model": "minimax-h3-image-highspeed",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.jpg"}]}
}

استعلم دوريًا كل 10–20 ثانية. انتهاء مهلة العميل لا يعني فشل المهمة: احتفظ بمعرّفها واستمر في الاستعلام بدلًا من إرسال طلب مكرر. لا تحتوي الاستجابات العامة على أرصدة الحسابات أو التكاليف.

الأخطاء

تستخدم أخطاء HTTP التنسيق {"error":{"code":integer,"message":string}}. تحتوي المهمة الفاشلة على status: "failed" وخطأ. صحح المعلمات غير الصالحة قبل إرسال طلب جديد. راجع دليل الأخطاء المشترك ودورة حياة المهمة.