Documentation API

Obtenir et stocker une clé API

L'authentification doit rester sur le serveur de votre application. Ne placez jamais une clé de production dans le navigateur, une application mobile, les logs ou un dépôt public.

1. 1Créez un compte et ouvrez la section des clés API dans le tableau de bord.
2. 2Copiez la clé et conservez-la dans un gestionnaire de secrets ou un environnement serveur chiffré.
3. 3Envoyez-la dans l'en-tête Authorization comme jeton Bearer et renouvelez-la immédiatement si elle est exposée.

Démarrage rapide

Créez une tâche musicale asynchrone, conservez le workId renvoyé et interrogez l'endpoint feed jusqu'à la fin. La requête fonctionne après configuration de la clé serveur.

export UDIOAPI_KEY='replace-with-your-server-key'

curl --request POST \
  --url 'https://udioapi.pro/api/v2/generate' \
  --header "Authorization: Bearer $UDIOAPI_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "chirp-v5-5",
    "gpt_description_prompt": "Warm indie pop with acoustic guitar",
    "make_instrumental": true
  }'

# Save workId from the response, then poll:
curl 'https://udioapi.pro/api/v2/feed?workId=YOUR_WORK_ID'

Les fichiers utilisent UDIOAPI_KEY, un polling limité et des erreurs structurées, sans dépendance tierce. Retirez tous les secrets avant de publier un fork sur GitHub.

Points de terminaison API

Utilisez /v2/generate comme endpoint Music Generate par défaut. MiniMax est un fournisseur intégré via /v2/minimax/generate, pas le modèle de génération musicale par défaut.

Gestion des erreurs

Considérez le statut HTTP et la réponse structurée comme le contrat d'intégration. Journalisez le workId et votre identifiant de requête, jamais la clé API.

Ne réessayez pas les refus de modération ni les autres échecs définitifs. Affichez fail_message ou error_message pour permettre de modifier l'entrée.

Résumé des changements

Les changements d'API importants pour la compatibilité sont résumés ici et reliés à l'endpoint concerné.