جرّب OPTES
منصّة المطوّرين مرجع الواجهة

إنشاء موسيقى

POST/v1/music

مهمة غير متزامنة مثل الفيديو: تبدأها، ثم تتابعها، ثم تنزّل الملف.

النماذج: optes-music-1

معاملات الطلب

application/json
  • modelstringمطلوب

    optes-music-1.

  • promptstringمطلوب

    الأسلوب والآلات والمزاج.

  • durationintegerاختياري

    بالثواني، من 10 إلى 240.

  • instrumentalbooleanاختياري

    مقطوعة بلا كلمات.

  • lyricsstringاختياري

    كلمات الأغنية.

يرجع

كائن music بالحالات نفسها: queued ثم in_progress ثم completed أو failed. المهمة الفاشلة لا تُحسب.

حالة المهمة

GET/v1/music/{id}

يرجع كائن music بحالته الحالية.

تنزيل الملف

GET/v1/music/{id}/content

يرجع ملف الصوت بعد اكتمال المهمة.

curl https://api.optes3.com/v1/music \  -H "Authorization: Bearer $OPTES_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "optes-music-1",    "prompt": "موسيقى عود هادئة مع إيقاع خفيف، لافتتاحية لعبة",    "duration": 90,    "instrumental": true  }'
Response
{  "id": "music_Q81a",  "object": "music",  "model": "optes-music-1",  "status": "queued",  "duration": 90}

الأسعار بالدولار الأمريكي، وهي أوّلية حتى الإطلاق. الواجهة البرمجية والتسجيل والمفاتيح تُفتح يوم الإطلاق.