ویدئو

POST /v1/videos — ساخت ویدئو، تا پایان کار در همان درخواست، و دریافت فایل از خود ما.

POSThttps://iranrouter.com/v1/videos

ساخت ویدئو. کار به سرور بالادستی سپرده می‌شود و همین درخواست تا پایان آن باز می‌ماند — معمولاً یک تا چند دقیقه — سپس با شناسهٔ کار جواب می‌دهد. timeout کلاینت را دست‌کم ۱۰ دقیقه بگذارید.

Shell

curl https://iranrouter.com/v1/videos \
  -H "Authorization: Bearer ir-..." \
  -H "Content-Type: application/json" \
  --max-time 900 \
  -d '{
    "model": "alibaba/wan-3.0",
    "prompt": "یک گربه روی دوچرخه در خیابان بارانی",
    "duration": 5,
    "resolution": "720p"
  }'

JSON

{
  "id": "3f6c...-request-id",
  "object": "video.job",
  "model": "alibaba/wan-3.0",
  "status": "completed",
  "content_url": "/v1/videos/3f6c...-request-id/content",
  "usage": { "cost_rial": 1250000 }
}

پارامتر	توضیح
`prompt`	الزامی.
`duration`	ثانیه. هر مدل بازهٔ مجاز خودش را دارد (صفحهٔ مدل).
`resolution / size / aspect_ratio`	480p … 4K، یا ابعاد دقیق WIDTHxHEIGHT، یا نسبت تصویر.
`generate_audio`	روی مدل‌هایی که صدا می‌سازند؛ معمولاً قیمت جدا دارد.
`input_references / frame_images`	تصویر یا ویدئوی مرجع، و قاب اول/آخر.
`callback_url`	پذیرفته نمی‌شود: سرور بالادستی هرگز مستقیم با شما تماس نمی‌گیرد.

اگر ساخت ویدئو از عمر درخواست بیشتر شود (سقف زمانی، یا قطع اتصال از سمت شما)، کار لغو نمی‌شود: پاسخ ۲۰۲ با status برابر in_progress و یک poll_url می‌گیرید. GET /v1/videos/{id} را تا completed (یا failed) poll کنید؛ رزرو کیف پول تا آن موقع می‌ماند و مبلغ نهایی با پایان کار تسویه می‌شود. تا پیش از completed، مسیر content پاسخ ۴۰۹ با کد video_not_ready می‌دهد.

GEThttps://iranrouter.com/v1/videos/{id}/content

فایل ویدئو (video/mp4)، از طریق ما. شناسه همان id پاسخ بالاست و فقط با کلید همان حساب کار می‌کند. GET /v1/videos/{id} هم وضعیت کار را برمی‌گرداند.

Shell

curl https://iranrouter.com/v1/videos/3f6c...-request-id/content -H "Authorization: Bearer ir-..." -o out.mp4

قیمت

ویدئو توکنی نیست. هر مدل یک جدول قیمت دارد (هر ثانیه بر حسب رزولوشن و صدا، گاهی حداقل هر ساخت) که در صفحهٔ مدل به ریال آمده. پیش از ارسال، گران‌ترین خوانش این جدول برای درخواست شما از کیف پول رزرو می‌شود؛ پس از پایان کار، مبلغ نهایی از صورت‌حساب واقعی همان کار حساب و مابقی رزرو آزاد می‌شود. کاری که شکست بخورد چیزی شارژ نمی‌شود.

ویدئو فقط با کلید اعتباری (کیف پول) کار می‌کند؛ سهمیهٔ توکنی پلن آن را پوشش نمی‌دهد و کلید پلنی ۴۰۳ می‌گیرد.