Guía de inicio rápido de HTTP sin procesar

Usa esta guía cuando quieras ejemplos directos de HTTP. Si estás desarrollando en Node.js o Bun, empieza con la guía de inicio rápido del SDK de Node.js en su lugar.

1. Crear un destino de carga

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

Sube los bytes del archivo al uploadUrl devuelto.

2. Crear un proyecto

curl -X POST https://api.youka.io/es/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. Consultar el estado de la tarea

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

Cuando la tarea llegue a un estado terminal, su output contiene los IDs de resultados clave de la operación.

4. Leer el estado del proyecto

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

Esto devuelve el estado persistente del proyecto, incluidos los stems, alineaciones, exportaciones y la configuración activa del proyecto.

5. Crear una exportación

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

Luego consulta el estado de la tarea devuelta o lee la exportación directamente:

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