ایران ناتیفیکیشن

ثبت درخواست ساخت ویدئو

یک کار ساخت ویدئو در صف می‌گذارد و `201` برمی‌گرداند.

POSThttps://api.irnoti.com/v1/video/jobs
scope: video.create

اعتبار لازم هنگام ثبت رزرو و پس از پایان تسویه می‌شود؛ اگر کار شکست بخورد یا لغو شود رزرو آزاد می‌گردد. کلید سندباکس به پرووایدر نمی‌رسد و 403 sandbox_unsupported می‌گیرد. تعداد کارهای هم‌زمان هر کاربر محدود است. وضعیت را با GET /video/jobs/{id} پیگیری کنید.

پارامترها

ناممحلنوعتوضیح
prompt *بدنهstringتوضیح صحنه (۳ تا ۲۰۰۰ نویسه).
durationSec *بدنهintegerمدت ویدئو به ثانیه (۱ تا ۶۰، حداکثر طبق مدل).
modelبدنهstringکد مدل از GET /video/models؛ اگر نیاید استودیو انتخاب می‌کند.
negativePromptبدنهstringچیزهایی که نباید در ویدئو باشد (حداکثر ۱۰۰۰ نویسه).
imageMediaIdبدنهstringشناسهٔ تصویر آپلودشده برای ساخت ویدئو از روی تصویر.
aspectبدنه'16:9' | '9:16' | '1:1'نسبت تصویر؛ پیش‌فرض 16:9.
resolutionبدنه'720p' | '1080p'کیفیت؛ پیش‌فرض 720p.
seedبدنهintegerبذر تصادفی برای نتیجهٔ تکرارپذیر.
Idempotency-Keyهدرstringکلید یکتا (حداکثر ۱۰۰ نویسه) برای جلوگیری از ثبت دوباره.

خطاهای خاص این endpoint

402insufficient_creditاعتبار کافی نیست.
403sandbox_unsupportedکلید سندباکس ویدئو نمی‌سازد.
429too_many_activeتعداد کارهای فعال از سقف بیشتر است.

اجرای زنده (محیط تست)

باز کردن در کنسول کامل ←

این endpoint در محیط تست پشتیبانی نمی‌شود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.

curl -X POST 'https://api.irnoti.com/v1/video/jobs' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: vid-1001' \
  -d '{
  "model": "veo-fast",
  "aspect": "16:9",
  "prompt": "غروب خورشید روی دریای خزر",
  "resolution": "720p",
  "durationSec": 6
}'
پاسخ نمونه200 OK
{
  "id": "77",
  "status": "queued",
  "progress": 0
}
ثبت درخواست ساخت ویدئو — مستندات API | ایران ناتیفیکیشن