انتقل إلى المحتوى
ساحة التجربةالتوثيقاحصل على مفتاح API

Mage API · نموذج صور

Seedream API

Seedream، مع فلتر صارم

احصل على مفتاح APIجرّب Seedream في ساحة التجربة
POST https://api.mage.space/v1/seedream/generate

لمحة سريعة

تشغّل واجهة Seedream API النموذج Seedream 5.5 و5 إصدارات أخرى عبر Mage على POST https://api.mage.space/v1/seedream/generate. يكلّف الطلب بالإعدادات الافتراضية 42 Gems (حوالي 0.042$)، بدون اشتراك. يدعم Seedream الشخصيات المحفوظة والمراجع عبر @handle داخل الوصف النصي.

  • صورةالمخرجات
  • 6الإصدارات
  • 42Gems لكل صورة، الافتراضي
  • $0.042التكلفة التقريبية بالدولار

نظرة عامة

ما الذي تقدّمه Seedream API

نماذج Seedream من ByteDance، من Seedream 5.0 Flash للمسودات إلى Seedream 5.5 الأحدث والافتراضي، بمشاهد مفصّلة ونصوص مقروءة وتعديلات من حتى 10 مراجع أو Characters، وبدقة تصل إلى 4K في Seedream 4.5. فلتر صارم: يجري فحص الأوصاف النصية والصور الأولى قبل كل تشغيل.

عائلة Seedream لتوليد الصور من ByteDance، مناسبة للمشاهد المفصّلة والنصوص المقروءة والتعديلات المعتمدة على ما يصل إلى 10 مراجع أو Characters: Seedream 5.5 (`seedream-5.5`)، الأحدث والافتراضي، بصور أكثر واقعية ونصوص صغيرة أوضح وتعديلات متكررة أكثر ثباتًا؛ وSeedream 5.0 Pro (`seedream-5.0-pro`)، النموذج الرائد السابق؛ وSeedream 5.0 Flash (`seedream-5.0-flash`)، بسعر ثابت واحد يشمل الصور المُدخلة، وهو الأقل تكلفة عند دقة 2K أو مع الصور المُدخلة (يكلّف Seedream 5.5 أقل عند استخدام وصف نصي فقط بدقة 1K)؛ و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 كمدخلات.

بداية سريعة

استدعاء Seedream API

عيّن 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

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

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

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

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

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

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

كم تبلغ تكلفة Seedream API؟
يكلّف طلب Seedream بالإعدادات الافتراضية (Seedream 5.5) ‏42 Gems، أي حوالي 0.042$. تؤثر الدقة والمدة والإصدارات الأخرى في السعر، وتعرض الاستجابة التكلفة الدقيقة. تُعاد تكلفة عملية التوليد الفاشلة، أما العملية التي تحجبها سياسة المحتوى في Mage فلا تُعاد تكلفتها.
ما نقطة النهاية (endpoint) في Seedream API؟
أرسل POST إلى https://api.mage.space/v1/seedream/generate مع ترويسة Authorization: Bearer تحمل مفتاح Mage API الخاص بك. تتضمن الاستجابة 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. كما يقبل الشخصيات المحفوظة والمراجع بالإشارة إليها بـ @handle في الوصف.
هل يمكنني استخدام Seedream من Claude أو ChatGPT؟
نعم. اربط خادم Mage MCP بـ Claude أو ChatGPT أو Claude Code أو Grok أو Cursor واطلب Seedream بالاسم. يقرأ مساعدك خياراته عبر get_model ويذكر السعر قبل أن يبدأ التوليد.
كم مدة الاحتفاظ بنتائج Seedream؟
يُحتفظ بالنتائج والمدخلات لمدة 30 يومًا. نزّل كل ما تريد الاحتفاظ به إلى مساحة التخزين الخاصة بك.

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

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

احصل على مفتاح APIجرّب Seedream في ساحة التجربة