Guide des modèles API suno
Résumé
- suno prend en charge Text-to-Video, Image-to-Video, R2V et Video Edit dans un seul workflow.
- Utilisez cette page de guide du modèle pour valider les paramètres avec des exemples minimaux de requête et de réponse.
- Stabilisez d'abord les prompts ici, puis passez à l'intégration avec l'API de production.
Capacités clés
- Tests unifiés de plusieurs modes:Alternez entre Text-to-Video, Image-to-Video, R2V et Video Edit au même endroit.
- Validation centrée sur les paramètres:Itérez rapidement sur les prompts, les durées et les références avant le déploiement en production.
- Transfert prêt pour la production:Une structure minimale de requête et de réponse vous aide à transférer des configurations stables vers des workflows API.
Quand l'utiliser
- Lorsque vous avez besoin d'une itération rapide entre plusieurs modes de génération.
- Lorsque vous devez valider les paramètres et la gestion des erreurs avant l'intégration.
Quand ne pas l'utiliser
- Pour la production asynchrone par lots à grande échelle, utilisez directement le pipeline de l'API côté serveur.
- Pour des exigences strictes d'authentification et d'audit, privilégiez l'orchestration côté backend.
Comportement à l'exécution
- Cette page de guide du modèle est optimisée pour l'interaction et la répétition des paramètres.
- Le panneau de sortie illustre la structure de résultat de la tâche comme aide à l'intégration.
Requête minimale
{
"model": "suno",
"mode": "text-to-video",
"input": {
"prompt": "A cinematic city sunrise with soft fog and moving traffic.",
"duration": 5
}
}
Réponse minimale
{
"task_id": "task_xxxxxxxx",
"model": "suno",
"mode": "text-to-video",
"status": "queued",
"created_at": "2026-04-15T00:00:00.000Z"
}
Paramètres clés
| Paramètre | Type | Obligatoire | Par défaut | Plage | Description |
|---|---|---|---|---|---|
| model | string | Oui | suno | - | Identifiant du modèle. Utilisez la valeur fixe suno. |
| prompt | string | Oui | - | - | Instruction principale décrivant le sujet, l'action, la scène et le style. |
| aspect_ratio | string | Non | 16:9 | 16:9 | 9:16 |
| duration | integer | Non | 6 | 5 | 10 |
| resolution | string | Non | 720P | 720P | Résolution de sortie. Valeur par défaut 720P ; prend en charge 720P. |
Erreurs fréquentes
| HTTP | Code | Déclencheur | Action corrective | Politique de nouvelle tentative |
|---|---|---|---|---|
| 400 | invalid_request_error | Le payload de la requête ne contient pas les champs obligatoires ou a des types de champs invalides. | Validez model, mode et le schéma de input avant l'envoi. | Ne réessayez qu'après avoir corrigé le payload ; évitez les nouvelles tentatives aveugles. |
| 401 | authentication_error | En-tête Authorization absent ou clé d'API invalide. | Vérifiez le format du token Bearer et la portée de la clé d'API. | Réessayez après avoir corrigé l'authentification ; faites tourner la clé si les échecs se répètent. |
| 429 | rate_limit_exceeded | La fréquence des requêtes, la concurrence ou le quota actuel déclenchent la limite du fournisseur. | Appliquez d'abord un backoff exponentiel, puis vérifiez le rythme des requêtes, la concurrence et l'utilisation du quota. | Utilisez un backoff exponentiel (par exemple 1s/2s/4s) avec jitter ; si le problème persiste, réduisez la pression d'envoi. |
| 500 | internal_error | Erreur transitoire du fournisseur ou échec interne de traitement. | Enregistrez le request id et déclenchez le workflow de nouvelles tentatives. | Réessayez 2 à 3 fois avec de courts délais ; escaladez si le problème persiste. |
FAQ
- Quand dois-je utiliser suno ?
Utilisez-le pour valider rapidement des concepts vidéo, comparer le comportement des modes et converger les prompts avant le déploiement de l'API. - Comment choisir entre Text-to-Video et Image-to-Video ?
Utilisez Text-to-Video lorsque vous n'avez que des instructions ; utilisez Image-to-Video lorsque vous disposez déjà d'images clés ou d'une composition. - Quelle est la différence entre R2V et Video Edit ?
R2V se concentre sur la génération guidée par référence, tandis que Video Edit se concentre sur la modification de vidéos existantes. - Erreur du modèle d'image ou de vidéo : invalid apitype: -1
Cela signifie généralement que la requête a été envoyée au mauvais endpoint. Les modèles d'image et de vidéo n'utilisent normalement pas l'endpoint de chat. Envoyez plutôt la requête HTTP de tâche décrite dans la documentation, puis interrogez l'endpoint de statut de la tâche pour obtenir le résultat. Vérifiez d'abord le code réel de la requête, l'URL et le payload. - Une tâche d'image ou de vidéo a échoué, mais l'utilisateur a tout de même été facturé
Demandez d'abord à l'utilisateur le journal de la tâche ou une capture d'écran et vérifiez si des tokens d'entrée ou de sortie apparaissent. Si une comptabilisation de tokens est présente, la requête a probablement été envoyée via un endpoint de chat au lieu du bon flux média. Les modèles d'image et de vidéo fonctionnent généralement comme des API HTTP de tâches asynchrones : soumettez d'abord la tâche, puis interrogez par task id conformément à la documentation.







