> ## Documentation Index > Fetch the complete documentation index at: https://docs.aiid.edu.kg/llms.txt > Use this file to discover all available pages before exploring further. # Créer une tâche de génération de musique ou de son > Interface de soumission pour la génération de musique et de sons, compatible avec l’ancien chemin `/suno/submit/music`. Renvoie l’ID de tâche, puis permet de consulter le résultat via `/suno/fetch/{task_id}`. Interface de soumission des tâches de génération de musique et de sons. Le chemin reste `/suno/submit/music` ; vous pouvez en pratique choisir le moteur de génération via `upstream_model`, `music_model`, `engine`, `model_id` ou `modelId`. L’interface de création renvoie `task_id`, puis `/suno/fetch/{task_id}` sert à interroger la sortie. Si `upstream_model` n’est pas transmis (ou si seul `{"model":"suno_music"}` est transmis), Suno v5.5 est utilisé par défaut. Pour continuer à utiliser l’ancienne version de Suno, transmettez explicitement `"upstream_model":"suno-v5"`. ## Nouveaux modèles | Type | `upstream_model` / Alias | `modelId` | | --- | --- | ---: | | Musique | `suno-v5.5` / `chirp-fenix` | 128 | | Voix | `seed-audio-1.0` | 126 | | Voix | `minimax-speech-2.8-hd` / `speech-2.8-hd` | 127 | | Musique | `lyria-3-pro` / `lyria-3-pro-preview` | 129 | ## Mode de description par prompt Convient lorsque vous décrivez uniquement le style, l’ambiance, la langue, le type de voix et le contexte ; le modèle génère automatiquement le contenu de la chanson. ```json { "model": "suno_music", "upstream_model": "suno-v5.5", "prompt": "Create an energetic retro-pop DJ song about the artificial intelligence revolution.", "make_instrumental": false } ``` ## Génération de son MiniMax Speech peut surcharger les paramètres vocaux via `extraParams` (ou des champs de niveau supérieur homonymes en snake_case/camelCase). ```json { "model": "suno_music", "upstream_model": "minimax-speech-2.8-hd", "prompt": "欢迎使用新版语音生成服务。", "extraParams": { "voice": "moss_audio_ce44fc67-7ce3-11f0-8de5-96e35d26fb85", "outputFormat": "mp3", "sampleRate": 32000, "speed": 1, "volume": 1, "pitch": 0 } } ``` Lorsque aucun paramètre vocal n’est transmis pour MiniMax Speech, le serveur envoie par défaut les valeurs `voice`, `outputFormat=mp3`, `sampleRate=32000`, `speed=1`, `volume=1` et `pitch=0` de l’exemple ci-dessus. Lyria 3 Pro utilise `upstream_model=lyria-3-pro` (ou `lyria-3-pro-preview`) : ```json { "model": "suno_music", "upstream_model": "lyria-3-pro", "prompt": "Cinematic orchestral music with a hopeful finale." } ``` ## Musique légère ou instrumental pur Vous pouvez utiliser `light_music=true` ou `make_instrumental=true`. `light_music` indique une tendance musique légère/musique d’ambiance, et `make_instrumental` indique de ne pas générer de voix chantée. ```json { "model": "suno_music", "upstream_model": "minimax-music-v2.6", "prompt": "Warm cafe background music with soft piano and strings, relaxing and cinematic.", "light_music": true, "make_instrumental": true } ``` ## Mode avancé des paroles Convient lorsque l’équipe métier a déjà préparé les paroles et doit spécifier un titre ainsi que des balises de style. Vous pouvez transmettre `custom_mode=true` ; pour le champ des paroles, utilisez `lyrics`, `lyric`, `custom_lyrics` ou `customLyrics`. ```json { "model": "suno_music", "upstream_model": "mureka-v9", "custom_mode": true, "title": "Summer Sea Breeze", "tags": "electro pop, female vocal, bright summer", "lyrics": "[Verse]\nSea breeze moves across the white sand\n[Chorus]\nTurn the summer into a beam of light" } ``` ## Consultation Après la création réussie, enregistrez l’ID de tâche `data` renvoyé, par exemple `task_xxx`, puis appelez `GET /suno/fetch/{task_id}` pour consulter le statut, l’URL audio, la couverture, le titre, les paroles et les informations de segments bruts renvoyées en amont. ## OpenAPI ````yaml api-reference/fr/openapi.json POST /suno/submit/music openapi: 3.0.0 info: title: Documentation de référence de 出海营 API version: 1.0.0 description: Public AI Gateway API Reference servers: - url: https://api.aiid.edu.kg security: - BearerAuth: [] tags: - name: OpenAIFormat (Chat) - name: Format OpenAI(Responses) - name: Format Gemini pour la génération d’images - name: Génération d’imagesOpenAI au format DALL-E - name: Obtenir la liste des modèles - name: Génération vidéoHappyHorse avec Wan - name: Format de génération vidéo Kling - name: Format Omni de génération vidéo et Veo - name: Génération vidéo Seedance - name: Formats compatibles avec la génération de vidéosSora - name: Génération vidéo Vidu - name: Format de tâche de génération musicale paths: /suno/submit/music: post: tags: - Format de tâche de génération musicale summary: Créer une tâche de génération de musique ou de son description: >- Interface de soumission pour la génération de musique et de sons, compatible avec l’ancien chemin `/suno/submit/music`. Renvoie l’ID de tâche, puis permet de consulter le résultat via `/suno/fetch/{task_id}`. Interface de soumission des tâches de génération de musique et de sons. Le chemin reste `/suno/submit/music` ; vous pouvez en pratique choisir le moteur de génération via `upstream_model`, `music_model`, `engine`, `model_id` ou `modelId`. L’interface de création renvoie `task_id`, puis `/suno/fetch/{task_id}` sert à interroger la sortie. Si `upstream_model` n’est pas transmis (ou si seul `{"model":"suno_music"}` est transmis), Suno v5.5 est utilisé par défaut. Pour continuer à utiliser l’ancienne version de Suno, transmettez explicitement `"upstream_model":"suno-v5"`. ## Nouveaux modèles | Type | `upstream_model` / Alias | `modelId` | | --- | --- | ---: | | Musique | `suno-v5.5` / `chirp-fenix` | 128 | | Voix | `seed-audio-1.0` | 126 | | Voix | `minimax-speech-2.8-hd` / `speech-2.8-hd` | 127 | | Musique | `lyria-3-pro` / `lyria-3-pro-preview` | 129 | ## Mode de description par prompt Convient lorsque vous décrivez uniquement le style, l’ambiance, la langue, le type de voix et le contexte ; le modèle génère automatiquement le contenu de la chanson. ```json { "model": "suno_music", "upstream_model": "suno-v5.5", "prompt": "Create an energetic retro-pop DJ song about the artificial intelligence revolution.", "make_instrumental": false } ``` ## Génération de son MiniMax Speech peut surcharger les paramètres vocaux via `extraParams` (ou des champs de niveau supérieur homonymes en snake_case/camelCase). ```json { "model": "suno_music", "upstream_model": "minimax-speech-2.8-hd", "prompt": "欢迎使用新版语音生成服务。", "extraParams": { "voice": "moss_audio_ce44fc67-7ce3-11f0-8de5-96e35d26fb85", "outputFormat": "mp3", "sampleRate": 32000, "speed": 1, "volume": 1, "pitch": 0 } } ``` Lorsque aucun paramètre vocal n’est transmis pour MiniMax Speech, le serveur envoie par défaut les valeurs `voice`, `outputFormat=mp3`, `sampleRate=32000`, `speed=1`, `volume=1` et `pitch=0` de l’exemple ci-dessus. Lyria 3 Pro utilise `upstream_model=lyria-3-pro` (ou `lyria-3-pro-preview`) : ```json { "model": "suno_music", "upstream_model": "lyria-3-pro", "prompt": "Cinematic orchestral music with a hopeful finale." } ``` ## Musique légère ou instrumental pur Vous pouvez utiliser `light_music=true` ou `make_instrumental=true`. `light_music` indique une tendance musique légère/musique d’ambiance, et `make_instrumental` indique de ne pas générer de voix chantée. ```json { "model": "suno_music", "upstream_model": "minimax-music-v2.6", "prompt": "Warm cafe background music with soft piano and strings, relaxing and cinematic.", "light_music": true, "make_instrumental": true } ``` ## Mode avancé des paroles Convient lorsque l’équipe métier a déjà préparé les paroles et doit spécifier un titre ainsi que des balises de style. Vous pouvez transmettre `custom_mode=true` ; pour le champ des paroles, utilisez `lyrics`, `lyric`, `custom_lyrics` ou `customLyrics`. ```json { "model": "suno_music", "upstream_model": "mureka-v9", "custom_mode": true, "title": "Summer Sea Breeze", "tags": "electro pop, female vocal, bright summer", "lyrics": "[Verse]\nSea breeze moves across the white sand\n[Chorus]\nTurn the summer into a beam of light" } ``` ## Consultation Après la création réussie, enregistrez l’ID de tâche `data` renvoyé, par exemple `task_xxx`, puis appelez `GET /suno/fetch/{task_id}` pour consulter le statut, l’URL audio, la couverture, le titre, les paroles et les informations de segments bruts renvoyées en amont. requestBody: required: true content: application/json: schema: type: object required: - model - prompt properties: model: type: string example: suno_music description: Transmettez固定 `suno_music`. enum: - suno_music upstream_model: type: string example: suno-v5.5 description: >- Valeur de sélection du moteur de génération ; par défaut `suno-v5.5`, transmettre explicitement `suno-v5` permet de conserver l’ancienne version. music_model: type: string description: Alias de compatibilité de `upstream_model`. engine: type: string description: Alias de compatibilité de `upstream_model`. model_id: oneOf: - type: string - type: integer description: Champ de compatibilité camelCase de `model_id`. modelId: oneOf: - type: string - type: integer description: Champ de compatibilité camelCase de `model_id`. prompt: type: string description: >- En mode de description par prompt, il s’agit du style musical, de l’humeur et du contexte ; en mode avancé pour les paroles, ce champ peut être utilisé comme champ compatible avec les paroles. gpt_description_prompt: type: string description: Champ compatible avec les instructions du mode descriptif. extraParams: type: object description: >- Paramètre vocal de MiniMax Speech 2.8 HD ; champ compatible en snake_case de `extraParams`. properties: voice: type: string default: moss_audio_ce44fc67-7ce3-11f0-8de5-96e35d26fb85 outputFormat: type: string default: mp3 sampleRate: type: integer default: 32000 speed: type: number default: 1 volume: type: number default: 1 pitch: type: number default: 0 additionalProperties: true extra_params: type: object description: >- Paramètre vocal de MiniMax Speech 2.8 HD ; champ compatible en snake_case de `extraParams`. properties: voice: type: string default: moss_audio_ce44fc67-7ce3-11f0-8de5-96e35d26fb85 outputFormat: type: string default: mp3 sampleRate: type: integer default: 32000 speed: type: number default: 1 volume: type: number default: 1 pitch: type: number default: 0 additionalProperties: true voice: type: string description: >- La voix MiniMax Speech 2.8 HD, peut couvrir `extraParams.voice`. output_format: type: string description: Format de sortie de MiniMax Speech 2.8 HD. outputFormat: type: string description: Champ de compatibilité camelCase de `output_format`. sample_rate: type: integer description: Fréquence d’échantillonnage de MiniMax Speech 2.8 HD. sampleRate: type: integer description: Champ de compatibilité camelCase de `sample_rate`. speed: type: number description: Vitesse d’élocution, 1 par défaut. volume: type: number description: "Volume, valeur par défaut\_: 1." pitch: type: number description: Ton, par défaut 0. make_instrumental: type: boolean default: false description: Générer uniquement l’accompagnement. light_music: type: boolean description: Générer dans une orientation musique légère/musique de fond. pure_music: type: boolean description: Générer en orientant vers de la musique pure. custom_mode: type: boolean description: Utiliser le mode personnalisé ou non. customMode: type: boolean description: Champ de compatibilité camelCase de `custom_mode`. title: type: string description: Titre de la chanson. tags: type: string description: Balises de style, par exemple `electro pop, female vocal`. style: type: string description: Champ compatible avec le style. genre: type: string description: Champ de compatibilité des styles musicaux. genres: type: string description: Champ de compatibilité des styles musicaux. lyrics: type: string description: Contenu des paroles. lyric: type: string description: '`lyrics` alias compatible.' custom_lyrics: type: string description: '`lyrics` alias compatible.' customLyrics: type: string description: '`lyrics` alias compatible.' examples: music_submit_prompt: summary: Génération musicale Suno v5.5 value: model: suno_music upstream_model: suno-v5.5 prompt: >- Imitating "Billie Jean," create a DJ song with the theme of "the artificial intelligence revolution." make_instrumental: false music_submit_lyria: summary: Génération musicale Lyria 3 Pro value: model: suno_music upstream_model: lyria-3-pro prompt: Cinematic orchestral music with a hopeful finale. audio_submit_seed: summary: Génération audio Seed Audio 1.0 value: model: suno_music upstream_model: seed-audio-1.0 prompt: 清晨海边的浪声与远处海鸥声。 audio_submit_minimax_speech: summary: MiniMax Speech 2.8 HD value: model: suno_music upstream_model: minimax-speech-2.8-hd prompt: 欢迎使用新版语音生成服务。 extraParams: voice: moss_audio_ce44fc67-7ce3-11f0-8de5-96e35d26fb85 outputFormat: mp3 sampleRate: 32000 speed: 1 volume: 1 pitch: 0 music_submit_light: summary: Génération de musique légère value: model: suno_music upstream_model: minimax-music-v2.6 prompt: >- Warm cafe background music with soft piano and strings, relaxing and cinematic. light_music: true make_instrumental: true music_submit_lyrics: summary: Mode avancé des paroles value: model: suno_music upstream_model: mureka-v9 custom_mode: true title: Summer Sea Breeze tags: electro pop, female vocal, bright summer lyrics: |- [Verse] Sea breeze moves across the white sand [Chorus] Turn the summer into a beam of light responses: '200': description: OK content: application/json: schema: type: object properties: code: type: string example: success description: En cas de succès, `success`. message: type: string description: Message d'erreur ou de notification. data: type: object description: ID de tâche, utilisé pour les requêtes ultérieures. examples: music_submit_success: summary: Soumission de génération musicale réussie value: code: success message: '' data: task_xxx components: securitySchemes: BearerAuth: type: http scheme: bearer description: |- Utilisez l'authentification Bearer Token. Format : `Authorization: Bearer sk-xxxxxx` ````