الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

استعلم دورياً (Poll) عن نقطة النهاية هذه للتحقق من حالة مهمة إنشاء الموسيقى الخاصة بك.
إذا تضمنت استجابة الإنشاء poll_url، فامنح الأفضلية لهذا الرابط الدقيق عند إجراء polling. يجب التعامل مع id وtask_id على أنهما هوية المهمة غير المتزامنة نفسها.إذا لم تعد المهمة موجودة أو لم يعد بالإمكان حلّها عبر عقد المهام غير المتزامنة العامة، يعيد TokenLab القيمة async_task_not_found مع الرسالة Task not found or no longer available.

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

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

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

​
id
string
معرف المهمة.
​
task_id
string
الاسم البديل لمعرّف المهمة غير المتزامنة عندما يكون متاحًا.
​
status
string
حالة المهمة: pending أو processing أو completed أو failed.
​
progress
integer
نسبة التقدم (0-100).
​
audio_url
string
رابط (URL) لتنزيل ملف الصوت (عند الاكتمال).
​
video_url
string
رابط (URL) لنسخة الفيديو مع المصور المرئي (عند الاكتمال).
​
title
string
عنوان الأغنية المنشأة.
​
lyrics
string
كلمات الأغنية المنشأة أو المقدمة.
​
error
string
رسالة الخطأ (عند الفشل).
curl "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",
  "video_url": "https://cdn.example.com/music/abc123.mp4",
  "title": "Night Drive",
  "lyrics": "[Verse 1]\nDriving through the night..."
}