رفتن به محتوا
محیط آزمایشمستنداتدریافت کلید API

API مج · مدل تصویر

API Seedream

Seedream، با فیلتر سخت‌گیرانه

دریافت کلید APISeedream را در پلی‌گراند امتحان کنید
POST https://api.mage.space/v1/seedream/generate

در یک نگاه

API مدل Seedream، مدل Seedream 5.5 و ۵ نسخه‌ی دیگر را از طریق Mage در POST https://api.mage.space/v1/seedream/generate اجرا می‌کند. یک درخواست با تنظیمات پیش‌فرض ۴۲ Gem (حدود ۰٫۰۴۲ دلار) هزینه دارد، بدون اشتراک. Seedream از شخصیت‌های ذخیره‌شده و رفرنس‌ها پشتیبانی می‌کند؛ کافی است در پرامپت از @handle استفاده کنی.

  • تصویرخروجی
  • 6نسخه‌ها
  • 42Gems برای هر تصویر، پیش‌فرض
  • $0.042حدود، به دلار

نگاه کلی

API Seedream چه کاری انجام می‌دهد

Seedream از ByteDance، از Seedream 5.0 Flash برای پیش‌نویس تا Seedream 5.5 که جدیدترین و پیش‌فرض است، با صحنه‌های پرجزئیات، متن خوانا و ویرایش از حداکثر ۱۰ مرجع یا Characters، تا 4K در Seedream 4.5. فیلتر سخت‌گیرانه: پرامپت‌ها و تصاویر اول پیش از هر اجرا بررسی می‌شوند.

خانواده مدل‌های تصویر Seedream از ByteDance، برای صحنه‌های پرجزئیات، متن خوانا و ویرایش با حداکثر ۱۰ References یا Characters: Seedream 5.5 (`seedream-5.5`)، جدیدترین مدل و پیش‌فرض، با تصاویر واقعی‌تر، متن ریز واضح‌تر و ویرایش‌های تکراری پایدارتر؛ Seedream 5.0 Pro (`seedream-5.0-pro`)، پرچم‌دار قبلی؛ Seedream 5.0 Flash (`seedream-5.0-flash`)، با یک قیمت ثابت که تصاویر ورودی هم در آن گنجانده شده است و در کیفیت 2K یا همراه با تصاویر ورودی ارزان‌ترین گزینه است (برای یک پرامپت تنها در 1K، Seedream 5.5 ارزان‌تر تمام می‌شود)؛ Seedream 5.0 Lite (`seedream-5.0-lite`)، تا 3K؛ Seedream 4.5 (`seedream-4.5`)، تا 4K؛ و Seedream 4.0 (`seedream-4.0`). فیلتر سخت‌گیرانه: Mage پیش از اجرا، پرامپت و اولین تصویر را بررسی می‌کند؛ درخواستی که رد شود با خطای `content_blocked` و ذکر دلیل ناموفق می‌شود و مبلغ آن بازگردانده می‌شود.

image و additional_images را به‌عنوان ورودی می‌پذیرد.

شروع سریع

فراخوانی API Seedream

MAGE_API_KEY را تنظیم کنید، درخواست را به /seedream/generate بفرستید و status_url را پیگیری کنید تا درخواست تمام شود.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seedream/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": "seedream-5.5"
}' | 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('seedream', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'seedream-5.5',
});

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

mage = Mage()  # reads MAGE_API_KEY

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

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

مدل‌ها

مقادیر model_id در Seedream

برای انتخاب یک نسخه، model_id را بفرستید. درخواست بدون آن، نسخه پیش‌فرض را اجرا می‌کند.

model_idنامپیش‌فرض
seedream-4.0Seedream 4.0
seedream-4.5Seedream 4.5
seedream-5.0-liteSeedream 5.0 Lite
seedream-5.0-proSeedream 5.0 Pro
seedream-5.0-flashSeedream 5.0 Flash
seedream-5.5Seedream 5.5بله

گزینه‌ها

پارامترهای Seedream

مقادیر مجاز برای همه نسخه‌ها؛ ممکن است یک نسخه گزینه‌های کمتری داشته باشد. گزینه‌های هر نسخه در مستندات آمده است.

فیلدمقادیر
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K, 3K, 4K

ورودی‌ها

ورودی‌های رسانه‌ای که Seedream می‌پذیرد

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

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

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

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

  • تصویر · از 10 Gems

    Stable Diffusion v1.5 API

    کلاسیک، با هزینهٔ کم

  • تصویر · از 10 Gems

    Stable Diffusion v3.5 Large API

    Stable Diffusion‌ای که بهتر از همه به حرف شما گوش می‌دهد

  • تصویر · از 10 Gems

    API مدل Stable Diffusion XL

    SDXL بهینه‌شده برای تصاویر فوتورئال

  • تصویر · از 10 Gems

    API مدل Z-Image

    سریع‌ترین مدل تصویر در Mage

  • تصویر · از 20 Gems

    Anima API

    ساخته‌شده مخصوص انیمه

  • تصویر · از 35 Gems

    API Chroma

    وزن‌های باز، ساخته‌شده بر پایه Flux

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

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

هزینه API Seedream چقدر است؟
یک درخواست Seedream با تنظیمات پیش‌فرض (Seedream 5.5) ۴۲ Gem، یعنی حدود ۰٫۰۴۲ دلار هزینه دارد. رزولوشن، مدت‌زمان و نسخه‌های دیگر قیمت را تغییر می‌دهند؛ هزینه‌ی دقیق در پاسخ اعلام می‌شود. اگر تولید ناموفق باشد، هزینه برگردانده می‌شود؛ اما اگر سیاست محتوایی Mage جلوی آن را بگیرد، برگردانده نمی‌شود.
اندپوینت API Seedream چیست؟
POST به https://api.mage.space/v1/seedream/generate با هدر Authorization: Bearer که کلید API شما در Mage را دارد. پاسخ شامل status_url است که برای دریافت نتیجه باید آن را پیگیری کنید.
کدام مدل‌های Seedream را می‌توانم فراخوانی کنم؟
seedream-4.0 (Seedream 4.0)، seedream-4.5 (Seedream 4.5)، seedream-5.0-lite (Seedream 5.0 Lite)، seedream-5.0-pro (Seedream 5.0 Pro)، seedream-5.0-flash (Seedream 5.0 Flash)، seedream-5.5 (Seedream 5.5). پیش‌فرض Seedream 5.5 است.
آیا Seedream از تصاویر رفرنس یا شخصیت‌ها پشتیبانی می‌کند؟
Seedream این‌ها را می‌پذیرد: image، additional_images. Seedream شخصیت‌های ذخیره‌شده و رفرنس‌ها را با @handle در پرامپت می‌پذیرد.
آیا می‌توانم Seedream را از Claude یا ChatGPT استفاده کنم؟
بله. سرور MCP مربوط به Mage را به Claude، ChatGPT، Claude Code، Grok یا Cursor وصل کنید و Seedream را با نام بخواهید. دستیار شما گزینه‌های آن را با get_model می‌خواند و پیش از تولید، قیمت را اعلام می‌کند.
نتایج Seedream تا چه مدت نگه داشته می‌شوند؟
نتایج و ورودی‌ها 30 روز نگهداری می‌شوند. هر چیزی را که می‌خواهید نگه دارید، در فضای ذخیره‌سازی خودتان دانلود کنید.

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

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

دریافت کلید APISeedream را در پلی‌گراند امتحان کنید