> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youka.io/llms.txt
> Use this file to discover all available pages before exploring further.

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

> استخدم cURL لرفع ملف، وإنشاء مشروع، واستطلاع المهمة، وتصدير ناتج الكاراوكي النهائي.

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

استخدم هذا الدليل عندما تريد أمثلة HTTP مباشرة.

إذا كنت تبني باستخدام Node.js أو Bun، فابدأ بدلًا من ذلك بـ [البدء السريع لـ Node.js SDK](/ar/sdk).

## 1. إنشاء وجهة رفع

```bash theme={null}
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. إنشاء مشروع

```bash theme={null}
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. استطلاع المهمة

```bash theme={null}
curl https://api.youka.io/ar/api/v1/tasks/task_123 \
  -H "Authorization: Bearer yk_..."
```

عندما تصل المهمة إلى حالة نهائية، يحتوي `output` على معرّفات النتائج الأساسية للعملية.

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

```bash theme={null}
curl https://api.youka.io/ar/api/v1/projects/proj_123 \
  -H "Authorization: Bearer yk_..."
```

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

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

```bash theme={null}
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"
  }'
```

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

```bash theme={null}
curl https://api.youka.io/ar/api/v1/exports/export_123 \
  -H "Authorization: Bearer yk_..."
```