API رسانه — تصویر، ویدیو، موسیقی

با همان کلید 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. ایجاد کار

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 } }'

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

2. نظرسنجی برای دریافت وضعیت (هر ۳ تا ۵ ثانیه)

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

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

3. دریافت فایل — از طریق result_url. پیوند روی nordrouter.com قرار دارد (برند شما)؛ فایل‌ها ۱۴ روز نگهداری و سپس حذف می‌شوند؛ آن‌ها را از قبل دانلود کنید یا به فضای خود منتقل کنید.

بارگذاری فایل‌های رسانه‌ای منبع

فیلدهای image، image2، audio_url و video_url یک پیوند عمومی مستقیم می‌پذیرند. مدل‌هایی که فیلد attachments دارند، آرایه‌ای از اشیایی را می‌پذیرند که POST /media/upload برمی‌گرداند: { "data": "data:audio/mpeg;base64,…", "name": "track.mp3" } را ارسال کنید، سپس تمام پاسخ بارگذار را در input.attachments قرار دهید. برای Suno می‌توانید به‌جای آن یک URL عمومی در input.source_url و برای mashup دو URL در input.source_urls ارسال کنید.

صورتحساب

هزینه‌ها از موجودی دلاری شما (همان موجودی مدل‌های متنی) و به‌ازای تولید انجام‌شده، دقیقاً به مبلغ درج‌شده در جدول‌های زیر کسر می‌شوند.

• رزرو → مبلغ واقعی. هنگام ایجاد کار، هزینه تخمینی رزرو می‌شود؛ پس از تکمیل، مبلغ بر اساس نتیجه واقعی محاسبه مجدد می‌شود و مبلغ اضافه به موجودی بازمی‌گردد.
• ویدیو — بر اساس ثانیه. قیمت با افزایش مدت و وضوح بالا می‌رود؛ فعال بودن صدا هزینه بیشتری دارد. جدول‌ها قیمت «از» را برای تنظیمات پیش‌فرض نشان می‌دهند؛ /ثانیه یعنی تعرفه هر ثانیه.
• برای خطا هزینه‌ای دریافت نمی‌شود. اگر کار با وضعیت failed تمام شود، کل مبلغ رزروشده بازگردانده می‌شود؛ فقط برای تولیدهای موفق هزینه می‌پردازید.
• قیمت دقیق از قبل — POST /media/estimate را با همان model و input ارسال کنید تا پیش از اجرا { "usd": … } را دریافت کنید.
• افزایش موجودی با روبل انجام می‌شود (تقریباً $1 = 89–96 ₽)؛ سپس همه‌چیز به USD محاسبه می‌شود.

فهرست مدل‌ها

قیمت: برای ویدیو، نرخ به‌ازای هر ثانیه (/ثانیه) است؛ مبلغ نهایی = نرخ × مدت‌زمان (وضوح و صدا نیز می‌توانند آن را تغییر دهند). برای بقیه، قیمت به‌ازای هر تولید با تنظیمات پیش‌فرض محاسبه می‌شود. هزینه دقیق هر پیکربندی را POST /media/estimate برمی‌گرداند.

ممکن است تعداد فیلدهای input بیشتر باشد؛ فهرست ماشین‌خوان (انواع، گزینه‌ها، مقادیر پیش‌فرض و بازه‌های زمانی برحسب ثانیه) همیشه با GET /media/models ارائه می‌شود. فیلدهای الزامی با * مشخص شده‌اند. هر فیلد اضافی مدل (negative_prompt، seed، cfg_scale و...) را می‌توان مستقیماً در input فرستاد.

نام‌های قبلی پارامترها

در ۱۹ اکتبر ۲۰۲۶، نام‌ها و مقادیر پارامترها یکپارچه شدند: 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

🧊 مدل‌های 3D

خروجی GLB است (برای برخی مدل‌ها می‌توان از میان OBJ، FBX، STL، USDZ، USD و 3MF انتخاب کرد) به‌علاوه تصویر پیش‌نمایش: هر کار، چند فایل دارد و پسوند هر فایل متفاوت است. فهرست فایل‌ها در فیلد results قرار دارد و هر مورد ext دارد.

هزینه فقط پس از تولید مشخص می‌شود

هزینه 3D بر اساس منابع مصرف‌شده واقعی محاسبه می‌شود. مبلغ سقف جدول را موقتاً نگه می‌داریم و پس از مشخص‌شدن هزینه واقعی، آن را کسر می‌کنیم و مابه‌التفاوت را بازمی‌گردانیم. مبلغ نهایی همیشه در 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.

زمان‌بر. تولید 3D از نیم‌دقیقه تا چند دقیقه طول می‌کشد؛ بیشتر از تولید تصویر و کلیپ کوتاه. نیازی به باز نگه‌داشتن اتصال نیست: وضعیت ذخیره می‌شود و وب‌هوک‌ها در دسترس‌اند.

🛠 ابزارهای کمکی

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

نمونه‌ها بر اساس حالت

تصویر از متن

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

ویرایش تصویر

{ "model": "image/seedream-edit", "input": { "prompt": "پس‌زمینه را حذف کن، نور نئون اضافه کن", "image": "https://…/photo.png" } }

عکس→ویدیو (فریم اول/آخر، مدت، صدا)

{ "model": "video/wan-2.7-i2v", "input": {
    "prompt": "حرکت نرم دوربین به جلو", "image": "https://…/first.png",
    "image2": "https://…/last.png", "duration": 8, "resolution": "1080p" } }

موسیقی

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

تبدیل متن به گفتار

{ "model": "audio/gemini-3.1-flash-tts", "input": {
    "text": "سلام دنیا", "voice": "Zephyr", "style": "empathetic",
    "pace": "natural", "accent": "neutral" } }

گفت‌وگو با دو صدا — به‌جای فیلد text، جمله‌ها در dialogue و صداها در voices قرار می‌گیرند (صدای ۱ — اولین مورد در فهرست):

{ "model": "audio/gemini-3.1-flash-tts", "input": {
    "voices": [ { "voice": "Kore", "style": "newscaster" }, { "voice": "Puck", "pace": "fast" } ],
    "dialogue": [ { "speaker": 1, "text": "عصر بخیر!" }, { "speaker": 2, "text": "از شنیدنش خوشحالم." } ] } }

آواتار (ویدیوی سخنگو از عکس + صدا)

{ "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.

برآورد هزینه پیش از اجرا

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 } }'

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

---

پارامترهای جدول‌ها در تاریخ 19.10.2026 با کاتالوگ سرویس تطبیق داده شده‌اند؛ فهرست کامل و به‌روز مدل‌ها، پارامترها و قیمت‌ها — GET /media/models.