{ "error": { "message": "La capacité du groupe actuel est saturée, veuillez réessayer plus tard", "type": "rate_limit_error", "param": "", "code": "rate_limit_error" }}
Flow Music
Remplacement de segment avec Lyria 3.5
Utilisez Lyria 3.5 pour remplacer un segment précis d’un audio déjà généré
POST
/
v1
/
music
/
generations
/
replaceFlowMusic
curl --request POST \ --url https://api.apimart.ai/v1/music/generations/replaceFlowMusic \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "model": "flowmusic", "version": "lyria-3.5", "clip_id": "abc123-def456", "start_s": 10, "end_s": 20, "instruction": "Remplacer par une version piano" }'
{ "error": { "message": "La capacité du groupe actuel est saturée, veuillez réessayer plus tard", "type": "rate_limit_error", "param": "", "code": "rate_limit_error" }}
curl --request POST \ --url https://api.apimart.ai/v1/music/generations/replaceFlowMusic \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "model": "flowmusic", "version": "lyria-3.5", "clip_id": "abc123-def456", "start_s": 10, "end_s": 20, "instruction": "Remplacer par une version piano" }'
{ "error": { "message": "La capacité du groupe actuel est saturée, veuillez réessayer plus tard", "type": "rate_limit_error", "param": "", "code": "rate_limit_error" }}
Authentification
string
requis
Toutes les API nécessitent une authentification par Bearer TokenObtenir une clé API :Rendez-vous sur la page de gestion des clés API pour obtenir votre clé APIAjoutez-la dans l’en-tête de la requête lors de l’utilisation :
Authorization: Bearer YOUR_API_KEY
Paramètres de requête
string
requis
Nom du modèle, toujours passer "flowmusic" (insensible à la casse)
string
requis
Version du modèle, toujours passer "lyria-3.5"
Lyria 3.5 utilise toujours flowmusic comme nom de modèle. Ne remplacez pas model par lyria-3.5 ou flowmusic-lyria-3.5.
string
requis
clip_id de la musique source, provenant du result.music[].clip_id d’une tâche réussie
number
requis
Temps de début du remplacement (secondes)
number
requis
Temps de fin du remplacement (secondes)
end_s doit être supérieur à start_s et ne peut pas dépasser la durée du clip source.
string
requis
Instruction d’édition pour le segment de remplacementExemple : "Remplacer par une version piano"
string
Titre de la musique après remplacement
integer
Graine aléatoire, utilisée pour reproduire ou contrôler le résultat de la génération
Réponse
integer
Code de statut de la réponse, 200 en cas de succès
array
Tableau de données renvoyées
Afficher Éléments du tableau
string
Statut de la tâche, submitted lors de la soumission initiale
string
Identifiant unique de la tâche, utilisé pour interroger le statut et le résultat de la tâche
Cas d’usage
Scénario 1 : remplacer le passage de 10 à 20 secondes par une version piano
{ "model": "flowmusic", "version": "lyria-3.5", "clip_id": "abc123-def456", "start_s": 10, "end_s": 20, "instruction": "Remplacer par une version piano"}
Interroger le résultat de la tâcheLe remplacement de segment est une tâche asynchrone ; après soumission, un task_id est renvoyé. Utilisez l’API Obtenir le statut de la tâche pour interroger la progression et le résultat de la génération. Le produit du remplacement est un nouveauclip_id (la chanson entière est régénérée, avec l’intervalle spécifié remplacé) ; utilisez ce nouveau clip_id pour les opérations ultérieures.
Exemple de résultat de tâche terminée
Exemple de réponse de requête (GET /v1/music/tasks/{task_id}) :