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