الموسيقى

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

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

GET
/v1/tasks/{id}

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)

idstringpathمطلوب

معرف مهمة توليد الموسيقى.

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

idstring

معرف المهمة.

task_idstring

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

poll_urlstring

رابط الحالة لهذه المهمة. قم بعمل استطلاع (poll) لـ GET /v1/tasks/{id} باستخدام id.

statusstring

حالة المهمة: pending (قيد الانتظار)، processing (قيد المعالجة)، completed (مكتملة)، failed (فاشلة)، أو timeout (انتهت المهلة). المهمة الفاشلة لا تزال تُرجع HTTP 200.

progressinteger

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

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

audio_idstring

معرف الصوت المصدر الاختياري، يمكن استخدامه مع معرف هذه المهمة في العمليات اللاحقة المدعومة.

dataarray

مصفوفة المخرجات الاختيارية، بما في ذلك ملفات الصوت المفصولة مع audio_url أو url.

audio_urlstring

رابط لتنزيل ملف الصوت (عند اكتماله). رابط نتيجة وسائط من TokenLab يظل صالحاً لمدة 30 يوماً.

video_urlstring

رابط نسخة الفيديو مع المرئي (عند اكتماله وإرجاعه للنموذج).

image_urlstring

رابط صورة الغلاف، عندما يُرجع النموذج واحدة.

titlestring

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

lyricsstring

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

errorstring | object

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

error_detailsobject

تفاصيل الفشل عند فشل المهمة: status، message، type، code، retryable، و param عندما يكون حقل الطلب هو السبب.

media_retentionobject

حالة حفظ روابط النتائج: 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"

الاستجابة

Response (Completed)
{
  "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
AuthorizationBearer <token>

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

الموضع: header

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

id*string

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

الاستجابة

application/json

application/json

application/json

application/json

application/json

application/json

application/json