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.

​

Tâches asynchrones et interrogation

La plupart des opérations d’écriture sont asynchrones.

​

Ce qui renvoie immédiatement

Ces endpoints acceptent du travail et renvoient des IDs que vous pouvez interroger :

• POST /projects
• POST /projects/{projectId}/tasks/stem-separation
• POST /projects/{projectId}/tasks/lyrics-sync
• POST /projects/{projectId}/exports

​

Ce qu’il faut interroger

• Interrogez GET /tasks/{taskId} pour l’état d’exécution et la sortie de la tâche hydratée.
• Consultez GET /projects/{projectId} pour l’état du projet à long terme.
• Consultez GET /exports/{exportId} pour des URL de téléchargement d’export à jour.

​

Modèle d’interrogation pratique

1. Démarrez une mutation et stockez les IDs renvoyés.
2. Interrogez GET /tasks/{taskId} jusqu’à ce que la tâche atteigne un état terminal.
3. Relisez la ressource durable par ID au lieu de vous fier à un état en cache obsolète.
4. Pour les téléchargements, récupérez GET /exports/{exportId} lorsque vous êtes prêt à utiliser l’URL.

​

Pourquoi c’est important

• Le statut de la tâche est la chronologie d’exécution.
• L’état du projet est la source de vérité durable.
• Les URL de téléchargement d’export doivent être considérées comme actualisables plutôt que permanentes.