البدء السريع عبر HTTP الخام

استخدم هذا الدليل عندما تريد أمثلة HTTP مباشرة. إذا كنت تبني باستخدام Node.js أو Bun، فابدأ بدلًا من ذلك بـ البدء السريع لـ Node.js SDK.

1. إنشاء هدف رفع

curl -X POST https://api.youka.io/ar/api/v1/uploads \
  -H "Authorization: Bearer yk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "song.mp3",
    "contentType": "audio/mpeg",
    "contentLength": 12345678
  }'

ارفع بايتات الملف إلى uploadUrl المُعاد.

2. إنشاء مشروع

curl -X POST https://api.youka.io/ar/api/v1/projects \
  -H "Authorization: Bearer yk_..." \
  -H "Idempotency-Key: create-project-song-1" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Artist - Song",
    "inputFileId": "file_123",
    "lyricsSource": {
      "type": "align",
      "lyrics": "First line\nSecond line\n...",
      "syncModel": "musicai-alignment",
      "language": "en"
    },
    "splitModel": "mdx23c"
  }'

3. استطلاع المهمة

curl https://api.youka.io/ar/api/v1/tasks/task_123 \
  -H "Authorization: Bearer yk_..."

عندما تكون المهمة في حالة نهائية، سيحتوي output الخاص بها على معرّفات النتائج الرئيسية للعملية.

4. قراءة حالة المشروع

curl https://api.youka.io/ar/api/v1/projects/proj_123 \
  -H "Authorization: Bearer yk_..."

يعيد هذا حالة المشروع طويلة الأمد، بما في ذلك المسارات المنفصلة (stems) والمحاذاة (alignments) والتصديرات (exports) وإعدادات المشروع النشطة.

5. إنشاء تصدير

curl -X POST https://api.youka.io/ar/api/v1/projects/proj_123/exports \
  -H "Authorization: Bearer yk_..." \
  -H "Idempotency-Key: export-song-1" \
  -H "Content-Type: application/json" \
  -d '{
    "resolution": "1080p",
    "quality": "high"
  }'

ثم قم باستطلاع المهمة المُعادة أو اقرأ التصدير مباشرة:

curl https://api.youka.io/ar/api/v1/exports/export_123 \
  -H "Authorization: Bearer yk_..."