الموسيقى
الحصول على حالة الموسيقى
استرجاع حالة ونتيجة مهمة توليد الموسيقى
GET /v1/music/generations/{id} هو نقطة نهاية للتوافق. يظل مدعوماً لعمليات التكامل الحالية. عمليات التكامل الجديدة تستخدم GET /v1/tasks/{id}؛ راجع الحصول على حالة المهمة.
قم باستدعاء GET /v1/tasks/{id} للتحقق من حالة مهمة توليد الموسيقى الخاصة بك.
id و task_id يشيران إلى نفس المهمة.
المهمة العامة منتهية الصلاحية أو غير المتاحة قد تُرجع 404 async_task_not_found. إذا تعذر إثبات ملكية المهمة لمفتاح API الحالي، تكون الاستجابة 403 task_not_owned.
معاملات المسار (Path Parameters)
معرف مهمة توليد الموسيقى.
الاستجابة (Response)
معرف المهمة.
اسم مستعار لنفس معرف المهمة غير المتزامنة، عند إرجاعه.
رابط الحالة لهذه المهمة. قم بعمل استطلاع (poll) لـ GET /v1/tasks/{id} باستخدام id.
حالة المهمة: pending (قيد الانتظار)، processing (قيد المعالجة)، completed (مكتملة)، failed (فاشلة)، أو timeout (انتهت المهلة). المهمة الفاشلة لا تزال تُرجع HTTP 200.
قيمة التقدم الاختيارية. تُرجع فقط عندما تكون قيمة التقدم الحقيقية متاحة؛ استخدم status لتحديد الاكتمال.
تعتمد حقول النتيجة على العملية. قد تُرجع الموسيقى audio_url و audio_id؛ المهام التي تحتوي على كلمات الأغاني فقط تُرجع lyrics؛ عمليات الفصل قد تُرجع ملفات متعددة في data. video_url والعنوان والتقدم والبيانات الوصفية الأخرى اختيارية. تحقق من status لمعرفة الاكتمال واقرأ الحقول التي تم إرجاعها فعلياً.
معرف الصوت المصدر الاختياري، يمكن استخدامه مع معرف هذه المهمة في العمليات اللاحقة المدعومة.
مصفوفة المخرجات الاختيارية، بما في ذلك ملفات الصوت المفصولة مع audio_url أو url.
رابط لتنزيل ملف الصوت (عند اكتماله). رابط نتيجة وسائط من TokenLab يظل صالحاً لمدة 30 يوماً.
رابط نسخة الفيديو مع المرئي (عند اكتماله وإرجاعه للنموذج).
رابط صورة الغلاف، عندما يُرجع النموذج واحدة.
عنوان الأغنية المولدة.
كلمات الأغاني المولدة أو المقدمة.
رسالة الخطأ (عند الفشل).
تفاصيل الفشل عند فشل المهمة: status، message، type، code، retryable، و param عندما يكون حقل الطلب هو السبب.
حالة حفظ روابط النتائج: days و items[] مع url و kind و status و expires_at. قد تكون غائبة؛ الروابط لا تزال تعمل. راجع الاحتفاظ بالبيانات.
الطلب
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://api.tokenlab.sh/v1/media-results/2d7e9a41-8c3b-4b6f-a1e5-7f0c3d9b8e26.mp3?token=…",
"title": "Night Drive",
"lyrics": "[Verse 1]\nDriving through the night...",
"audio_id": "audio_abc123",
"media_retention": {
"days": 30,
"items": [
{
"url": "https://api.tokenlab.sh/v1/media-results/2d7e9a41-8c3b-4b6f-a1e5-7f0c3d9b8e26.mp3?token=…",
"kind": "audio",
"content_type": "audio/mpeg",
"status": "saved",
"expires_at": "2024-02-22T08:54:20.000Z"
}
]
}
}التفويض
BearerAuth مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
معاملات المسار
معرف المهمة غير المتزامنة الذي يتم إرجاعه بواسطة id / task_id، أو المضمن في poll_url
الاستجابة
application/json
application/json
application/json
application/json
application/json
application/json
application/json