ویدیو و لیپ‌سینک
وضعیت کار ویدیو
وضعیت، پیشرفت و در صورت پایان، مشخصات فایل خروجی یک کار ویدیو را برمی‌گرداند. پرسیدن وضعیت رایگان است.
/v1/videos/{id}مقدار status یکی از این‌هاست: queued، in_progress، completed، failed، cancelled. سه مقدار آخر پایانی هستند. هر بار که وضعیت را می‌پرسید، اگر کار موعد بررسی داشته باشد همان لحظه از سرویس تولید پرسیده می‌شود. کار ویدیو چند دقیقه طول می‌کشد، پس با فاصله‌ی چند ثانیه بپرسید و ادامه ندهید.
پس از completed، فیلد output مشخصات فایل (نوع، حجم، مدت، عرض و ارتفاع) را دارد و خود فایل را از /content می‌گیرید. در failed، فیلد error کدی کلی دارد و اعتباری کسر نشده است؛ متن خطای سرویس تولید به شما نمی‌رسد.
فقط کارهایی را می‌بینید که با همین حساب و همین فضای کاری از طریق API ساخته‌اید. شناسه‌ی کار دیگری یا کاری از نوع دیگر 404 job_not_found است.
نمونه‌ها
curl https://1ai.ir/v1/videos/job_4Ws8nTqL3xYbCe7RmKh2Zf \
-H "Authorization: Bearer $ONEAI_API_KEY"{
"id": "job_4Ws8nTqL3xYbCe7RmKh2Zf",
"object": "video",
"model": "kling/kling-v3.0-pro",
"status": "in_progress",
"progress": 55,
"created_at": 1793923200,
"completed_at": null,
"prompt": "A red apple slowly rotating on a white table",
"seconds": "5",
"aspect_ratio": "16:9",
"resolution": "720p",
"estimated_credits": 12,
"credits": 0,
"output": null,
"error": null
}پارامترهای مسیر
idstringالزامیشناسهی کار به شکل
job_...که هنگام ساخت گرفتید.
خطاها
job_not_found404چنین کاری برای این حساب وجود ندارد، یا از نوع ویدیو نیست.
صفحه‌های مرتبط
- ساخت ویدیویک کار تولید ویدیو از روی توصیف و در صورت نیاز تصویر مرجع میسازد. پاسخ ۲۰۲ با شناسه‌ی کار است؛ وضعیت را پیگیری و فایل را بعداً دریافت میکنید.
- دریافت فایل ویدیوبرای کار تمامشده، با ریدایرکت ۳۰۲ به یک لینک امضاشدهی فایل ویدیو میفرستد. لینک یک ساعت معتبر است.
- لغو یا حذف کار ویدیوکار در حال اجرا را لغو میکند و اعتبار رزروشده را برمی‌گرداند؛ برای کار تمامشده فایلهای آن را پاک میکند.