API d'envoi d'audio source

Mis à jour le 2026-09-18 · équipe Suno-API

Description du point d'accès

L'envoi d'audio source transforme un fichier audio local ou distant en clip source utilisable par les capacités suivantes : cover, extension, remplacement de section, séparation, etc.

Point d'accès : POST /api/music/upload-source

Facturation : Gratuit. Ce point d'accès ne fait qu'envoyer l'audio source ; il ne démarre aucune tâche de génération.

Utilisation recommandée : c'est l'étape 1 du « cover en deux étapes ». Envoyez d'abord l'audio avec ce point d'accès (c'est gratuit et vous pouvez réessayer à tout moment en cas d'échec) et conservez le clip_id renvoyé ; après avoir confirmé que l'envoi a abouti (status dans un état terminé), appelez l'API de cover à partir d'un clip source pour lancer le cover — le corps de cette requête ne fait que quelques centaines d'octets, il ne peut donc pas être tronqué en transit parce que l'audio est trop volumineux. Par rapport à l'API en une seule fois envoyer puis faire un cover, cette séparation est plus robuste lorsque l'audio est volumineux, le réseau instable, ou que la même matière doit être réutilisée plusieurs fois (extension / remplacement / séparation).

Conseils pour l'envoi de gros fichiers

Une fois l'envoi terminé, vérifiez toujours que le status de la réponse est bien un état terminé et conservez le clip_id avant de passer à l'étape 2 ; un envoi en échec n'est pas facturé et ne crée aucune tâche de génération : il suffit de réessayer.

Paramètres de la requête

Headers

Pour les requêtes JSON :

Ne définissez pas Content-Type manuellement pour les requêtes multipart ; le client le génère automatiquement.

Paramètres du corps

Exemple de requête JSON

curl -X POST https://www.suno-api.io/api/music/upload-source \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "file_url": "https://example.com/source.mp3",
    "file_name": "source.mp3",
    "upload_type": "file_upload"
  }'

Exemple de requête multipart

curl -X POST https://www.suno-api.io/api/music/upload-source \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@source.mp3" \
  -F "file_name=source.mp3" \
  -F "upload_type=file_upload" \
  -F "model=suno-v6"

Réponse

{
  "clip_id": "uploaded_clip_id",
  "status": "complete",
  "title": "source.mp3",
  "image_url": "https://...",
  "audio_url": "https://...",
  "display_tags": "pop, vocal",
  "inferred_description": "uploaded source audio",
  "clip_metadata": {}
}