Démarrage rapide HTTP brut

Utilisez ce guide lorsque vous souhaitez des exemples HTTP directs. Si vous développez en Node.js ou Bun, commencez plutôt par le Démarrage rapide du SDK Node.js.

1. Créer une cible de téléversement

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

Téléversez les octets du fichier vers l’uploadUrl retournée.

2. Créer un projet

curl -X POST https://api.youka.io/fr/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. Interroger la tâche

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

Lorsque la tâche est terminale, son output contient les ID de résultats clés pour l’opération.

4. Lire l’état du projet

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

Cela renvoie l’état du projet à long terme, notamment les stems, les alignements, les exports et les paramètres de projet actifs.

5. Créer un export

curl -X POST https://api.youka.io/fr/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"
  }'

Ensuite, interrogez la tâche renvoyée ou lisez directement l’export :

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