واجهة برمجة تطبيقات الوسائط — الصور والفيديو والموسيقى

أنشئ الصور والفيديو والموسيقى باستخدام مفتاح sk-nr-… نفسه ومن الرصيد نفسه المستخدم مع النماذج النصية. حساب موحّد، ودفع حسب الاستخدام، من دون اشتراكات أو باقات.

العنوان الأساسي: https://nordrouter.com (أو https://global-api.nordrouter.com للشبكات خارج البلاد).
المصادقة: ترويسة Authorization: Bearer sk-nr-… (أو X-API-Key: sk-nr-…).
التنسيق: JSON، والتوليد غير متزامن (إنشاء مهمة ← الاستعلام عن حالتها ← استلام الملف).

نقاط النهاية

الطريقة	الغرض
`POST /media/generate`	إنشاء مهمة توليد
`GET /media/job/:id`	حالة المهمة ونتيجتها
`POST /media/estimate`	معرفة سعر الإعداد مسبقًا
`GET /media/models`	قائمة قابلة للقراءة آليًا بالنماذج والمعلمات
`POST /media/upload`	تحميل ملف الوسائط المصدر
`GET /media/file/:id`	الملف الجاهز (الرابط من `result_url`)

دورة حياة الطلب

1. إنشاء مهمة

bash

curl https://nordrouter.com/media/generate \
  -H "Authorization: Bearer sk-nr-YOUR-KEY" -H "Content-Type: application/json" \
  -d '{ "model": "video/kling-2.6-i2v",
        "input": { "prompt": "плавный наезд камеры", "image": "https://…/photo.png", "duration": "5", "audio": true } }'

json

{ "id": "b1f2…", "model": "video/kling-2.6-i2v", "status": "processing", "poll": "https://nordrouter.com/media/job/b1f2…" }

2. الاستعلام عن الحالة (كل 3–5 ثوانٍ)

bash

curl https://nordrouter.com/media/job/b1f2…

json

{ "id": "b1f2…", "status": "done", "result_url": "https://nordrouter.com/media/file/b1f2…", "cost_usd": 0.55, "error": null }

3. استلام الملف — عبر result_url. الرابط على nordrouter.com (علامتك التجارية)؛ تُخزَّن الملفات 14 يومًا ثم تُحذف، لذا نزّلها أو انقلها إلى مكانك مسبقًا.

تحميل ملفات الوسائط المصدر

تقبل الحقول image وimage2 وaudio_url وvideo_url رابطًا عامًا مباشرًا. تقبل النماذج التي لديها الحقل attachments مصفوفة كائنات أعادها POST /media/upload: أرسل { "data": "data:audio/mpeg;base64,…", "name": "track.mp3" }، ثم مرّر استجابة أداة التحميل كاملةً إلى input.attachments. بالنسبة إلى Suno، يمكنك بدلًا من ذلك تمرير رابط عام في input.source_url، ولـ mashup رابطين في input.source_urls.

الفوترة

تُخصم الرسوم من رصيدك بالدولار (وهو الرصيد نفسه المستخدم مع النماذج النصية)، حسب التوليد المنفّذ فعليًا، وبالمبلغ المحدد تمامًا في الجداول أدناه.

حجز ثم احتساب فعلي. عند إنشاء المهمة، يُحجز تقدير التكلفة؛ وبعد اكتمالها تُعاد حسابات المبلغ وفق النتيجة الفعلية، ويُعاد الفائض إلى الرصيد.
الفيديو يُحتسب بالثانية. يرتفع السعر مع المدة والدقة؛ والصوت المفعّل أعلى تكلفة. تعرض الجداول السعر «ابتداءً من» للإعدادات الافتراضية، وتشير /ثانية إلى السعر لكل ثانية.
لا رسوم عند الإخفاق. إذا انتهت المهمة بالحالة failed، يُعاد الحجز بالكامل، وتدفع فقط مقابل عمليات التوليد الناجحة.
معرفة السعر الدقيق مسبقًا — أرسل POST /media/estimate مع قيم model وinput نفسها، وستُعاد { "usd": … } قبل البدء.
يُشحن الرصيد بالروبل (≈ $1 = 89–96 ₽)؛ وبعد ذلك تُحسب جميع المبالغ بالدولار الأمريكي.

كتالوج النماذج

السعر: للفيديو — سعر لكل ثانية (/ثانية)، والإجمالي = السعر × المدة (وقد تغيّره الدقة/الصوت)؛ ولغيره — لكل عملية توليد بالإعدادات الافتراضية. يُرجع POST /media/estimate التكلفة الدقيقة لأي إعدادات.

قد يحتوي input على حقول إضافية — يُرجع GET /media/models دائمًا قائمة قابلة للقراءة آليًا (الأنواع، والخيارات، والقيم الافتراضية، ونطاقات المدة بالثواني). الحقول المطلوبة مميّزة بعلامة *. يمكن إرسال أي حقول إضافية للنموذج (negative_prompt، seed، cfg_scale…) مباشرةً داخل input.

أسماء المعلمات السابقة

في 19 أكتوبر 2026، وُحّدت أسماء المعلمات وقيمها: snake_case، والقيم بأحرف صغيرة (مثل version: "v6-wild"، resolution: "720p"، audio: true). لا تزال الأسماء والقيم من الإصدار السابق للتوثيق مقبولة — لا حاجة لتعديل التكاملات المكتوبة سابقًا: المهمة والنتيجة والسعر كما هي. يعرض GET /media/models وMCP وهذا التوثيق الأسماء والقيم الجديدة فقط. إذا تضمّن الطلب الاسم السابق والجديد للمعلمة نفسها، يُعتمد الاسم الجديد.

🖼 الصور

`model`	الوضع	معلمات `input`	الملف	السعر
`image/nano-banana`	نص→صورة	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|3:4\|4:3\|3:2\|2:3\|21:9\|auto, `safety_filter`=bool	PNG	$0.025
`image/nano-banana-2`	نص→صورة	`prompt` *, `aspect_ratio`=auto\|1:1\|16:9\|9:16\|3:4\|4:3\|21:9, `resolution`=1k\|2k\|4k, `image`=url, `safety_filter`=bool	PNG	$0.050
`image/nano-banana-2-lite`	نص→صورة	`prompt` *, `aspect_ratio`=auto\|1:1\|16:9\|9:16\|3:4\|4:3, `image`=url, `safety_filter`=bool	PNG	$0.025
`image/nano-banana-pro`	نص→صورة	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|3:4\|4:3\|21:9\|auto, `resolution`=1k\|2k\|4k, `image`=url, `safety_filter`=bool	PNG	$0.11
`image/imagen4-fast`	نص→صورة	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|3:4\|4:3, `safety_filter`=bool	PNG	$0.025
`image/imagen4`	نص→صورة	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|3:4\|4:3, `safety_filter`=bool	PNG	$0.050
`image/imagen4-ultra`	نص→صورة	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|3:4\|4:3, `safety_filter`=bool	PNG	$0.075
`image/gpt-image-1.5`	نص→صورة	`prompt` *, `aspect_ratio`=1:1\|2:3\|3:2, `quality`=medium\|high, `safety_filter`=bool	PNG	$0.025
`image/gpt-image-1.5-edit`	تعديل صورة	`prompt` , `image`=url , `aspect_ratio`=3:2\|1:1\|2:3, `quality`=medium\|high, `safety_filter`=bool	PNG	$0.025
`image/gpt-image-2`	نص→صورة	`prompt` *, `aspect_ratio`=1:1\|3:2\|2:3\|16:9\|9:16\|4:3\|3:4, `resolution`=1k\|2k\|4k	PNG	$0.006
`image/gpt-image-2-edit`	تعديل صورة	`prompt` , `image`=url , `aspect_ratio`=auto\|1:1\|3:2\|2:3\|16:9\|9:16, `resolution`=1k\|2k\|4k, `safety_filter`=bool	PNG	$0.037
`image/flux2-pro`	نص→صورة	`prompt` *, `aspect_ratio`=1:1\|4:3\|3:4\|16:9\|9:16\|3:2\|2:3, `resolution`=1k\|2k, `safety_filter`=bool	PNG	$0.031
`image/flux2-pro-edit`	تعديل صورة	`prompt` , `image`=url , `aspect_ratio`=1:1\|4:3\|3:4\|16:9\|9:16\|3:2\|2:3\|auto, `resolution`=1k\|2k, `safety_filter`=bool	PNG	$0.031
`image/flux2-flex`	نص→صورة	`prompt` *, `aspect_ratio`=1:1\|4:3\|3:4\|16:9\|9:16\|3:2\|2:3, `resolution`=1k\|2k, `safety_filter`=bool	PNG	$0.087
`image/flux2-flex-edit`	تعديل صورة	`prompt` , `image`=url , `aspect_ratio`=1:1\|4:3\|3:4\|16:9\|9:16\|3:2\|2:3\|auto, `resolution`=1k\|2k, `safety_filter`=bool	PNG	$0.087
`image/seedream-edit`	تعديل صورة	`prompt` , `image`=url , `aspect_ratio`=1:1-hd\|1:1\|3:4\|9:16\|4:3\|16:9, `resolution`=1k\|2k\|4k, `safety_filter`=bool	PNG	$0.037
`image/seedream-4.5-edit`	تعديل صورة	`prompt` , `image`=url , `aspect_ratio`=1:1\|4:3\|3:4\|16:9\|9:16\|2:3\|3:2, `quality`=basic\|high, `safety_filter`=bool	PNG	$0.044
`image/seedream-5-lite-edit`	تعديل صورة	`prompt` , `image`=url , `aspect_ratio`=1:1\|4:3\|3:4\|16:9\|9:16\|2:3\|3:2, `quality`=basic\|high, `safety_filter`=bool	PNG	$0.037
`image/seedream-5.0-pro-edit`	تعديل صورة	`prompt` , `image`=url , `aspect_ratio`=1:1\|4:3\|3:4\|16:9\|9:16\|2:3\|3:2\|21:9, `quality`=basic\|high, `safety_filter`=bool	PNG	$0.044
`image/ideogram-v3`	نص→صورة	`prompt` *, `render_mode`=fast\|balanced\|quality, `aspect_ratio`=1:1-hd\|1:1\|3:4\|9:16\|4:3\|16:9, `style`=auto\|general\|realistic\|design, `safety_filter`=bool	PNG	$0.044
`image/ideogram-edit`	تعديل صورة	`prompt` , `image`=url , `render_mode`=fast\|balanced\|quality, `aspect_ratio`=1:1-hd\|1:1\|3:4\|9:16\|4:3\|16:9, `safety_filter`=bool	PNG	$0.044
`image/ideogram-character`	تعديل صورة	`prompt` , `image`=url , `render_mode`=fast\|balanced\|quality, `style`=auto\|realistic\|fiction, `safety_filter`=bool	PNG	$0.11
`image/qwen`	نص→صورة	`prompt` *, `aspect_ratio`=1:1-hd\|1:1\|3:4\|9:16\|4:3\|16:9, `safety_filter`=bool	PNG	$0.031
`image/qwen-edit`	تعديل صورة	`prompt` , `image`=url , `aspect_ratio`=1:1-hd\|1:1\|3:4\|9:16\|4:3\|16:9, `safety_filter`=bool	PNG	$0.037
`image/qwen-i2i`	تعديل صورة	`prompt` , `image`=url , `safety_filter`=bool	PNG	$0.031
`image/qwen2-edit`	تعديل صورة	`prompt` , `image`=url , `aspect_ratio`=16:9\|1:1\|3:4\|4:3\|9:16\|3:2\|2:3, `safety_filter`=bool	PNG	$0.037
`image/grok`	نص→صورة	`prompt` *, `aspect_ratio`=1:1\|2:3\|3:2\|16:9\|9:16, `pro`=bool, `safety_filter`=bool	PNG	$0.025
`image/grok-edit`	تعديل صورة	`prompt` , `image`=url , `safety_filter`=bool	PNG	$0.025
`image/z-image`	نص→صورة	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|3:4\|4:3, `safety_filter`=bool	PNG	$0.006
`image/wan-2.7`	نص→صورة	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|4:3\|3:4\|21:9, `resolution`=1k\|2k\|4k, `image`=url, `safety_filter`=bool	PNG	$0.031
`image/wan-2.7-pro`	نص→صورة	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|4:3\|3:4\|21:9, `resolution`=1k\|2k\|4k, `image`=url, `safety_filter`=bool	PNG	$0.075
`image/seedream-5.0-pro`	نص→صورة	`prompt` *	JPG	$0.013
`image/gemini-3.1-flash`	نص→صورة	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|4:3\|3:4, `resolution`=1k\|2k\|4k	PNG	$0.013
`image/gemini-3-pro`	نص→صورة	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|4:3\|3:4, `resolution`=1k\|2k\|4k	PNG	$0.031

🎬 الفيديو

`model`	الوضع	معلمات `input`	الملف	السعر
`video/veo-3.1-fast`	نص→فيديو	`prompt` *, `aspect_ratio`=16:9\|9:16, `image`=url	MP4	$0.38
`video/veo-3.1-quality`	نص→فيديو	`prompt` *, `aspect_ratio`=16:9\|9:16, `image`=url	MP4	$1.56
`video/veo-3.1-lite`	نص→فيديو	`prompt` *, `aspect_ratio`=16:9\|9:16, `image`=url	MP4	$0.19
`video/gemini-omni`	نص→فيديو	`prompt` , `duration`=4\|6\|8\|10 , `aspect_ratio`=16:9\|9:16, `resolution`=720p\|1080p\|4k, `image`=url, `safety_filter`=bool	MP4	$0.66
`video/gemini-omni-flash`	نص→فيديو	`prompt` *, `attachments`=upload[]	MP4	$0.13
`video/kling-3.0`	نص→فيديو	`prompt` *, `duration`=3–15ث, `aspect_ratio`=16:9\|9:16\|1:1, `mode`=standard\|pro\|4k, `audio`=bool, `image`=url, `image2`=url, `safety_filter`=bool	MP4	$0.11/ثانية
`video/kling-t2v`	نص→فيديو	`prompt` *, `duration`=3–15ث, `aspect_ratio`=16:9\|9:16\|1:1, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.11/ثانية
`video/kling-turbo-i2v`	صورة→فيديو	`prompt` , `image`=url , `duration`=3–15ث, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.11/ثانية
`video/kling-2.6-t2v`	نص→فيديو	`prompt` *, `duration`=5\|10, `aspect_ratio`=16:9\|9:16\|1:1, `audio`=bool, `safety_filter`=bool	MP4	$0.34
`video/kling-2.6-i2v`	صورة→فيديو	`prompt` , `image`=url , `duration`=5\|10, `audio`=bool, `safety_filter`=bool	MP4	$0.34
`video/kling-2.5-t2v`	نص→فيديو	`prompt` *, `duration`=5\|10, `aspect_ratio`=16:9\|9:16\|1:1, `safety_filter`=bool	MP4	$0.26
`video/kling-2.5-i2v`	صورة→فيديو	`prompt` , `image`=url , `image2`=url, `duration`=5\|10, `safety_filter`=bool	MP4	$0.26
`video/kling-i2v`	صورة→فيديو	`prompt` , `image`=url , `image2`=url, `duration`=5\|10, `safety_filter`=bool	MP4	$0.31
`video/kling-2.1-standard`	صورة→فيديو	`prompt` , `image`=url , `duration`=5\|10, `safety_filter`=bool	MP4	$0.16
`video/kling-2.1-master-t2v`	نص→فيديو	`prompt` *, `duration`=5\|10, `aspect_ratio`=16:9\|9:16\|1:1, `safety_filter`=bool	MP4	$1.00
`video/kling-2.1-master-i2v`	صورة→فيديو	`prompt` , `image`=url , `duration`=5\|10, `safety_filter`=bool	MP4	$1.00
`video/kling-motion`	فيديو→فيديو	`image`=url , `video_url` , `prompt`, `mode`=standard\|pro	MP4	$1.25
`video/kling-avatar`	أفاتار (صورة+صوت)	`image`=url , `audio_url` , `prompt` *	MP4	$0.75
`video/kling-avatar-pro`	أفاتار (صورة+صوت)	`image`=url , `audio_url` , `prompt` *	MP4	$1.50
`video/wan-2.7-t2v`	نص→فيديو	`prompt` *, `duration`=2–15ث, `aspect_ratio`=16:9\|9:16\|1:1\|4:3\|3:4, `resolution`=720p\|1080p, `audio_url`, `safety_filter`=bool	MP4	$0.15/ثانية
`video/wan-2.7-i2v`	صورة→فيديو	`prompt` , `image`=url , `image2`=url, `duration`=2–15ث, `resolution`=720p\|1080p, `audio_url`, `safety_filter`=bool	MP4	$0.15/ثانية
`video/wan-2.7-r2v`	صورة→فيديو	`prompt` , `image`=url , `duration`=2–10ث, `aspect_ratio`=16:9\|9:16\|1:1, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.15/ثانية
`video/wan-2.7-edit`	فيديو→فيديو	`prompt` , `video_url` , `resolution`=720p\|1080p, `audio_source`=auto\|original	MP4	$1.50
`video/wan-t2v`	نص→فيديو	`prompt` *, `duration`=5\|10\|15, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.44
`video/wan-i2v`	صورة→فيديو	`prompt` , `image`=url , `duration`=5\|10\|15, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.44
`video/wan-v2v`	فيديو→فيديو	`prompt` , `video_url` , `duration`=5\|10, `resolution`=720p\|1080p	MP4	$0.44
`video/wan-2.5-t2v`	نص→فيديو	`prompt` , `duration`=5\|10 , `aspect_ratio`=16:9\|9:16\|1:1, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.38
`video/wan-2.5-i2v`	صورة→فيديو	`prompt` , `image`=url , `duration`=5\|10 *, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.38
`video/wan-2.2-t2v`	نص→فيديو	`prompt` *, `aspect_ratio`=16:9\|9:16, `resolution`=480p\|720p, `safety_filter`=bool	MP4	$0.50
`video/wan-2.2-i2v`	صورة→فيديو	`prompt` , `image`=url , `resolution`=480p\|720p, `safety_filter`=bool	MP4	$0.50
`video/wan-s2v`	أفاتار (صورة+صوت)	`prompt` , `image`=url , `audio_url` *, `resolution`=480p\|580p\|720p	MP4	$0.38
`video/wan-animate-move`	فيديو→فيديو	`image`=url , `video_url` , `resolution`=480p\|580p\|720p	MP4	$0.38
`video/wan-animate-replace`	فيديو→فيديو	`image`=url , `video_url` , `resolution`=480p\|580p\|720p	MP4	$0.38
`video/seedance-2`	نص→فيديو	`prompt` *, `duration`=4–15ث, `aspect_ratio`=16:9\|9:16\|1:1\|4:3\|21:9, `resolution`=480p\|720p\|1080p\|4k, `audio`=bool, `image`=url, `image2`=url, `safety_filter`=bool	MP4	$0.26/ثانية
`video/seedance-2-fast`	نص→فيديو	`prompt` *, `duration`=4–15ث, `aspect_ratio`=16:9\|9:16\|1:1, `resolution`=480p\|720p, `audio`=bool, `image`=url, `image2`=url, `safety_filter`=bool	MP4	$0.21/ثانية
`video/seedance-2-mini`	نص→فيديو	`prompt` *, `duration`=4–15ث, `aspect_ratio`=16:9\|9:16\|1:1, `resolution`=480p\|720p, `audio`=bool, `image`=url, `image2`=url, `safety_filter`=bool	MP4	$0.13/ثانية
`video/seedance-1.5-pro`	نص→فيديو	`prompt` *, `duration`=4–12ث, `aspect_ratio`=16:9\|9:16\|1:1\|4:3, `resolution`=480p\|720p\|1080p, `audio`=bool, `image`=url, `safety_filter`=bool	MP4	$0.025/ثانية
`video/hailuo-02-t2v`	نص→فيديو	`prompt` *, `duration`=6\|10, `safety_filter`=bool	MP4	$0.19
`video/hailuo-02-t2v-pro`	نص→فيديو	`prompt` *, `safety_filter`=bool	MP4	$0.36
`video/hailuo-02-i2v`	صورة→فيديو	`prompt` , `image`=url , `image2`=url, `duration`=6\|10, `resolution`=768p\|512p, `safety_filter`=bool	MP4	$0.19
`video/hailuo-02-i2v-pro`	صورة→فيديو	`prompt` , `image`=url , `image2`=url, `safety_filter`=bool	MP4	$0.36
`video/hailuo-2.3-i2v`	صورة→فيديو	`prompt` , `image`=url , `duration`=6\|10, `resolution`=768p\|1080p, `safety_filter`=bool	MP4	$0.19
`video/hailuo-2.3-i2v-pro`	صورة→فيديو	`prompt` , `image`=url , `duration`=6\|10, `resolution`=768p\|1080p, `safety_filter`=bool	MP4	$0.28
`video/happyhorse-1.1-t2v`	نص→فيديو	`prompt` *, `duration`=3–15ث, `aspect_ratio`=16:9\|9:16\|1:1\|4:3\|3:4, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.18/ثانية
`video/happyhorse-1.1-i2v`	صورة→فيديو	`prompt`, `image`=url *, `duration`=3–15ث, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.18/ثانية
`video/happyhorse-1.1-r2v`	صورة→فيديو	`prompt` , `image`=url , `duration`=3–15ث, `aspect_ratio`=16:9\|9:16\|1:1, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.18/ثانية
`video/happyhorse-t2v`	نص→فيديو	`prompt` *, `duration`=3–15ث, `aspect_ratio`=16:9\|9:16\|1:1\|4:3\|3:4, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.30/ثانية
`video/happyhorse-i2v`	صورة→فيديو	`prompt`, `image`=url *, `duration`=3–15ث, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.30/ثانية
`video/happyhorse-edit`	فيديو→فيديو	`prompt` , `video_url` , `resolution`=720p\|1080p, `audio_source`=auto\|original	MP4	$1.50
`video/grok-t2v`	نص→فيديو	`prompt` *, `duration`=6–30ث, `aspect_ratio`=16:9\|9:16\|1:1\|3:2\|2:3, `resolution`=480p\|720p, `mode`=normal\|fun\|spicy, `safety_filter`=bool	MP4	$0.019/ثانية
`video/grok-i2v`	صورة→فيديو	`prompt` , `image`=url , `duration`=6–30ث, `resolution`=480p\|720p, `mode`=normal\|fun\|spicy, `safety_filter`=bool	MP4	$0.019/ثانية
`video/grok-1.5`	نص→فيديو	`prompt` *, `duration`=1–15ث, `aspect_ratio`=auto\|16:9\|9:16\|1:1, `resolution`=480p\|720p, `image`=url, `safety_filter`=bool	MP4	$0.019/ثانية
`video/omnihuman`	أفاتار (صورة+صوت)	`image`=url , `audio_url` , `prompt`, `resolution`=720p\|1080p	MP4	$1.69
`video/infinitalk`	أفاتار (صورة+صوت)	`prompt` , `image`=url , `audio_url` *, `resolution`=480p\|720p	MP4	$0.19
`video/lipsync`	فيديو→فيديو	`video_url` , `audio_url` , `mode`=lite\|basic	MP4	$0.50
`video/topaz-upscale`	رفع الدقة	`video_url` *, `scale`=2\|4	MP4	$0.50

🎵 الموسيقى

`model`	الوضع	معلمات `input`	الملف	السعر
`music/suno-v5`	موسيقى	`title` , `style` , `version`=v6\|v6-wild\|v6-mini, `instrumental`=bool, `prompt`	MP3	$0.075
`music/suno-cover`	موسيقى	`prompt` , `attachments`=upload[] , `version`=v6\|v6-wild\|v6-mini, `instrumental`=bool, `advanced`=bool, `title`, `style`, `duration`=10–360ث	MP3	$0.075
`music/suno-extend-upload`	موسيقى	`prompt` , `attachments`=upload[] , `version`=v6\|v6-wild\|v6-mini, `continue_from`=1–120, `instrumental`=bool	MP3	$0.075
`music/suno-add-vocals`	موسيقى	`prompt` , `attachments`=upload[] , `version`=v6\|v6-wild\|v6-mini, `style`, `title`, `exclude_styles`, `vocal`=female\|male	MP3	$0.075
`music/suno-add-instrumental`	موسيقى	`prompt` , `attachments`=upload[] , `version`=v6\|v6-wild\|v6-mini, `title`, `exclude_styles`	MP3	$0.075
`music/suno-mashup`	موسيقى	`prompt` , `attachments`=upload[] , `version`=v6\|v6-wild\|v6-mini, `instrumental`=bool, `advanced`=bool, `title`, `style`, `duration`=10–360ث	MP3	$0.075
`music/suno-sounds`	موسيقى	`prompt` *, `version`=v6\|v6-wild\|v6-mini, `loop`=bool, `bpm`=auto\|60\|80\|100\|120\|140\|160, `tonality`=auto\|C\|Dm\|Em\|F\|G\|Am\|D#m	MP3	$0.016

🎙 الصوت

`model`	الوضع	معلمات `input`	الملف	السعر
`audio/gemini-3.1-flash-tts`	تحويل النص إلى كلام	`text` *, `voice`=Achernar\|Achird\|Algenib\|Algieba\|Alnilam\|Aoede\|Autonoe\|Callirrhoe\|Charon\|Despina\|Enceladus\|Erinome\|Fenrir\|Gacrux\|Iapetus\|Kore\|Laomedeia\|Leda\|Orus\|Puck\|Pulcherrima\|Rasalgethi\|Sadachbia\|Sadaltager\|Schedar\|Sulafat\|Umbriel\|Vindemiatrix\|Zephyr\|Zubenelgenubi, `style`=vocal-smile\|newscaster\|whisper\|empathetic\|promo-hype\|deadpan, `pace`=natural\|fast\|slow\|staccato, `accent`=neutral\|american\|american-valley\|american-south\|british\|british-brixton\|transatlantic\|australian, `voice_description`, `scene`, `temperature`=0–2	WAV	$0.006
`audio/gemini-2.5-pro-tts`	تحويل النص إلى كلام	`text` *, `voice`=Achernar\|Achird\|Algenib\|Algieba\|Alnilam\|Aoede\|Autonoe\|Callirrhoe\|Charon\|Despina\|Enceladus\|Erinome\|Fenrir\|Gacrux\|Iapetus\|Kore\|Laomedeia\|Leda\|Orus\|Puck\|Pulcherrima\|Rasalgethi\|Sadachbia\|Sadaltager\|Schedar\|Sulafat\|Umbriel\|Vindemiatrix\|Zephyr\|Zubenelgenubi, `style`=vocal-smile\|newscaster\|whisper\|empathetic\|promo-hype\|deadpan, `pace`=natural\|fast\|slow\|staccato, `accent`=neutral\|american\|american-valley\|american-south\|british\|british-brixton\|transatlantic\|australian, `voice_description`, `scene`, `temperature`=0–2	WAV	$0.006
`audio/elevenlabs-tts`	تحويل النص إلى كلام	`text` *, `voice`=james\|addison\|adeline\|allison\|ana-rita\|anika\|arabella\|aria\|bella\|benjamin\|bradford\|brian\|britney\|brittney\|brock\|burt\|callum\|cassidy\|ed\|edward\|emma\|eve\|felix\|finn\|hank\|hope-poetic\|hope-bubbly\|horatius\|jamahal\|jean\|jeff\|jessica-eloquent\|jessica-chatty\|john-doe\|john-morgan\|johnny-dynamite\|johnny-kid\|kuon\|laura\|leon\|liam\|lucy\|lutz\|mark-casual\|mark-natural\|marshal\|monika\|nathan\|nathaniel\|phil\|rachel\|rex-thunder\|sam\|spuds\|sven\|taksh\|theodore\|tiffany\|tom\|viking-bjorn\|viraj-smooth\|viraj-rich\|wyatt\|xavier, `voice_id`, `speed`=0.8\|1.0\|1.2	MP3	$0.037
`audio/elevenlabs-multilingual`	تحويل النص إلى كلام	`text` *, `voice`=james\|addison\|adeline\|allison\|ana-rita\|anika\|arabella\|aria\|bella\|benjamin\|bradford\|brian\|britney\|brittney\|brock\|burt\|callum\|cassidy\|ed\|edward\|emma\|eve\|felix\|finn\|hank\|hope-poetic\|hope-bubbly\|horatius\|jamahal\|jean\|jeff\|jessica-eloquent\|jessica-chatty\|john-doe\|john-morgan\|johnny-dynamite\|johnny-kid\|kuon\|laura\|leon\|liam\|lucy\|lutz\|mark-casual\|mark-natural\|marshal\|monika\|nathan\|nathaniel\|phil\|rachel\|rex-thunder\|sam\|spuds\|sven\|taksh\|theodore\|tiffany\|tom\|viking-bjorn\|viraj-smooth\|viraj-rich\|wyatt\|xavier, `voice_id`, `speed`=0.8\|1.0\|1.2	MP3	$0.075

🧊 نماذج ثلاثية الأبعاد

المخرجات — GLB (تتيح بعض النماذج اختيار OBJ أو FBX أو STL أو USDZ أو USD أو 3MF) بالإضافة إلى صورة معاينة: تتضمن المهمة عدة ملفات، لكل منها امتداده الخاص. قائمة الملفات في الحقل results، ولكل ملف حقل ext.

لا يُعرف السعر إلا بعد التوليد

تُحتسب تكلفة التوليد ثلاثي الأبعاد بحسب الموارد المستهلكة فعليًا. نحجز الحد الأعلى الوارد في الجدول، وعندما تُعرف التكلفة الفعلية نخصمها ونُعيد الفرق. المبلغ النهائي موجود دائمًا في cost_usd.

`model`	الوضع	معلمات `input`	الملف	السعر
`3d/tripo-text`	نص→3D	`prompt` *, `negative_prompt`, `texture_detail`=standard\|high, `geometry_detail`=standard\|high, `pbr`=bool, `quad_mesh`=bool	GLB/FBX	$0.31–0.79
`3d/tripo-image`	صورة→3D	`image`=url *, `texture_detail`=standard\|high, `geometry_detail`=standard\|high, `pbr`=bool, `quad_mesh`=bool	GLB/FBX	$0.31–0.79
`3d/hunyuan-rapid-text`	نص→3D	`prompt` *, `file_format`=glb\|obj\|fbx\|stl\|usdz, `pbr`=bool, `extra_mesh`=bool	GLB وغيرها	$0.43–0.71
`3d/hunyuan-rapid-image`	صورة→3D	`image`=url *, `file_format`=glb\|obj\|fbx\|stl\|usdz, `pbr`=bool, `extra_mesh`=bool	GLB وغيرها	$0.43–0.71
`3d/hunyuan-pro-text`	نص→3D	`prompt` *, `output`=textured\|mesh, `polygons`=auto\|40000\|100000\|300000\|800000\|1500000, `pbr`=bool	GLB	$0.71–1.00
`3d/hunyuan-pro-image`	صورة→3D	`image`=url *, `output`=textured\|mesh, `polygons`=auto\|40000\|100000\|300000\|800000\|1500000, `pbr`=bool	GLB	$0.71–1.00
`3d/seed3d-image`	صورة→3D	`image`=url *, `mesh_detail`=low\|medium\|high, `file_format`=glb\|obj\|usd\|usdz	GLB/OBJ/USD	$0.50
`3d/meshy-text`	نص→3D	`prompt` *, `texture_size`=2k\|4k\|8k, `pose`=none\|a-pose\|t-pose, `ultra`=bool, `pbr`=bool, `texture_text`, `texture_photo`=url	GLB	$0.94–1.26
`3d/meshy-image`	صورة→3D	`image`=url *, `texture_size`=2k\|4k\|8k, `ultra`=bool, `texture`=bool, `pbr`=bool, `texture_text`, `texture_photo`=url	GLB	$0.94–1.26
`3d/meshy-multi-image`	زوايا متعددة→3D	`images`=[url] * (1–4), `texture_size`=2k\|4k\|8k, `ultra`=bool, `texture`=bool, `pbr`=bool, `texture_text`	GLB	$0.94–1.26

صورة كخامة. في 3d/meshy-*، تُحدَّد الخامة بشكل منفصل عن الشكل الهندسي: بصورة في texture_photo أو بوصف نصي في texture_text.

يستغرق وقتًا. يستغرق التوليد ثلاثي الأبعاد من نصف دقيقة إلى عدة دقائق — أطول من توليد صورة أو مقطع قصير. لا حاجة لإبقاء الاتصال مفتوحًا: تُحفظ الحالة، وتتوفر خطافات ويب.

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

`model`	الوضع	معلمات `input`	الملف	السعر
`image/topaz-upscale`	رفع الدقة	`image`=url *, `scale`=2\|4\|8	PNG	$0.063
`image/recraft-remove-bg`	تعديل	`image`=url *	PNG	$0.006
`image/recraft-upscale`	رفع الدقة	`image`=url *	PNG	$0.006

أمثلة حسب الأوضاع

إنشاء صورة من نص

json

{ "model": "image/flux2-pro", "input": { "prompt": "neon fox in snow", "aspect_ratio": "16:9", "resolution": "2k" } }

تحرير صورة

json

{ "model": "image/seedream-edit", "input": { "prompt": "إزالة الخلفية وإضافة نيون", "image": "https://…/photo.png" } }

صورة→فيديو (الإطار الأول/الأخير، المدة، الصوت)

json

{ "model": "video/wan-2.7-i2v", "input": {
    "prompt": "اقتراب سلس للكاميرا", "image": "https://…/first.png",
    "image2": "https://…/last.png", "duration": 8, "resolution": "1080p" } }

موسيقى

json

{ "model": "music/suno-v5", "input": { "title": "Northern Lights", "style": "epic orchestral", "instrumental": true, "version": "v6" } }

تحويل النص إلى كلام

json

{ "model": "audio/gemini-3.1-flash-tts", "input": {
    "text": "مرحبًا بالعالم", "voice": "Zephyr", "style": "empathetic",
    "pace": "natural", "accent": "neutral" } }

حوار بصوتين — استخدم dialogue للعبارات بدلًا من الحقل text، وvoices للأصوات (الصوت 1 هو الأول في القائمة):

json

{ "model": "audio/gemini-3.1-flash-tts", "input": {
    "voices": [ { "voice": "Kore", "style": "newscaster" }, { "voice": "Puck", "pace": "fast" } ],
    "dialogue": [ { "speaker": 1, "text": "مساء الخير!" }, { "speaker": 2, "text": "سعيد بسماع ذلك." } ] } }

أفاتار (فيديو ناطق من صورة + صوت)

json

{ "model": "video/omnihuman", "input": { "image": "https://…/face.png", "audio_url": "https://…/voice.mp3" } }

الحالات والأخطاء

GET /media/job/:id → الحقل status:

الحالة	المعنى
`processing`	قيد التنفيذ — واصلوا الاستعلام
`done`	جاهز — الملف في `result_url`، والخصم في `cost_usd`
`failed`	خطأ — السبب في `error`، وتم رد المبلغ

رموز الاستجابة لـ POST /media/generate: 400 — نموذج غير معروف أو حقل مطلوب غير موجود؛ 401 — المفتاح مفقود أو غير صالح؛ 402 — رصيد غير كافٍ؛ 403 — النموذج غير متاح على الحساب.

يكون نص الخطأ دائمًا بالتنسيق نفسه — { "error": "نص موجّه للمستخدم", "code": "رمز آلي" }. الرموز: unknown_model, missing_param (مع الحقل param)، invalid_input, invalid_attachment, prompt_too_long, input_too_long, no_auth, no_key, insufficient_balance, unpaid_shortfall, rate_limited, generation_failed, unavailable.

تقدير التكلفة مسبقًا

bash

curl https://nordrouter.com/media/estimate \
  -H "Authorization: Bearer sk-nr-YOUR-KEY" -H "Content-Type: application/json" \
  -d '{ "model": "video/kling-3.0", "input": { "duration": 10, "mode": "pro", "audio": true } }'

json

{ "model": "video/kling-3.0", "usd": 1.6875 }

تمت مطابقة المعلمات في الجداول مع كتالوج الخدمة بتاريخ 19.10.2026؛ للحصول على القائمة الكاملة والمحدّثة للنماذج والمعلمات والأسعار، استخدم GET /media/models.

واجهة برمجة تطبيقات الوسائط — الصور والفيديو والموسيقى ​

نقاط النهاية ​

دورة حياة الطلب ​

الفوترة ​

كتالوج النماذج ​

أسماء المعلمات السابقة ​

🖼 الصور ​

🎬 الفيديو ​

🎵 الموسيقى ​

🎙 الصوت ​

🧊 نماذج ثلاثية الأبعاد ​

🛠 الأدوات المساعدة ​

أمثلة حسب الأوضاع ​

الحالات والأخطاء ​

تقدير التكلفة مسبقًا ​

واجهة برمجة تطبيقات الوسائط — الصور والفيديو والموسيقى

نقاط النهاية

دورة حياة الطلب

الفوترة

كتالوج النماذج

أسماء المعلمات السابقة

🖼 الصور

🎬 الفيديو

🎵 الموسيقى

🎙 الصوت

🧊 نماذج ثلاثية الأبعاد

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

أمثلة حسب الأوضاع

الحالات والأخطاء

تقدير التكلفة مسبقًا