الانتقال إلى المحتوى الرئيسي
استعلم دورياً (Poll) عن نقطة النهاية هذه للتحقق من حالة مهمة إنشاء الموسيقى الخاصة بك.
إذا تضمنت استجابة الإنشاء poll_url، فامنح الأفضلية لهذا الرابط الدقيق عند إجراء polling. يجب التعامل مع id وtask_id على أنهما هوية المهمة غير المتزامنة نفسها.If the task no longer exists or can no longer be resolved through the public async-task contract, LemonData returns async_task_not_found with the message Task not found or no longer available.

معلمات المسار (Path Parameters)

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.lemondata.cc/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..."
}