الانتقال إلى المحتوى الرئيسي
استعلم دورياً (Poll) عن نقطة النهاية هذه للتحقق من حالة مهمة إنشاء الموسيقى الخاصة بك.
إذا تضمنت استجابة الإنشاء poll_url، فامنح الأفضلية لهذا الرابط الدقيق عند إجراء polling. يجب التعامل مع id وtask_id على أنهما هوية المهمة غير المتزامنة نفسها.إذا لم تعد المهمة موجودة أو لم يعد بالإمكان حلّها عبر عقد المهام غير المتزامنة العامة، يعيد AI Sonar القيمة 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.aisonar.dev/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..."
}