> ## Documentation Index > Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt > Use this file to discover all available pages before exploring further. # Suno 音楽生成 Beta > - Suno AI音楽生成モデル、テキスト説明または歌詞に基づいて完全な音楽を生成可能 - カスタムモード（スタイル、タイトル、歌詞の細かい制御）とシンプルモード（AI自動生成）に対応 - [Persona](/ja/api-manual/audio-series/suno/suno-persona-creation) 機能をサポート、作成済みのボーカル/スタイル特性を再利用可能 - 非同期処理モード、返却されたタスクIDで[ステータスを照会](/ja/api-manual/task-management/get-task-detail) - 生成された音声リンクは72時間有効です、お早めに保存してください - 各リクエストで複数の音楽バリエーションを生成 ## OpenAPI ````yaml ja/api-manual/audio-series/suno/suno-music-generation.json POST /v1/audios/generations openapi: 3.1.0 info: title: Suno 音楽生成 API description: Suno AIモデルを使用して音楽を生成、ボーカルとインストゥルメンタルの両モードに対応 license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: 本番環境 security: - bearerAuth: [] paths: /v1/audios/generations: post: tags: - Audio Generation summary: Suno 音楽生成 API description: >- - Suno AI音楽生成モデル、テキスト説明または歌詞に基づいて完全な音楽を生成可能 - カスタムモード（スタイル、タイトル、歌詞の細かい制御）とシンプルモード（AI自動生成）に対応 - [Persona](/ja/api-manual/audio-series/suno/suno-persona-creation) 機能をサポート、作成済みのボーカル/スタイル特性を再利用可能 - 非同期処理モード、返却されたタスクIDで[ステータスを照会](/ja/api-manual/task-management/get-task-detail) - 生成された音声リンクは72時間有効です、お早めに保存してください - 各リクエストで複数の音楽バリエーションを生成 operationId: createSunoMusicGeneration requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SunoMusicGenerationRequest' examples: simple_mode: summary: シンプルモード（初心者向け推奨） value: model: suno-v5-beta prompt: A cheerful summer pop song about road trips and freedom custom_mode_with_lyrics: summary: カスタムモード（歌詞付き） value: model: suno-v5-beta custom_mode: true instrumental: false style: pop, electronic, upbeat, female vocals, 120bpm title: Summer Dreams prompt: |- [Verse 1] Driving down the highway, windows down The sun is shining on this little town Radio playing our favorite song Nothing could ever go wrong [Chorus] Summer dreams, summer nights Chasing stars and city lights With you by my side I feel so alive negative_tags: heavy metal, screaming, sad vocal_gender: f custom_mode_with_persona: summary: カスタムモード（Persona使用） value: model: suno-v5-beta custom_mode: true instrumental: false style: electronic pop, synth wave, 128bpm title: ネオンドリーマー prompt: |- [Verse] ネオンの光の中 街を歩く 都市の鼓動が胸に響く [Chorus] 僕らは夢追い人 星空の下で踊る persona_id: 5c57d49ef834110496fae5aa14fec441 persona_model: voice_persona instrumental_mode: summary: インストゥルメンタルモード value: model: suno-v4.5plus-beta custom_mode: true instrumental: true style: lo-fi, chill, ambient, piano, soft drums title: 雨の午後 responses: '200': description: 音楽タスクの作成に成功しました content: application/json: schema: $ref: '#/components/schemas/AudioGenerationResponse' '400': description: リクエストパラメータが不正です content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_request message: Invalid request parameters type: invalid_request_error '401': description: 未認証、トークンが無効または期限切れです content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: クォータ不足のため、チャージが必要です content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: アクセスが拒否されました content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: suno-v5-beta' type: invalid_request_error '429': description: レート制限を超えました content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: サーバー内部エラー content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error '503': description: サービスは一時的に利用できません content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: service_unavailable message: No available channel for the requested model type: api_error components: schemas: SunoMusicGenerationRequest: type: object required: - model - custom_mode - instrumental properties: model: type: string description: >- モデル名 **後方互換性：** 以前に統合されたモデル名（`suno-v5`、`suno-v4.5`、`suno-v4.5plus`、`suno-v4.5all`、`suno-v4`など）は引き続き使用可能で、対応する`-beta`バージョンに自動的にマッピングされます **利用可能なオプション：** - `suno-v5-beta`：V5最新バージョン（デフォルト推奨）、Voice Personaをサポート、より優れた音楽表現力、高速生成、プロンプト最大`5000`文字、スタイル最大`1000`文字 - `suno-v4.5plus-beta`：V4.5+強化バージョン、より豊かな音色、新しいクリエイティブ手法、最大8分、プロンプト最大`5000`文字、スタイル最大`1000`文字 - `suno-v4.5all-beta`：V4.5フル機能バージョン、よりスマートなプロンプト、高速生成、最大8分、プロンプト最大`5000`文字、スタイル最大`1000`文字 - `suno-v4.5-beta`：V4.5バージョン、よりスマートなプロンプト、高速生成、最大8分、プロンプト最大`5000`文字、スタイル最大`1000`文字 - `suno-v4-beta`：V4バージョン、ボーカル品質向上、最大4分、プロンプト最大`3000`文字、スタイル最大`200`文字 enum: - suno-v5-beta - suno-v4.5plus-beta - suno-v4.5all-beta - suno-v4.5-beta - suno-v4-beta example: suno-v5-beta custom_mode: type: boolean description: |- カスタムモードを有効化 **説明：** - `false`：シンプルモード、`prompt`のみ提供、AIが歌詞とスタイルを自動生成 - `true`：カスタムモード、`style`、`title`、歌詞などを細かく制御可能 **カスタムモードの必須パラメータ：** - `style`：必須 - `title`：必須 - `prompt`：`instrumental=false`の場合は必須（歌詞として使用） example: false instrumental: type: boolean description: |- インストゥルメンタル音楽を生成（ボーカルなし） **説明：** - `false`：ボーカル付き音楽を生成 - `true`：ボーカルなしのインストゥルメンタル/BGMを生成 **注意：** - 非カスタムモードでは、このパラメータは必須フィールドに影響しません - カスタムモードで`true`に設定すると、`prompt`はオプションになります example: false prompt: type: string description: |- 希望する音楽内容を説明するプロンプト **非カスタムモード（`custom_mode=false`）：** - 必須、音楽の説明として使用、AIが歌詞とスタイルを自動生成 - 最大文字数：`500`文字 **カスタムモード（`custom_mode=true`）：** - `instrumental=false`の場合に必須、正確な歌詞として使用 - `instrumental=true`の場合は任意 - 最大文字数：V4は`3000`文字、V4.5+は`5000`文字 **歌詞フォーマットの提案：** - `[Verse]`、`[Chorus]`、`[Bridge]`などのタグを使用して歌詞構造を整理してください example: A cheerful summer pop song about road trips and freedom style: type: string description: >- 音楽スタイルの指定 **説明：** - カスタムモード（`custom_mode=true`）で必須 - 音楽のジャンル、ムード、またはアーティスティックな方向性を定義 - 英語のカンマ区切りタグの使用を推奨 **文字数制限：** - V4：最大`200`文字 - V4.5+：最大`1000`文字 **一般的なスタイルタグ：** - ジャンル：pop, rock, jazz, classical, electronic, hip-hop, r&b, country, folk - ムード：happy, sad, energetic, calm, romantic, dark, uplifting - 楽器：piano, guitar, drums, bass, violin, saxophone, synthesizer - ボーカル：male vocals, female vocals, choir, harmonies - テンポ：slow, fast, upbeat, groovy, 120bpm example: pop, electronic, upbeat, female vocals title: type: string description: |- 曲名 **説明:** - カスタムモード（`custom_mode=true`）で必須 - プレーヤーインターフェースとファイル名に表示されます - 最大長: `80` 文字 maxLength: 80 example: Summer Dreams negative_tags: type: string description: |- 除外スタイル、避けたい音楽スタイルや特徴を指定 **例：** - `heavy metal, screaming, sad` - `rap, fast tempo` example: heavy metal, screaming vocal_gender: type: string description: |- ボーカルの性別設定 **オプション:** - `m`: 男性ボイス - `f`: 女性ボイス **注意:** - `custom_mode=true` の場合のみ有効 - このパラメータは確率を上げるだけで、指定された性別に従うことを保証するものではありません enum: - m - f example: f style_weight: type: number description: |- スタイルの重み、指定されたスタイルへの忠実度を制御 **範囲:** `0.0` ~ `1.0`、小数点第1位 **説明:** - 値が高いほど指定されたスタイルにより忠実になります - `0` の値は未設定として扱われます minimum: 0 maximum: 1 example: 0.7 weirdness_constraint: type: number description: |- 奇抜さの制約、出力の創造性/実験性の度合いを制御 **範囲:** `0.0` ~ `1.0`、小数点第1位 **説明:** - 値が高いほどより創造的で実験的な出力になります - 値が低いほどより伝統的で保守的な出力になります - `0` の値は未設定として扱われます minimum: 0 maximum: 1 example: 0.3 audio_weight: type: number description: |- 音声の重み、音声特徴の重みを制御 **範囲：**`0.0`〜`1.0`、小数点以下1桁 **説明：** - 値が`0`の場合は未設定として扱われます minimum: 0 maximum: 1 example: 0.5 persona_id: type: string description: >- Persona ID、作成済みのPersonaスタイルを今回の音楽生成に適用 `custom_mode=true` の場合のみ使用可能。[Suno Persona 作成](/ja/api-manual/audio-series/suno/suno-persona-creation) APIで取得し、一貫したボーカルとスタイル特性を維持できます **取得方法：** Personaタスク完了後、`result_data.persona_id` から取得 example: 5c57d49ef834110496fae5aa14fec441 persona_model: type: string description: >- Persona の適用方式 **オプション：** 1. `style_persona`：スタイル指向型、音楽スタイル特性（編曲、リズム、音色）を重視、すべてのモデルバージョンに対応 2. `voice_persona`：ボイス指向型、ボーカル特性（音色、歌唱法、声質）を重視、**V5のみ対応** `custom_mode=true` の場合のみ使用可能、通常 `persona_id` と組み合わせて使用。`voice_persona` 使用時はモデルが `suno-v5-beta` である必要があり、そうでない場合はエラーが返されます enum: - style_persona - voice_persona example: style_persona callback_url: type: string description: >- タスク完了通知用の HTTPS コールバック URL **コールバックステージ：** - コールバックプロセスには3つのステージがあります：`text`（テキスト生成）、`first`（最初のトラック完了）、`complete`（すべて完了） - 場合によっては、`text` と `first` ステージがスキップされ、直接 `complete` が返されることがあります **セキュリティ制限：** - HTTPS プロトコルのみサポート - 内部 IP アドレスへのコールバックは禁止 - URL の長さは `2048` 文字以内 **コールバックメカニズム：** - タイムアウト：`10` 秒 - 失敗時最大 `3` 回リトライ - コールバック URL が 2xx ステータスコードを返した場合は成功とみなされます format: uri example: https://your-domain.com/webhooks/suno-callback AudioGenerationResponse: type: object properties: created: type: integer description: タスク作成タイムスタンプ example: 1766319090 id: type: string description: タスク ID、タスクのステータスと結果を照会するために使用 example: task-unified-1766319089-oqs9cue4 model: type: string description: 使用された実際のモデル名 example: suno-v5-beta object: type: string enum: - audio.generation.task description: タスクタイプ progress: type: integer description: タスク進捗率（0-100） minimum: 0 maximum: 100 example: 0 status: type: string description: タスクステータス enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/AudioTaskInfo' description: 音声タスクの詳細 type: type: string enum: - audio description: タスク出力タイプ example: audio usage: $ref: '#/components/schemas/Usage' description: 使用量と課金情報 ErrorResponse: type: object properties: error: type: object properties: code: type: string description: エラーコード識別子 message: type: string description: エラーの説明 type: type: string description: エラータイプ AudioTaskInfo: type: object properties: can_cancel: type: boolean description: タスクをキャンセルできるかどうか example: true estimated_time: type: integer description: 推定完了時間（秒） example: 120 Usage: type: object description: 使用量と課金情報 properties: billing_rule: type: string description: 課金ルール enum: - per_call - per_token - per_second example: per_call credits_reserved: type: number description: 推定消費クレジット minimum: 0 example: 10 user_group: type: string description: ユーザーグループカテゴリ enum: - default - vip example: default securitySchemes: bearerAuth: type: http scheme: bearer description: |- ##すべてのAPIにBearer Token認証が必要です## **APIキーの取得：** [APIキー管理ページ](https://evolink.ai/dashboard/keys)にアクセスしてAPIキーを取得してください **リクエストヘッダーに追加：** ``` Authorization: Bearer YOUR_API_KEY ``` ````