Pour les développeurs
API musicale et CLI
Transformez une idée ou vos paroles en chanson depuis vos scripts. Retrouvez le même compte, les mêmes crédits et la même bibliothèque privée que dans l'application.
Connectez votre compte
- Créer un compte et vérifiez votre adresse e-mail.
- Ouvrez les Paramètres et créez une clé API. Clés API
- Conservez la clé sur votre serveur ou dans votre gestionnaire de secrets. Envoyez-la dans l'en-tête Authorization, jamais dans une URL ou du code frontend.
Les clés expirent après 90 jours. Vous pouvez avoir cinq clés actives et les révoquer immédiatement dans les Paramètres. Les clés en lecture seule ne peuvent pas générer de chansons.
curl https://mcp.wordsintomusic.com/v1/account \
-H "Authorization: Bearer $WIM_API_KEY"Préparez, lancez et suivez votre chanson
Préparez d'abord les instructions sans dépenser de crédit. Leur lancement utilise un crédit de chanson existant. Gardez le même identifiant de requête lors des nouvelles tentatives. Un délai dépassé ne doit pas lancer une autre chanson.
{
"requestId": "my-first-song-20261021",
"input": {
"mode": "idea",
"idea": "Une chanson pleine d'espoir sur un nouveau départ dans une ville",
"direction": "Pop acoustique chaleureuse, batterie régulière, voix douce",
"language": "fr",
"duration": 120
},
"uiLocale": "fr"
}Envoyez ce JSON à POST /v1/songs/prepare. Envoyez ensuite son preparedRequestId à POST /v1/songs/start. Consultez GET /v1/jobs/{jobId} à au moins 15 secondes d'intervalle. Une fois la chanson prête, ouvrez le lien privé de la bibliothèque pour l'écouter ou la télécharger.
Les langues prises en charge sont l'anglais, l'espagnol, l'allemand, le français et le portugais brésilien. Demandez 60 à 180 secondes. Utilisez le mode lyrics pour vos paroles ou instrumental: true pour une musique sans voix.
Points d'accès de l'API
| Méthode et chemin | Action |
|---|---|
GET /v1/account | Consulter vos crédits de chanson |
POST /v1/songs/prepare | Préparer une chanson sans dépenser de crédit |
POST /v1/songs/start | Générer la chanson préparée avec un crédit existant |
GET /v1/jobs/{jobId} | Consulter l'état de génération |
GET /v1/songs | Consulter votre bibliothèque privée |
GET /v1/songs/{id} | Consulter une de vos chansons |
L'URL de base de l'API est https://mcp.wordsintomusic.com/v1. Télécharger la spécification OpenAPI pour les champs de requête, limites, autorisations et formats de réponse.
Utilisez la ligne de commande
npm install -g words-into-music-cli
wim login --key-stdin
wim account
wim prepare --file brief.json
wim start PREPARED_REQUEST_ID --confirm
wim job JOB_ID
wim songs --limit 10Utilisez Node.js 22 ou plus récent. Transmettez la clé à login via l'entrée standard ou fournissez WIM_API_KEY depuis votre gestionnaire de secrets. Ne l'inscrivez pas dans les arguments ou l'historique du terminal. Lancez wim --help pour les détails.
Crédits, limites et confidentialité
L'accès à l'API et la CLI ne nécessitent aucun abonnement supplémentaire. Générer un enregistrement utilise votre quota existant, avec les mêmes limites que l'application. L'API n'achète jamais de crédits et ne lance aucun abonnement.
Seules les chansons du propriétaire de la clé sont accessibles. Les paroles ne sont renvoyées que sur demande. Révoquer une clé bloque les nouveaux appels, tandis qu'une chanson déjà acceptée continue son traitement.
La passerelle autorise jusqu'à 30 requêtes API par minute et par IP. Les appels API et MCP partagent aussi une limite de 120 requêtes par compte et par minute. Respectez Retry-After après une réponse 429. Les identifiants des préparations lancées sont conservés contre les doublons pendant 30 jours après expiration.
Pour connecter des assistants, consultez notre Configurer le MCP. Pour les quotas du compte, consultez Tarifs.
