POST https://api.acedata.cloud/suno/projects est l’interface Beta de gestion des projets multipistes. Distinguez la création, la sauvegarde, la génération de candidats, la soumission de candidats et l’exportation via action.
retrieve, chaque opération nécessite Idempotency-Key. La même clé et la même requête relisent uniquement le résultat d’origine ; la même clé avec une requête différente renvoie 409. Lorsqu’une génération payante rencontre un délai d’expiration réseau ou que le résultat de soumission est incertain, interrogez d’abord avec l’ID de tâche d’origine ou la même clé d’idempotence, et ne renvoyez pas directement avec une autre clé.
Identifiants et unités de temps
start_seconds / end_seconds sont les secondes dans l’audio source ; start_beats / end_beats sont les temps sur la ligne temporelle du projet. state.timing.bps est le nombre de temps par seconde, avec une valeur par défaut de 2. Par exemple, un segment de 41 secondes commençant au temps 0 se termine par défaut au temps 82. L’intervalle en secondes de generate_track sert à spécifier la référence de génération et ne garantit pas que le candidat ait uniquement la durée de cet intervalle.
Flux d’opérations
Si vous effectuez uniquement un remplacement local, un audio source utilisable existant suffit et il n’est pas nécessaire d’effectuer d’abord
render ; si l’audio source est déjà dans le projet, vous pouvez également ignorer upload et add_track. render_audio_id est uniquement la référence obligatoire de generate_track.
Lors de la soumission d’une opération asynchrone, { "task_id": "...", "trace_id": "..." } est d’abord renvoyé, ce qui ne signifie pas que la génération a réussi. Interrogation :
finished_at et que son response.success vaut true ; lorsque response.success=false, lisez response.error. Bien que save puisse contenir task_id, il se termine de manière synchrone dans cette interface. upload, render, generate_track et replace_section ne modifient pas la version du projet ; après la réussite de save, add_track, commit_candidate et remove_track, vous devez récupérer le nouveau version_id.
Conventions de requête
Les exemples suivants présentent de manière enchaînée la transmission des ID et des versions entre les opérations. Les réponses ne listent que les champs liés à l’étape actuelle ; lors de l’intégration, remplacez les ID d’exemple par les valeurs de réponse de l’application actuelle.
Création et lecture d’un projet
Créer un projet : create
Requête :
Lire un projet : retrieve
Requête :```json
{
“action”: “retrieve”,
“id”: “af0e104a-2a4c-40e0-9c70-7614566824a6”
}
start_seconds/end_seconds ne garantissent pas la durée de sortie.
Adopter le candidat : commit_candidate
La génération ne produit que des candidats, elle ne les place pas automatiquement dans le projet.
commit_candidate vérifie que le candidat appartient toujours à la version actuelle. Les candidats de remplacement partiel ne peuvent être soumis automatiquement que lorsque leur durée réelle peut correspondre de manière fiable à l’audio source complet ou à l’intervalle sélectionné ; en cas de non-correspondance, le projet d’origine est conservé et une erreur est renvoyée, il n’est pas possible de les raccorder de force en devinant manuellement les battements.
Exporter après la soumission
Après avoir soumis le candidat de nouvelle piste, l’exportation de la chanson entière contenant ce candidat est refusée. Demande et état terminal :studio_audio_unavailable, le projet d’origine doit être conservé et la disponibilité de l’audio référencé doit être vérifiée.
Remplacer un clip existant
replace_section peut directement utiliser l’audio source existant, sans avoir besoin d’exporter d’abord un mixage. La génération ne renvoie que des candidats ; lors de la soumission, sélectionnez la piste d’origine qui contient le clip source unique.
Générer un candidat de remplacement : replace_section
La durée des candidats ne correspond pas
Lors de la soumission de candidats de remplacement local,track_id doit pointer vers la piste originale contenant le segment source unique, et start_beats et end_beats doivent être omis. L’interface ne mettra à jour le projet que lorsque la durée du candidat peut correspondre de manière fiable à l’audio source complet ou à la plage sélectionnée.
Après avoir sélectionné une plage de 8 secondes, les deux candidats font 36 secondes, ce qui ne correspond ni aux 41 secondes de l’audio original ni aux 8 secondes sélectionnées. La soumission de l’un des candidats renvoie :
Supprimer une piste
remove_track nécessite le version_id actuel et state.tracks[].id ; après succès, utilisez la nouvelle version renvoyée. Ci-dessous, suppression de la piste candidate qui ne peut pas être utilisée pour l’exportation de la chanson complète, puis relecture de l’état du projet.
Exporter après suppression
Après avoir supprimé cette piste candidate, la piste source originale est toujours présente ; l’exportation réussit à nouveau en utilisant la dernière version :audio_url exportée avec succès peut être utilisée pour le téléchargement ou la lecture. Le fait que le lien audio soit accessible ne prouve pas que les autres candidats disposent également de l’éligibilité à l’exportation du projet.
Erreurs et récupération
Les projets et les candidats sont liés à l’application qui les a créés ; utilisez l’application d’origine pour y accéder. Conservez durablement l’URL audio finale exportée avec succès et gardez
trace_id pour faciliter le dépannage.
