صدا و موسیقی

لغو یا حذف کار موسیقی

کار در حال اجرا را لغو می‌کند و اعتبار رزروشده را برمی‌گرداند؛ برای کار تمام‌شده فایل‌های آن را پاک می‌کند.

DELETE/v1/music/generations/{id}

رفتار به وضعیت کار بستگی دارد:

  • در حال اجرا (queued یا in_progress): کار لغو می‌شود، اعتبار رزروشده آزاد می‌شود و پاسخ همان شیء کار با status: cancelled است.
  • تمام‌شده، شکست‌خورده یا لغوشده: فایل‌های خروجی پاک می‌شوند و پاسخ { id, object, deleted: true } است. خودِ کار با output: null در دسترس می‌ماند و وضعیت‌اش را همچنان می‌توان پرسید.

پس از حذف فایل، مسیر /content خطای content_not_found می‌دهد. این درخواست رایگان است.

نمونه‌ها

curl -X DELETE https://1ai.ir/v1/music/generations/job_8Rt4mWbN2cYzHq6VxEa5Jd \
  -H "Authorization: Bearer $ONEAI_API_KEY"
200پاسخ
{
  "id": "job_8Rt4mWbN2cYzHq6VxEa5Jd",
  "object": "music",
  "model": "google/lyria-3-pro",
  "status": "cancelled",
  "progress": 20,
  "created_at": 1793923260,
  "completed_at": 1793923280,
  "prompt": "Warm acoustic pop, female vocal",
  "seconds": 60,
  "estimated_credits": 4,
  "credits": 0,
  "output": null,
  "error": null
}

پارامترهای مسیر

  • idstringالزامی

    شناسه‌ی کار به شکل job_....

خطاها

  • media_not_cancellable400

    کار همزمان با درخواست شما تمام شد و دیگر لغو نمی‌شود.

  • job_not_found404

    چنین کاری برای این حساب وجود ندارد.

صفحه‌های مرتبط