> ## 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. # 音楽または音声生成タスクを作成する > 音楽および音声生成の送信 API。旧 `/suno/submit/music` パスと互換性があります。タスク ID を返し、後続は `/suno/fetch/{task_id}` で確認します。 音楽および音声生成タスクの送信 API。パスは `/suno/submit/music` のままで、実際の生成エンジンは `upstream_model`、`music_model`、`engine`、`model_id`、または `modelId` で選択できます。作成 API は `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` はインストゥルメンタル／BGM 寄りであることを示し、`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、カバー、タイトル、歌詞、および上流から返された元のセグメント情報を照会します。 ## OpenAPI ````yaml api-reference/ja/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: Video generation Seedance - name: 動画生成Sora対応形式 - name: Video generation Vidu - name: 音楽生成タスクの形式 paths: /suno/submit/music: post: tags: - 音楽生成タスクの形式 summary: 音楽または音声生成タスクを作成する description: >- 音楽および音声生成の送信 API。旧 `/suno/submit/music` パスと互換性があります。タスク ID を返し、後続は `/suno/fetch/{task_id}` で確認します。 音楽および音声生成タスクの送信 API。パスは `/suno/submit/music` のままで、実際の生成エンジンは `upstream_model`、`music_model`、`engine`、`model_id`、または `modelId` で選択できます。作成 API は `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` はインストゥルメンタル／BGM 寄りであることを示し、`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、カバー、タイトル、歌詞、および上流から返された元のセグメント情報を照会します。 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: '`model_id` の camelCase 互換フィールド。' modelId: oneOf: - type: string - type: integer description: '`model_id` の camelCase 互換フィールド。' prompt: type: string description: >- プロンプト記述モードでは、音楽スタイル、感情、シーンを指定します。歌詞の高度モードでは、歌詞互換フィールドとして使用できます。 gpt_description_prompt: type: string description: 記述モードのプロンプト互換フィールド。 extraParams: type: object description: >- MiniMax Speech 2.8 HD の音声パラメータ。`extraParams` の snake_case 互換フィールドです。 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 の音声パラメータ。`extraParams` の snake_case 互換フィールドです。 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: '`output_format` の camelCase 互換フィールド。' sample_rate: type: integer description: MiniMax Speech 2.8 HD のサンプリングレート。 sampleRate: type: integer description: '`sample_rate` の camelCase 互換フィールド。' 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: '`custom_mode` の camelCase 互換フィールド。' 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` ````