صدا و موسیقی
وضعیت کار موسیقی
وضعیت، پیشرفت و در صورت پایان، مشخصات فایل خروجی یک کار موسیقی را برمی‌گرداند. پرسیدن وضعیت رایگان است.
/v1/music/generations/{id}مقدار status یکی از این‌هاست: queued، in_progress، completed، failed، cancelled. سه مقدار آخر پایانی هستند. هر بار که وضعیت را می‌پرسید، اگر کار موعد بررسی داشته باشد همان لحظه از سرویس تولید پرسیده می‌شود، پس لازم نیست منتظر زمان‌بند بمانید.
پس از completed، فیلد output مشخصات فایل را دارد و خود فایل را از /content می‌گیرید. در failed، فیلد error یک کد و پیام کلی دارد و اعتباری کسر نشده است؛ متن خطای سرویس تولید به شما نمی‌رسد.
فقط کارهایی را می‌بینید که با همین حساب و همین فضای کاری از طریق API ساخته‌اید. شناسه‌ی کار دیگری یا کاری از نوع دیگر 404 job_not_found است.
نمونه‌ها
curl https://1ai.ir/v1/music/generations/job_3Kp9xQvT7mYwZc2RnFh8Ad \
-H "Authorization: Bearer $ONEAI_API_KEY"{
"id": "job_3Kp9xQvT7mYwZc2RnFh8Ad",
"object": "music",
"model": "google/lyria-3-clip",
"status": "in_progress",
"progress": 40,
"created_at": 1793923200,
"completed_at": null,
"prompt": "Short calm santoor melody, instrumental",
"estimated_credits": 1.5,
"credits": 0,
"output": null,
"error": null
}پارامترهای مسیر
idstringالزامیشناسهی کار به شکل
job_...که هنگام ساخت گرفتید.
خطاها
job_not_found404چنین کاری برای این حساب وجود ندارد، یا از نوع موسیقی نیست.
صفحه‌های مرتبط
- ساخت موسیقییک کار تولید موسیقی از روی توصیف و متن ترانه میسازد. پاسخ ۲۰۲ با شناسه‌ی کار است؛ وضعیت را پیگیری و فایل را بعداً دریافت میکنید.
- دریافت فایل موسیقیبرای کار تمامشده، با ریدایرکت ۳۰۲ به یک لینک امضاشدهی فایل صوتی میفرستد. لینک یک ساعت معتبر است.
- لغو یا حذف کار موسیقیکار در حال اجرا را لغو میکند و اعتبار رزروشده را برمی‌گرداند؛ برای کار تمامشده فایلهای آن را پاک میکند.