ویدیو و لیپسینک
لغو یا حذف کار ویدیو
کار در حال اجرا را لغو میکند و اعتبار رزروشده را برمیگرداند؛ برای کار تمامشده فایلهای آن را پاک میکند.
DELETE
/v1/videos/{id}رفتار به وضعیت کار بستگی دارد:
- در حال اجرا (
queuedیاin_progress): کار لغو میشود، اعتبار رزروشده آزاد میشود، تصویر مرجع نگهداریشده برای کار پاک میشود و پاسخ همان شیء کار باstatus: cancelledاست. - تمامشده، شکستخورده یا لغوشده: فایلهای خروجی پاک میشوند و پاسخ
{ id, object, deleted: true }است. خودِ کار باoutput: nullدر دسترس میماند.
پس از حذف فایل، مسیر /content خطای content_not_found میدهد. این درخواست رایگان است.
نمونهها
curl -X DELETE https://1ai.ir/v1/videos/job_9Bm3cXvK5nTzQe8WrLd6Hj \
-H "Authorization: Bearer $ONEAI_API_KEY"200پاسخ
{
"id": "job_9Bm3cXvK5nTzQe8WrLd6Hj",
"object": "video",
"model": "google/veo-3.1-lite",
"status": "cancelled",
"progress": 15,
"created_at": 1793923320,
"completed_at": 1793923345,
"prompt": "The camera slowly pushes in as clouds drift over the mountain",
"seconds": "5",
"aspect_ratio": "9:16",
"resolution": "720p",
"estimated_credits": 8,
"credits": 0,
"output": null,
"error": null
}پارامترهای مسیر
idstringالزامیشناسهی کار به شکل
job_....
خطاها
media_not_cancellable400کار همزمان با درخواست شما تمام شد و دیگر لغو نمیشود.
job_not_found404چنین کاری برای این حساب وجود ندارد.
صفحههای مرتبط
- وضعیت کار ویدیووضعیت، پیشرفت و در صورت پایان، مشخصات فایل خروجی یک کار ویدیو را برمیگرداند. پرسیدن وضعیت رایگان است.
- ساخت ویدیویک کار تولید ویدیو از روی توصیف و در صورت نیاز تصویر مرجع میسازد. پاسخ ۲۰۲ با شناسهی کار است؛ وضعیت را پیگیری و فایل را بعداً دریافت میکنید.
- دریافت فایل ویدیوبرای کار تمامشده، با ریدایرکت ۳۰۲ به یک لینک امضاشدهی فایل ویدیو میفرستد. لینک یک ساعت معتبر است.