> ## 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. # Создать задачу генерации музыки или звука > Интерфейс отправки задания на генерацию музыки и звука, совместимый со старым путем `/suno/submit/music`. Возвращает ID задачи; затем запрос можно проверить через `/suno/fetch/{task_id}`. Интерфейс отправки задания на генерацию музыки и звука. Путь остается `/suno/submit/music`; фактически можно выбрать движок генерации через `upstream_model`, `music_model`, `engine`, `model_id` или `modelId`. Интерфейс создания возвращает `task_id`, затем результат можно получить через `/suno/fetch/{task_id}`. Если не передан `upstream_model` (или передан только `{"model":"suno_music"}`), по умолчанию используется Suno v5.5. Если нужно продолжать использовать старую версию Suno, явно передайте `"upstream_model":"suno-v5"`. ## Новые модели | Тип | `upstream_model` / Псевдоним | `modelId` | | --- | --- | ---: | | Музыка | `suno-v5.5` / `chirp-fenix` | 128 | | Голос | `seed-audio-1.0` | 126 | | Голос | `minimax-speech-2.8-hd` / `speech-2.8-hd` | 127 | | Музыка | `lyria-3-pro` / `lyria-3-pro-preview` | 129 | ## Режим описания промпта Подходит, если нужно описать только стиль, настроение, язык, тип исполнителя и сцену, а модель автоматически сгенерирует содержимое песни. ```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 } ``` ## Генерация звука MiniMax Speech может переопределять параметры голоса через `extraParams` (или одноименные поля верхней области видимости в формате 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 } } ``` Если для MiniMax Speech не переданы параметры голоса, сервер по умолчанию отправляет `voice`, `outputFormat=mp3`, `sampleRate=32000`, `speed=1`, `volume=1` и `pitch=0` из примера выше. Lyria 3 Pro использует `upstream_model=lyria-3-pro` (или `lyria-3-pro-preview`): ```json { "model": "suno_music", "upstream_model": "lyria-3-pro", "prompt": "Cinematic orchestral music with a hopeful finale." } ``` ## Легкая музыка или чистый аккомпанемент Можно использовать `light_music=true` или `make_instrumental=true`. `light_music` означает уклон в легкую/фоновую музыку, а `make_instrumental` — не генерировать вокал. ```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 } ``` ## Расширенный режим текста песни Подходит, если на стороне бизнеса уже подготовлен текст песни и нужно указать заголовок и теги стиля. Можно передать `custom_mode=true`, а для поля текста песни можно использовать `lyrics`, `lyric`, `custom_lyrics` или `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" } ``` ## Запрос После успешного создания сохраните возвращенный `data` ID задачи, например `task_xxx`, и вызовите `GET /suno/fetch/{task_id}`, чтобы получить статус, URL аудио, обложку, заголовок, текст песни и исходные фрагменты, возвращенные upstream. ## OpenAPI ````yaml api-reference/ru/openapi.json POST /suno/submit/music openapi: 3.0.0 info: title: Справочная документация API для "出海营" version: 1.0.0 description: Public AI Gateway API Reference servers: - url: https://api.aiid.edu.kg security: - BearerAuth: [] tags: - name: Формат OpenAI (Chat) - name: Формат OpenAI (Responses) - name: Формат Gemini для генерации изображений - name: Генерация изображенийOpenAI в формате DALL-E - name: Получить список моделей - name: Генерация видеоHappyHorse и Wan - name: ФорматKling генерации видео - name: Видео-генерация Omni и формат Veo - name: Генерация видео Seedance - name: Совместимый формат для Sora генерации видео - name: Генерация видео Vidu - name: Формат задачи генерации музыки paths: /suno/submit/music: post: tags: - Формат задачи генерации музыки summary: Создать задачу генерации музыки или звука description: >- Интерфейс отправки задания на генерацию музыки и звука, совместимый со старым путем `/suno/submit/music`. Возвращает ID задачи; затем запрос можно проверить через `/suno/fetch/{task_id}`. Интерфейс отправки задания на генерацию музыки и звука. Путь остается `/suno/submit/music`; фактически можно выбрать движок генерации через `upstream_model`, `music_model`, `engine`, `model_id` или `modelId`. Интерфейс создания возвращает `task_id`, затем результат можно получить через `/suno/fetch/{task_id}`. Если не передан `upstream_model` (или передан только `{"model":"suno_music"}`), по умолчанию используется Suno v5.5. Если нужно продолжать использовать старую версию Suno, явно передайте `"upstream_model":"suno-v5"`. ## Новые модели | Тип | `upstream_model` / Псевдоним | `modelId` | | --- | --- | ---: | | Музыка | `suno-v5.5` / `chirp-fenix` | 128 | | Голос | `seed-audio-1.0` | 126 | | Голос | `minimax-speech-2.8-hd` / `speech-2.8-hd` | 127 | | Музыка | `lyria-3-pro` / `lyria-3-pro-preview` | 129 | ## Режим описания промпта Подходит, если нужно описать только стиль, настроение, язык, тип исполнителя и сцену, а модель автоматически сгенерирует содержимое песни. ```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 } ``` ## Генерация звука MiniMax Speech может переопределять параметры голоса через `extraParams` (или одноименные поля верхней области видимости в формате 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 } } ``` Если для MiniMax Speech не переданы параметры голоса, сервер по умолчанию отправляет `voice`, `outputFormat=mp3`, `sampleRate=32000`, `speed=1`, `volume=1` и `pitch=0` из примера выше. Lyria 3 Pro использует `upstream_model=lyria-3-pro` (или `lyria-3-pro-preview`): ```json { "model": "suno_music", "upstream_model": "lyria-3-pro", "prompt": "Cinematic orchestral music with a hopeful finale." } ``` ## Легкая музыка или чистый аккомпанемент Можно использовать `light_music=true` или `make_instrumental=true`. `light_music` означает уклон в легкую/фоновую музыку, а `make_instrumental` — не генерировать вокал. ```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 } ``` ## Расширенный режим текста песни Подходит, если на стороне бизнеса уже подготовлен текст песни и нужно указать заголовок и теги стиля. Можно передать `custom_mode=true`, а для поля текста песни можно использовать `lyrics`, `lyric`, `custom_lyrics` или `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" } ``` ## Запрос После успешного создания сохраните возвращенный `data` ID задачи, например `task_xxx`, и вызовите `GET /suno/fetch/{task_id}`, чтобы получить статус, URL аудио, обложку, заголовок, текст песни и исходные фрагменты, возвращенные upstream. requestBody: required: true content: application/json: schema: type: object required: - model - prompt properties: model: type: string example: suno_music description: Передавайте фиксированно `suno_music`. enum: - suno_music upstream_model: type: string example: suno-v5.5 description: >- Значение выбора движка генерации; по умолчанию `suno-v5.5`, явная передача `suno-v5` позволяет сохранить старую версию. music_model: type: string description: Совместимый псевдоним для `upstream_model`. engine: type: string description: Совместимый псевдоним для `upstream_model`. model_id: oneOf: - type: string - type: integer description: Совместимое поле camelCase для `model_id`. modelId: oneOf: - type: string - type: integer description: Совместимое поле camelCase для `model_id`. prompt: type: string description: >- В режиме описания промпта — музыкальный стиль, настроение и сцена; в расширенном режиме текста песни может использоваться как совместимое поле для текста песни. gpt_description_prompt: type: string description: Описывает поле совместимости с подсказками режима. extraParams: type: object description: >- Параметр речи MiniMax Speech 2.8 HD; совместимое поле в формате snake_case для `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: >- Параметр речи MiniMax Speech 2.8 HD; совместимое поле в формате snake_case для `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: >- Голос MiniMax Speech 2.8 HD, может заменить `extraParams.voice`. output_format: type: string description: Формат вывода MiniMax Speech 2.8 HD. outputFormat: type: string description: Совместимое поле camelCase для `output_format`. sample_rate: type: integer description: Частота дискретизации MiniMax Speech 2.8 HD. sampleRate: type: integer description: Совместимое поле camelCase для `sample_rate`. speed: type: number description: Скорость речи, по умолчанию 1. volume: type: number description: Громкость, по умолчанию 1. pitch: type: number description: Тональность, по умолчанию 0. make_instrumental: type: boolean default: false description: Генерировать только инструментальное сопровождение. light_music: type: boolean description: Генерировать в стиле лёгкой/фоновой музыки. pure_music: type: boolean description: Генерировать ли в направлении чисто инструментальной музыки. custom_mode: type: boolean description: Использовать ли пользовательский режим. customMode: type: boolean description: Совместимое поле camelCase для `custom_mode`. title: type: string description: Название песни. tags: type: string description: Тег стиля, например `electro pop, female vocal`. style: type: string description: Поле для совместимости стилей. genre: type: string description: Поле совместимости жанров. genres: type: string description: Поле совместимости жанров. lyrics: type: string description: Содержимое текста песни. lyric: type: string description: '`lyrics` Совместимый псевдоним.' custom_lyrics: type: string description: '`lyrics` Совместимый псевдоним.' customLyrics: type: string description: '`lyrics` Совместимый псевдоним.' examples: music_submit_prompt: summary: Генерация музыки 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: Генерация музыки Lyria 3 Pro value: model: suno_music upstream_model: lyria-3-pro prompt: Cinematic orchestral music with a hopeful finale. audio_submit_seed: summary: Генерация звука 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: Генерация легкой музыки 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: Расширенный режим текста песни 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: При успешном выполнении — `success`. message: type: string description: Сообщение об ошибке или подсказке. data: type: object description: ID задачи, используется для последующего запроса. examples: music_submit_success: summary: Отправка генерации музыки выполнена успешно value: code: success message: '' data: task_xxx components: securitySchemes: BearerAuth: type: http scheme: bearer description: |- Используйте проверку подлинности Bearer Token. Формат: `Authorization: Bearer sk-xxxxxx` ````