ویدیو و لیپ‌سینک
دریافت فایل ویدیو
برای کار تمام‌شده، با ریدایرکت ۳۰۲ به یک لینک امضاشده‌ی فایل ویدیو می‌فرستد. لینک یک ساعت معتبر است.
/v1/videos/{id}/contentاین مسیر خودِ فایل را در پاسخ نمی‌فرستد، بلکه با 302 به یک لینک امضاشده هدایت می‌کند که یک ساعت اعتبار دارد و فایل را به صورت دانلود می‌دهد. SDKها و ابزارهایی که ریدایرکت را دنبال می‌کنند (در curl با -L) فایل را می‌گیرند. لینک امضاشده نیازی به کلید API ندارد.
قبل از پایان کار 409 job_not_ready می‌گیرید. اگر فایل پس از پایان با DELETE پاک شده باشد، 404 content_not_found می‌گیرید. این مسیر رایگان است.
نمونه‌ها
curl https://1ai.ir/v1/videos/job_4Ws8nTqL3xYbCe7RmKh2Zf/content \
-H "Authorization: Bearer $ONEAI_API_KEY" \
--output result.mp4ریدایرکت به لینک امضاشده‌ی ویدیو؛ پس از دنبال کردن، بایت‌های فایل می‌آید.
پارامترهای مسیر
idstringالزامیشناسهی کار به شکل
job_....
پارامترهای کوئری
redirectstringبا مقدار
falseبه‌جای ریدایرکت ۳۰۲، پاسخ JSON با فیلدهایurlوmimeوexpires_inبرمی‌گردد. این حالت برای برنامه‌های مرورگری است که نمی‌توانند ریدایرکت را با کلید دنبال کنند.مقادیر مجاز:false
خطاها
job_not_found404چنین کاری برای این حساب وجود ندارد.
content_not_found404فایل این کار پاک شده است.
job_not_ready409کار هنوز تمام نشده یا شکست خورده یا لغو شده است و فایلی ندارد.
صفحه‌های مرتبط
- وضعیت کار ویدیووضعیت، پیشرفت و در صورت پایان، مشخصات فایل خروجی یک کار ویدیو را برمی‌گرداند. پرسیدن وضعیت رایگان است.
- ساخت ویدیویک کار تولید ویدیو از روی توصیف و در صورت نیاز تصویر مرجع می‌سازد. پاسخ ۲۰۲ با شناسه‌ی کار است؛ وضعیت را پیگیری و فایل را بعداً دریافت می‌کنید.
- لغو یا حذف کار ویدیوکار در حال اجرا را لغو می‌کند و اعتبار رزروشده را برمی‌گرداند؛ برای کار تمام‌شده فایل‌های آن را پاک می‌کند.