Télécharger un audio

curl --request POST \
  --url https://api.apimart.ai/v1/music/generations/downloadAudioFlowMusic \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "flowmusic",
    "clip_id": "abc123-def456",
    "format": "wav"
  }'

import requests

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

payload = {
    "model": "flowmusic",
    "clip_id": "abc123-def456",
    "format": "wav"
}

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/downloadAudioFlowMusic";

const payload = {
  model: "flowmusic",
  clip_id: "abc123-def456",
  format: "wav"
};

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_01KWXVD3FPYYQPJ2N87XXE5NQG"
    }
  ]
}

{
  "error": {
    "message": "format must be one of: wav, mp3",
    "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

downloadAudioFlowMusic

curl --request POST \
  --url https://api.apimart.ai/v1/music/generations/downloadAudioFlowMusic \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "flowmusic",
    "clip_id": "abc123-def456",
    "format": "wav"
  }'

import requests

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

payload = {
    "model": "flowmusic",
    "clip_id": "abc123-def456",
    "format": "wav"
}

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/downloadAudioFlowMusic";

const payload = {
  model: "flowmusic",
  clip_id: "abc123-def456",
  format: "wav"
};

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_01KWXVD3FPYYQPJ2N87XXE5NQG"
    }
  ]
}

{
  "error": {
    "message": "format must be one of: wav, mp3",
    "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/downloadAudioFlowMusic \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "flowmusic",
    "clip_id": "abc123-def456",
    "format": "wav"
  }'

import requests

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

payload = {
    "model": "flowmusic",
    "clip_id": "abc123-def456",
    "format": "wav"
}

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/downloadAudioFlowMusic";

const payload = {
  model: "flowmusic",
  clip_id: "abc123-def456",
  format: "wav"
};

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_01KWXVD3FPYYQPJ2N87XXE5NQG"
    }
  ]
}

{
  "error": {
    "message": "format must be one of: wav, mp3",
    "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

Authorization

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

model

string

requis

Nom du modèle, toujours passer "flowmusic" (insensible à la casse)

clip_id

string

requis

clip_id de la musique à télécharger, provenant du result.music[].clip_id d’une tâche réussie

format

string

requis

Format de téléchargementValeurs possibles :

mp3 - compression avec perte, taille réduite
wav - sans perte, adapté à la post-production

Réponse

code

integer

Code de statut de la réponse, 200 en cas de succès

data

array

Tableau de données renvoyées

Afficher Éléments du tableau

status

string

Statut de la tâche, submitted lors de la soumission initiale

task_id

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 : exporter en wav sans perte

{
  "model": "flowmusic",
  "clip_id": "abc123-def456",
  "format": "wav"
}

Interroger le résultat de la tâcheLe téléchargement d’audio 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 résultat se trouve toujours dans result.music[0].audio_url (url a la même valeur) ; les champs format / mime_type indiquent le format réel.

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_01KWXVD3FPYYQPJ2N87XXE5NQG",
    "status": "completed",
    "progress": 100,
    "created": 1783413247,
    "completed": 1783413296,
    "actual_time": 49,
    "cost": 0.016,
    "credits_cost": 0.16,
    "result": {
      "music": [
        {
          "clip_id": "a41aade4-993e-4d28-b56f-d97e7ef7167c",
          "format": "wav",
          "mime_type": "audio/wav",
          "size_bytes": 34900726,
          "audio_url": "https://cdn.apimart.ai/audio/flowmusic_a41aade4_download_audio.wav",
          "url": "https://cdn.apimart.ai/audio/flowmusic_a41aade4_download_audio.wav"
        }
      ]
    }
  }
}

Téléverser un audio Rendu vidéo musical

​Authentification

​Paramètres de requête

​Réponse

​Cas d’usage

​Scénario 1 : exporter en wav sans perte

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

Authentification

Paramètres de requête

Réponse

Cas d’usage

Scénario 1 : exporter en wav sans perte

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