Par capacité
Musique
La musique s'exécute sous forme de tâche : soumettez un prompt, puis revenez vérifier ou recevez un callback. Commencez avec le prompt seul.
#1. Choisir un modèle
#3. Obtenir le résultat
L'appel de soumission répond immédiatement avec un task_id. Vérifiez la tâche toutes les quelques secondes jusqu'à ce que status vaille completed, ou transmettez webhook_url et nous vous appellerons une fois la tâche terminée.
GET https://www.aisplice.store/v1/music/tasks/{task_id}
GET https://www.aisplice.store/v1/music/tasks/{task_id}/content
Facturé uniquement en cas de succès
Valeurs de statut et interrogation →Recevoir un callback au lieu d'interroger →
#En cas de problème
- 400 avec un nom de champ : cette option n'est pas acceptée par ce modèle ; utilisez les valeurs listées à l'étape 2.
- Contenu refusé par le modèle : reformulez le prompt ; les requêtes refusées ne sont pas facturées.
- 402 : le solde ne couvre pas cette requête ; rechargez dans Portefeuille, puis réessayez.
- 429 : ralentissez et réessayez après le nombre de secondes indiqué par Retry-After.
- 503 model_not_found : le nom du modèle est incorrect ou le modèle est hors ligne ; choisissez-en un à l'étape 1.
L'intégrer à votre produitLes options à montrer en premier à vos utilisateurs, et celles à garder pour plus tard.
Les options à montrer en premier à vos utilisateursCommencez par le prompt et un seul réglage de prix ; ajoutez le reste une fois le parcours de base fonctionnel.+
Intention créative
Les champs comme prompt ont leur place dans l'interface, car l'utilisateur comprend directement le résultat qu'ils modifient.
Multiplicateur de coût
Les champs comme duration, resolution, size et count ne doivent être introduits que lorsque la tarification est déjà explicable.
Changement de mode
Les champs comme image, mask ou les ID de continuation changent le workflow lui-même et ne doivent apparaître que dans des modes dédiés.
Mécanique interne
Les champs comme webhook_secret s'adressent aux intégrateurs, pas aux créateurs au quotidien : gardez-les hors de l'interface par défaut.
prompt- Quand l'exposer
- Toujours. C'est l'entrée minimale pour générer de la musique.
- Valeur par défaut recommandée
- Obligatoire dans l'interface.
- Pourquoi c'est important
- Il porte le thème, le genre et la direction émotionnelle.
instrumental / make_instrumental- Quand l'exposer
- À exposer lorsque le produit distingue clairement une sortie chantée d'une sortie instrumentale.
- Valeur par défaut recommandée
- Garder côté serveur, sauf si les utilisateurs choisissent entre pistes chantées et instrumentales.
- Pourquoi c'est important
- Ce paramètre change le type de sortie et doit correspondre à un choix métier clair.
title / tags- Quand l'exposer
- À exposer uniquement une fois que les utilisateurs maîtrisent déjà la génération par prompt seul.
- Valeur par défaut recommandée
- Champs avancés facultatifs.
- Pourquoi c'est important
- Ils aident à contrôler le style, mais ne doivent pas freiner le premier succès.
version / mv- Quand l'exposer
- À exposer uniquement si les utilisateurs doivent choisir une famille de modèles ou un mode de génération.
- Valeur par défaut recommandée
- Fixez une version recommandée côté serveur.
- Pourquoi c'est important
- Ce paramètre alourdit les décisions et relève généralement des réglages d'exploitation.
continue_clip_id / continue_at- Quand l'exposer
- À exposer uniquement dans les workflows de continuation ou d'extension.
- Valeur par défaut recommandée
- Masquer dans les parcours de création standard.
- Pourquoi c'est important
- Ce sont des réglages experts qui déroutent les nouveaux utilisateurs s'ils apparaissent trop tôt.
Phase 1
- prompt
- one size or one duration default
- submit -> poll -> content
Phase 2
- one quality or resolution selector
- clear pricing hint
Phase 3
- advanced controls such as reference media, continuation, webhook, or vendor-specific tuningUne seule source de vérité pour les résultats
Toujours bloqué ?
Envoyez-nous l'ID de requête ou le message d'erreur, et nous examinerons le problème.