انتقل إلى المحتوى

Mage API · نموذج صور

Flux 2 API

أوامر نصية طويلة وتعديلات بعدة صور مرجعية

POST https://api.mage.space/v1/flux2/generate

لمحة سريعة

تشغّل Flux 2 API نموذج Flux 2 عبر Mage على POST https://api.mage.space/v1/flux2/generate. يكلّف الطلب بالإعدادات الافتراضية 40 Gems (نحو 0.04 دولار) دون اشتراك. لا يقبل Flux 2 إشارات @handle.

  • صورةالمخرجات
  • 1النسخة
  • 40Gems لكل صورة، الافتراضي
  • $0.04التكلفة التقريبية بالدولار

نظرة عامة

ما الذي تقدّمه Flux 2 API

Flux 2 Dev، نموذج مفتوح الأوزان يتألق مع الأوامر النصية الطويلة والمفصّلة. يولّد أو يعدّل انطلاقًا من 3 صور مرجعية كحد أقصى، بدقة تصل إلى 2K.

Flux 2 Dev، نموذج مفتوح الأوزان للأوامر النصية الطويلة والمفصّلة، يتيح التوليد والتعديل انطلاقًا من ثلاث صور مرجعية كحد أقصى.

يقبل الحقلين image وadditional_images كمدخلات.

بداية سريعة

استدعاء Flux 2 API

عيّن MAGE_API_KEY، وأرسل الطلب إلى /flux2/generate، ثم استعلم عن status_url حتى يكتمل الطلب.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/flux2/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "flux2-dev"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('flux2', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'flux2-dev',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("flux2", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "flux2-dev",
})

print(request["result"]["url"])

النماذج

قيم model_id الخاصة بـ Flux 2

أرسل model_id لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.

model_idالاسمافتراضي
flux2-devFlux 2نعم

الخيارات

معاملات Flux 2

القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.

الحقلالقيم
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1k, 2k

المدخلات

المدخلات الوسائطية التي يقبلها Flux 2

أرسل كل مدخل كرابط https أو رابط بيانات (data URL) أو ملف مرفوع بحجم يصل إلى 100 MB.

الحقلالدور
imageالصورة المرجعية.
additional_imagesصور مرجعية إضافية.

المزيد من نماذج الصور

واجهات API أخرى لإنشاء الصور على Mage

  • صورة · من 9 Gems

    واجهة GPT Image 2 API

    أوامر دقيقة ونصوص مقروءة

  • صورة · من 90 Gems

    Grok Image API

    Grok Imagine بمستويين

  • صورة · من 37 Gems

    واجهة Guava API

    واقعية فائقة تبدو كصورة فوتوغرافية

  • صورة · من 20 Gem

    HiDream API

    سريع ومتعدد الاستخدامات، مع أوصاف سلبية

  • صورة · من 20 Gem

    Krea 2 API

    جماليات رائعة في ثوانٍ

  • صورة · من 42 Gems

    واجهة Mango API

    عائلة الصور الرائدة لدينا

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

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

كم تبلغ تكلفة Flux 2 API؟
يكلّف طلب Flux 2 بالإعدادات الافتراضية (Flux 2) ‏40 Gems، أي نحو 0.04 دولار. يتغيّر السعر باختلاف الدقة والمدة والإصدارات، وتعرض الاستجابة الرسوم الدقيقة. تُسترد تكلفة أي عملية توليد تفشل، أما العملية التي تحجبها سياسة المحتوى في Mage فلا تُسترد.
ما نقطة النهاية الخاصة بـ Flux 2 API؟
أرسل طلب POST إلى https://api.mage.space/v1/flux2/generate مع ترويسة Authorization: Bearer تحمل مفتاح Mage API الخاص بك. تتضمن الاستجابة status_url للاستعلام عنه دوريًا حتى تصلك النتيجة.
ما نماذج Flux 2 التي يمكنني استدعاؤها؟
flux2-dev. النموذج الافتراضي هو Flux 2.
هل يدعم Flux 2 الصور المرجعية أو الشخصيات؟
يقبل Flux 2 الحقلين image وadditional_images. ولا يقبل إشارات @handle.
هل يمكنني استخدام Flux 2 من Claude أو ChatGPT؟
نعم. اربط خادم Mage MCP بـ Claude أو ChatGPT أو Claude Code أو Grok أو Cursor واطلب Flux 2 بالاسم. يقرأ مساعدك خياراته عبر get_model ويذكر السعر قبل أن يبدأ التوليد.
إلى متى تُحفظ نتائج Flux 2؟
يُحتفظ بالنتائج والمدخلات لمدة 30 يومًا. نزّل كل ما تريد الاحتفاظ به إلى مساحة التخزين الخاصة بك.

ابدأ البناء مع Mage

حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.

Charactersالمجتمع