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

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.

قم بتوليد الموسيقى والكلمات باستخدام الذكاء الاصطناعي. هذه API غير متزامنة. تعيد استجابة الإنشاء هوية المهمة، وقد تتضمن أيضًا poll_url مفضلًا عند توفره.

​
جسم الطلب

​
model
string
افتراضي:"suno_music"
النموذج المستخدم: suno_music لتوليد الموسيقى، و suno_lyrics للكلمات فقط.
​
prompt
string
مطلوب
وصف للموسيقى المراد توليدها. يمكن أن يتضمن النمط، والمزاج، والآلات الموسيقية، وما إلى ذلك.
​
title
string
عنوان الأغنية التي تم توليدها.
​
tags
string
علامات النمط (مثل: “pop, upbeat, electronic”).
​
action
string
نوع التوليد: MUSIC (افتراضي) أو LYRICS.
​
mv
string
إصدار النموذج المستخدم.
​
continue_clip_id
string
معرف (ID) لمقطع سابق للمتابعة منه.
​
continue_at
number
الطابع الزمني (بالثواني) للمتابعة منه.
​
user
string
معرف فريد للمستخدم النهائي.

​
الاستجابة

​
id
string
معرف المهمة (Task ID) للاستعلام عن الحالة.
​
task_id
string
الاسم البديل لمعرّف المهمة غير المتزامنة عندما يعيده المهايئ.
​
poll_url
string
رابط polling المفضّل عندما يكون متاحًا.
​
status
string
حالة المهمة: pending أو processing أو completed أو failed.
​
created
integer
طابع Unix الزمني لوقت إنشاء المهمة.
curl -X POST "https://api.tokenlab.sh/v1/music/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno_music",
    "prompt": "An upbeat electronic dance track with heavy bass",
    "title": "Night Drive",
    "tags": "electronic, EDM, energetic"
  }'

{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "created": 1706000000,
  "model": "suno_music"
}