API v1

Documentation API FM9

Créez des fonctionnalités puissantes de génération musicale dans vos applications avec notre API REST.

Démarrage Rapide

Générez votre premier morceau avec un seul appel API.

Requestbash
curl -X POST https://api.fm9.ai/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "musique électronique dansante entraînante"}'
Responsejson
{
  "id": "gen_abc123",
  "status": "processing",
  "estimated_time": 30
}

Authentification

Toutes les requêtes API nécessitent une clé API. Incluez votre clé dans l'en-tête Authorization :

Obtenez votre clé API depuis le tableau de bord développeur.

Authorization: Bearer YOUR_API_KEY

Points de Terminaison

POST/v1/generate

Générer de la Musique

Créer une nouvelle tâche de génération musicale.

Parameters

  • prompt-Description textuelle de la musique à générer (requis)
  • duration-Durée du morceau en secondes (30-180, par défaut : 60)
  • style-Preset de style musical (optionnel)
  • instrumental-Générer uniquement instrumental (par défaut : false)

Retourne un objet de génération avec l'ID de tâche et le statut.

GET/v1/generation/:id

Obtenir le Statut de Génération

Vérifier le statut d'une tâche de génération.

Retourne l'objet de génération avec le statut actuel et les URLs de téléchargement une fois terminé.

GET/v1/generations

Lister les Générations

Récupérer la liste de votre historique de génération.

Parameters

  • limit-Nombre de résultats à retourner (par défaut : 20, max : 100)
  • offset-Décalage de pagination (par défaut : 0)
  • status-Filtrer par statut (pending, processing, completed, failed)

Tarification API

Tarification simple et transparente basée sur l'utilisation.

Starter

Gratuit

10 générations/mois

  • Accès API de base
  • Qualité standard
  • Support communautaire

Développeur

49 $/mo

500 générations/mois

  • Accès API complet
  • Sortie haute qualité
  • Support prioritaire
  • Callbacks Webhook

Entreprise

Personnalisé

Illimité

  • Infrastructure dédiée
  • Modèles personnalisés
  • Garantie SLA
  • Support 24/7

Limites de Taux

Pour garantir une utilisation équitable et la stabilité du service, les limites suivantes s'appliquent :

  • Starter : 10 requêtes/minute
  • Développeur : 60 requêtes/minute
  • Entreprise : Limites personnalisées

Si vous dépassez la limite, vous recevrez une réponse 429 Too Many Requests.

Codes d'Erreur

L'API utilise les codes de réponse HTTP standard pour indiquer le succès ou l'échec.

CodeDescription
400Bad Request - Paramètres invalides
401Unauthorized - Clé API invalide ou manquante
402Payment Required - Crédits insuffisants
429Too Many Requests - Limite de taux dépassée
500Internal Server Error - Quelque chose s'est mal passé de notre côté

Besoin d'Aide ?

Notre équipe de support développeur est là pour vous aider.

Email : [email protected]

Documentation complète disponible sur docs.fm9.ai