ثبت درخواست ساخت ویدئو
یک کار ساخت ویدئو در صف میگذارد و `201` برمیگرداند.
POST
scope: video.createhttps://api.irnoti.com/v1/video/jobsاعتبار لازم هنگام ثبت رزرو و پس از پایان تسویه میشود؛ اگر کار شکست بخورد یا لغو شود رزرو آزاد میگردد. کلید سندباکس به پرووایدر نمیرسد و 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
| 402 | insufficient_credit | اعتبار کافی نیست. |
| 403 | sandbox_unsupported | کلید سندباکس ویدئو نمیسازد. |
| 429 | too_many_active | تعداد کارهای فعال از سقف بیشتر است. |
اجرای زنده (محیط تست)
باز کردن در کنسول کامل ←این endpoint در محیط تست پشتیبانی نمیشود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.