رفتن به محتوا

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 Gem (حدود $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 می‌پذیرد

هرکدام را به‌صورت URL با https، data URL یا آپلود تا 100 MB بفرستید.

فیلدنقش
imageتصویر مرجع.
additional_imagesتصاویر مرجع اضافی.

مدل‌های تصویر بیشتر

سایر API‌های تولید تصویر در Mage

  • تصویر · از ۹ Gem

    GPT Image 2 API

    پرامپت‌های دقیق و متن خوانا

  • تصویر · از 75 Gems

    API Grok Image

    Grok Imagine در سه سطح کیفیت

  • تصویر · از ۳۷ Gem

    Guava API

    واقع‌گرایی‌ای که شبیه عکس واقعی است

  • تصویر · از 20 Gems

    API HiDream

    سریع و همه‌کاره، با پرامپت منفی

  • تصویر · از 20 Gems

    Krea 2 API

    زیبایی خیره‌کننده در چند ثانیه

  • تصویر · از ۱۳۵ Gem

    Mango API

    خانواده‌ی پرچم‌دار ما برای تصویر

سؤالات متداول

سؤالات متداول

هزینهٔ Flux 2 API چقدر است؟
یک درخواست Flux 2 با تنظیمات پیش‌فرض (Flux 2) 40 Gem هزینه دارد، حدود $0.04. رزولوشن، مدت‌زمان و نسخه‌های دیگر قیمت را تغییر می‌دهند؛ هزینهٔ دقیق در پاسخ اعلام می‌شود. اگر تولید ناموفق باشد، هزینه برگردانده می‌شود، اما اگر سیاست محتوایی Mage جلوی آن را بگیرد، برگردانده نمی‌شود.
اندپوینت Flux 2 API چیست؟
POST https://api.mage.space/v1/flux2/generate با هدر Authorization: Bearer که کلید API شما در Mage را دارد. پاسخ شامل status_url است که برای دریافت نتیجه باید آن را به‌صورت دوره‌ای بررسی کنید.
کدام مدل‌های Flux 2 را می‌توانم فراخوانی کنم؟
flux2-dev. پیش‌فرض Flux 2 است.
آیا Flux 2 از تصویر مرجع یا شخصیت پشتیبانی می‌کند؟
Flux 2 این ورودی‌ها را می‌پذیرد: image و additional_images. Flux 2 اشاره با @handle را نمی‌پذیرد.
آیا می‌توان از Flux 2 در Claude یا ChatGPT استفاده کرد؟
بله. سرور Mage MCP را به Claude، ChatGPT، Claude Code، Grok یا Cursor وصل کنید و Flux 2 را با نام بخواهید. دستیار شما گزینه‌های آن را با get_model می‌خواند و پیش از تولید، قیمت را اعلام می‌کند.
نتایج Flux 2 تا چه مدت نگه‌داری می‌شوند؟
نتایج و ورودی‌ها 30 روز نگهداری می‌شوند. هر چیزی را که می‌خواهید نگه دارید، در فضای ذخیره‌سازی خودتان دانلود کنید.

ساختن با Mage را شروع کن

یک حساب، یک موجودی Gems، همهٔ مدل‌ها. فقط برای چیزی که تولید می‌کنی هزینه بپرداز.