Seedream MCP

نماذجك الإبداعية. اتصال واحد.

اربط مساعدك واختر نموذجًا وأنشئ الصور أو الفيديو برصيدك الحالي.

إنشاء مفتاح API

اختر نقطة البداية

نماذج الصور…

نماذج الفيديو…

ربط المساعد

عنوان MCP

https://seedream-5.io/api/mcp

اضبط SEEDREAM_API_KEY في بيئة تشغيل أداة الذكاء الاصطناعي ثم انسخ الإعدادات. غيّر العنوان عند الاختبار محليًا.

~/.codex/config.toml

[mcp_servers.seedream]
url = "https://seedream-5.io/api/mcp"
bearer_token_env_var = "SEEDREAM_API_KEY"

Streamable HTTP · Bearer

نطاق التحقق ووثائق العملاء

Codex: تم التحقق من إنشاء الصور وتعديلها عبر URL وقراءة النتائج. Cursor وGrok Build: تم التحقق من الاتصال واكتشاف الأدوات. Claude Code: تم التحقق من الاتصال. لم تُختبر جميع الخطوات في العملاء الثلاثة الأخيرة بعد.

اجتازت النماذج الجديدة اختبارات إنشاء الصور وتعديلها عبر URL واستدعاءات أدوات MCP الأصلية في Codex بالإنتاج. ما زالت المسارات الكاملة التي يديرها الذكاء الاصطناعي في العملاء بحاجة إلى تحقق.

Codex Cursor Claude Code Grok

مساحة تجربة الصور

اختر النموذج والإعدادات ثم انسخ المعاملات إلى مساعدك المتصل. إعداد الاتصال واحد.

نموذج المثالنسبة الناتجالدقةصيغة الناتج

promptمطلوب

نص غير فارغ حتى 3000 حرف. صف الصورة أو التغييرات المطلوبة.

التكلفة المقدّرة… أرصدة

معاملات الإدخال

المعامل	مطلوب؟	النوع والقيم والحدود
`model`	اختياري	`string`seedream-5-pro معرف النموذج. عند حذفه يُستخدم Seedream 5 Pro. الافتراضي: seedream-5-pro
`request_id`	مطلوب	`string` 8–128 من الحروف اللاتينية والأرقام و _ و -. استخدم معرفًا جديدًا لكل صورة جديدة واحتفظ به عند إعادة محاولة المهمة نفسها.
`prompt`	مطلوب	`string` نص غير فارغ حتى 3000 حرف. صف الصورة أو التغييرات المطلوبة.
`aspect_ratio`	اختياري	`string`1:1 · 2:3 · 3:2 · 3:4 · 4:3 · 9:16 · 16:9 · 21:9 نسبة الصورة الناتجة. للحفاظ على نسبة المرجع اختر النسبة نفسها. auto متاح في Nano Banana 2 فقط. الافتراضي: 1:1
`resolution`	اختياري	`string`1K · 2K مستوى الدقة. تتغير أبعاد البكسل حسب النسبة. الافتراضي: 1K
`output_format`	اختياري	`string`jpeg · png استخدم jpeg أو png بأحرف صغيرة. الافتراضي: jpeg
`image_urls`	مطلوب لتعديل الصور فقط	`string[]` مصفوفة من 1–10 روابط HTTPS عامة بأسماء نطاقات، حتى 4096 حرف لكل رابط، بالمنفذ الافتراضي أو 443. لا تدعم عناوين IP أو المسارات المحلية أو base64 أو الروابط التي تتطلب تسجيل الدخول. احذف الحقل للإنشاء من النص.

تُقبل المعاملات المذكورة فقط. تُرفض القيم غير الصالحة قبل الإرسال أو حجز الأرصدة. صورة واحدة لكل طلب.

أدوات الاستعلام

seedream_get_model_info: model اختياري. يعيد {} الكتالوج وخيارات Pro الافتراضية.
seedream_get_balance: بلا معاملات: {}. يعيد الرصيد وحد المفتاح المتبقي.
seedream_get_task: task_id مطلوب: UUID المُعاد عند إنشاء المهمة.

مساحة تجربة الفيديو

استخدم العنوان والمفتاح نفسيهما. اختر Standard أو Pro ثم النمط وانسخ المعاملات إلى مساعدك المتصل. المثال لا يرسل مهمة.

نموذج المثالالدقةنسبة الناتجالمدة بالثواني

إنشاء الصوتالبذرة (اختياري)

promptمطلوب

التكلفة المقدّرة… أرصدة

معاملات جاهزة للنسخ

أمثلة فقط · لا يُستهلك رصيد هنا

المدة بالثواني: 2–30

seedream_generate_video

{
  "model": "wan-3.0-standard",
  "request_id": "generate_video_001",
  "mode": "text-to-video",
  "prompt": "إبريق شاي خزفي على طاولة خشبية. تقترب الكاميرا ببطء في ضوء الصباح الناعم.",
  "aspect_ratio": "adaptive",
  "resolution": "720P",
  "duration": 5,
  "audio": true
}

استخدم request_id جديدًا لكل فيديو جديد. احتفظ بالمعرف والمعاملات عند إعادة المحاولة؛تغييرها يسبب تعارضًا.

استدعِ seedream_generate_video مرة واحدة، ثم seedream_get_task باستخدام task_id كل 5 ثوانٍ. عند الاكتمال تحصل على رابط فيديو وresource_link. تستمر المهمة بعد قطع الاتصال. عند SUBMISSION_UNCERTAIN تواصل مع الدعم ولا تعِد الإرسال.

الوسائط المرجعية والحدود

النص يتطلب prompt. نمط الإطارات يتطلب first_frame_url أو last_frame_url. نمط المراجع يتطلب مصفوفة روابط واحدة على الأقل. لا تجمع الإطارات مع المراجع. prompt اختياري مع الوسائط.

روابط HTTPS عامة فقط دون ملفات محلية أو base64 أو تسجيل دخول. الصور:حتى10 JPEG/PNG/BMP/WebP،20 MiB لكل صورة،الأبعاد240–8000 px،النسبة≤8. الفيديو:حتى5 MP4/MOV،100 MiB لكل ملف،الأبعاد240–4096 px،النسبة≤8. الصوت:حتى5 WAV/MP3،15 MiB لكل ملف. مدة كل فيديو/صوت1–15 ثانية،وإجمالي كل نوع≤15 ثانية. الفيديو المرجعي+الناتج≤30 ثانية. أبقِ الروابط متاحة حتى الاكتمال؛تتحقق خدمة الإنشاء من الملفات الفعلية.

الافتراضي:Standard،نص،720P ‏(Pro1080P)،adaptive،5 ثوانٍ،الصوت مفعّل. الناتج MP4 ثابت والأبعاد حسب النسبة.

معاملات الإدخال

المعامل	مطلوب؟	النوع والقيم والحدود
`request_id`	مطلوب	`string · 8–128 · A–Z a–z 0–9 _ -`
`model`	اختياري	`wan-3.0-standard \| wan-3.0-prime \| wan-3.0-pro \| wan-3.0-prime-pro` الافتراضي: wan-3.0-standard
`mode`	اختياري	`text-to-video \| keyframe-to-video \| reference-to-video` الافتراضي: text-to-video
`prompt`	مطلوب	`string · 1–20000`
`aspect_ratio`	اختياري	`16:9 \| 9:16 \| 1:1 \| 4:3 \| 3:4 \| adaptive` الافتراضي: adaptive
`resolution`	اختياري	الافتراضي: …
`duration`	اختياري	`integer · 2–30 s` الافتراضي: 5
`audio`	اختياري	`boolean · true \| false` الافتراضي: true
`seed`	اختياري	`integer · 0–2147483647`
`first_frame_url / last_frame_url`	مطلوب · الإطار الأول / الأخير	`string · HTTPS · ≤4096`
`reference_image_urls`	اختياري · وسائط مرجعية	`string[] · 1–10 · HTTPS · ≤4096 / URL`
`reference_video_urls`	وسائط مرجعية	`string[] · 1–5 · HTTPS · ≤4096 / URL`
`reference_audio_urls`	وسائط مرجعية	`string[] · 1–5 · HTTPS · ≤4096 / URL`
`reference_video_durations / reference_audio_durations`	اختياري	`number[] · 1–15 s / item · total ≤15 s`

فيديو MP4 واحد لكل طلب. لا يُقبل output_format أو إعدادات المزود/السلامة. تُرفض المعاملات غير الصالحة قبل الحجز. قد تفشل الوسائط غير المتاحة أو المخالفة للحدود. مصفوفات المدة اختيارية ويجب أن تطابق عدد الروابط وترتيبها ولا تتجاوز التحقق الفعلي.

مفاتيح API الخاصة بك

خصّص مفتاحًا وحدّ إنفاق لكل أداة ذكاء اصطناعي. أمثلة ومعاملات الاستدعاء

جارٍ التحميل…