TokenLab
الحصول على مفتاح API
التوثيقمرجع APIالتكاملات

الموسيقى

الحصول على حالة الموسيقى

يسترجع حالة ونتيجة مهمة إنشاء الموسيقى

GET
/v1/tasks/{id}

استعلم دورياً (Poll) عن نقطة النهاية هذه للتحقق من حالة مهمة إنشاء الموسيقى الخاصة بك.

إذا تضمنت استجابة الإنشاء poll_url، فامنح الأفضلية لهذا الرابط الدقيق عند إجراء polling. يجب التعامل مع id وtask_id على أنهما هوية المهمة غير المتزامنة نفسها.

قد تعيد المهمة العامة المنتهية أو غير المتاحة 404 async_task_not_found. إذا تعذر إثبات ملكية المهمة لمفتاح API الحالي، تكون الاستجابة 403 task_not_owned.

معلمات المسار

idstringpathمطلوب

معرف (ID) مهمة إنشاء الموسيقى.

الاستجابة (Response)

idstring

معرف المهمة.

task_idstring

اسم بديل لمعرّف المهمة غير المتزامنة نفسه، عند إرجاعه.

poll_urlstring

عنوان URL المفضل للاستعلام عند توفيره في استجابة الإنشاء.

statusstring

حالة المهمة: pending أو processing أو completed أو failed.

progressinteger

قيمة تقدم اختيارية. لا تُعاد إلا عند توفر قيمة تقدم حقيقية؛ استخدم status لتحديد اكتمال المهمة.

تعتمد حقول النتيجة على العملية. قد تعيد الموسيقى audio_url وaudio_id، وتعيد مهام الكلمات lyrics، وقد يعيد الفصل عدة ملفات في data. الحقول video_url والعنوان والتقدم وغيرها اختيارية. تحقق من الاكتمال عبر status واقرأ الحقول التي أُعيدت فعليًا.

audio_idstring

معرّف صوت اختياري يمكن استخدامه مع معرّف هذه المهمة في عمليات المتابعة المدعومة.

dataarray

مصفوفة مخرجات اختيارية، تشمل ملفات المسارات المفصولة مع audio_url أو url.

audio_urlstring

رابط (URL) لتنزيل ملف الصوت (عند الاكتمال).

video_urlstring

رابط (URL) لنسخة الفيديو مع المصور المرئي (عند الاكتمال).

titlestring

عنوان الأغنية المنشأة.

lyricsstring

كلمات الأغنية المنشأة أو المقدمة.

errorstring | object

رسالة الخطأ (عند الفشل).

الطلب

curl --fail-with-body "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"

الاستجابة

الاستجابة (مكتملة)
{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "completed",
  "audio_url": "https://cdn.example.com/music/abc123.mp3",
  "title": "Night Drive",
  "lyrics": "[Verse 1]\nDriving through the night...",
  "audio_id": "audio_abc123"
}

التفويض

BearerAuth
AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

معاملات المسار

id*string

معرف المهمة غير المتزامنة الذي يتم إرجاعه بواسطة id / task_id، أو المضمن في poll_url

الاستجابة

application/json

application/json

application/json

application/json

إنشاء الموسيقى

السابق

إنشاء فيديو

التالي