Remplacement de segment avec Lyria 3.5

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"
  }'

import requests

url = "https://api.apimart.ai/v1/music/generations/replaceFlowMusic"

payload = {
    "model": "flowmusic",
    "version": "lyria-3.5",
    "clip_id": "abc123-def456",
    "start_s": 10,
    "end_s": 20,
    "instruction": "Remplacer par une version piano"
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

const url = "https://api.apimart.ai/v1/music/generations/replaceFlowMusic";

const payload = {
  model: "flowmusic",
  version: "lyria-3.5",
  clip_id: "abc123-def456",
  start_s: 10,
  end_s: 20,
  instruction: "Remplacer par une version piano"
};

const headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KWXVHGTG5JM33S8FG1K90YQ6"
    }
  ]
}

{
  "error": {
    "message": "end_s must be greater than start_s",
    "type": "invalid_request",
    "param": "",
    "code": "invalid_request"
  }
}

{
  "error": {
    "message": "Solde insuffisant",
    "type": "invalid_request",
    "param": "",
    "code": "quota_not_enough"
  }
}

{
  "error": {
    "message": "La capacité du groupe actuel est saturée, veuillez réessayer plus tard",
    "type": "rate_limit_error",
    "param": "",
    "code": "rate_limit_error"
  }
}

POST

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"
  }'

import requests

url = "https://api.apimart.ai/v1/music/generations/replaceFlowMusic"

payload = {
    "model": "flowmusic",
    "version": "lyria-3.5",
    "clip_id": "abc123-def456",
    "start_s": 10,
    "end_s": 20,
    "instruction": "Remplacer par une version piano"
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

const url = "https://api.apimart.ai/v1/music/generations/replaceFlowMusic";

const payload = {
  model: "flowmusic",
  version: "lyria-3.5",
  clip_id: "abc123-def456",
  start_s: 10,
  end_s: 20,
  instruction: "Remplacer par une version piano"
};

const headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KWXVHGTG5JM33S8FG1K90YQ6"
    }
  ]
}

{
  "error": {
    "message": "end_s must be greater than start_s",
    "type": "invalid_request",
    "param": "",
    "code": "invalid_request"
  }
}

{
  "error": {
    "message": "Solde insuffisant",
    "type": "invalid_request",
    "param": "",
    "code": "quota_not_enough"
  }
}

{
  "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"
  }'

import requests

url = "https://api.apimart.ai/v1/music/generations/replaceFlowMusic"

payload = {
    "model": "flowmusic",
    "version": "lyria-3.5",
    "clip_id": "abc123-def456",
    "start_s": 10,
    "end_s": 20,
    "instruction": "Remplacer par une version piano"
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

const url = "https://api.apimart.ai/v1/music/generations/replaceFlowMusic";

const payload = {
  model: "flowmusic",
  version: "lyria-3.5",
  clip_id: "abc123-def456",
  start_s: 10,
  end_s: 20,
  instruction: "Remplacer par une version piano"
};

const headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KWXVHGTG5JM33S8FG1K90YQ6"
    }
  ]
}

{
  "error": {
    "message": "end_s must be greater than start_s",
    "type": "invalid_request",
    "param": "",
    "code": "invalid_request"
  }
}

{
  "error": {
    "message": "Solde insuffisant",
    "type": "invalid_request",
    "param": "",
    "code": "quota_not_enough"
  }
}

{
  "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 nouveau clip_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}) :

{
  "code": 200,
  "data": {
    "id": "task_01KWXVHGTG5JM33S8FG1K90YQ6",
    "status": "completed",
    "progress": 100,
    "created": 1783413392,
    "completed": 1783413454,
    "actual_time": 62,
    "cost": 0.048,
    "credits_cost": 0.48,
    "result": {
      "music": [
        {
          "clip_id": "9508d1fe-633e-464b-8a40-c6368e5464fa",
          "title": "Untitled (Replaced)",
          "duration_seconds": "181.58933333",
          "create_time": "2026-07-07T08:37:13.864452Z",
          "lyrics": "[Verse 1]\nWaking up to the morning light,\n...",
          "lyrics_id": "c302d603-81b6-552f-8122-e512928d6aa1",
          "lyrics_timing_markers": [[10, 12], [71, 15]],
          "audio_url": "https://cdn.apimart.ai/audio/flowmusic_9508d1fe.m4a",
          "wav_url": "https://cdn.apimart.ai/audio/flowmusic_9508d1fe.wav",
          "image_url": "https://cdn.apimart.ai/image/flowmusic_9508d1fe_cover.jpg"
        }
      ]
    }
  }
}

Aperçu

Modèles

Série Texte

Série Image

Série Vidéo

Série Audio

Série Modération

Gestion des uploads

Gestion des tâches

Gestion du compte

Remplacement de segment avec Lyria 3.5

Authentification

Paramètres de requête

Réponse

Cas d’usage

Scénario 1 : remplacer le passage de 10 à 20 secondes par une version piano

Exemple de résultat de tâche terminée

​Authentification

​Paramètres de requête

​Réponse

​Cas d’usage

​Scénario 1 : remplacer le passage de 10 à 20 secondes par une version piano

​Exemple de résultat de tâche terminée

Authentification

Paramètres de requête

Réponse

Cas d’usage

Scénario 1 : remplacer le passage de 10 à 20 secondes par une version piano

Exemple de résultat de tâche terminée