Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
まだ音声はありません。フォームを送信して音声を生成してください。
さまざまなユースケースとパラメータ設定を確認できます
透明な価格設定、隠れた手数料なし。使用量に応じてお支払い。
| ルールとモダリティ | Channel | クレジット | 価格（USD） | 公式/参考価格 | 1日の節約額 |
|---|---|---|---|---|---|
Suno generate musicSuno | Starter | 1per run | $0.005 | - | - |
Suno の完全ガイド
ApiPass 経由の `suno/generate` では、自然言語の説明をそのまま完成した楽曲に変換できます。ボーカル曲、インスト、広告用 BGM、ラフなデモ制作まで、統一されたタスク API と非同期取得、安定した Webhook で扱えます。
Suno Generate は Suno のテキストから音楽を生成する機能です。プロンプトから楽曲全体を生成でき、スタイル、タイトル、インスト指定、ボーカルの性別などを調整できます。さらに詳細モードでは、スタイルの強さ、創造性、除外したい要素も制御可能です。ApiPass を使えば、開発者は Suno V5、V4.5PLUS、V4.5ALL、V4.5、V4 を統一 API で呼び出せます。
テーマ、雰囲気、テンポ、シーンを一文で説明するだけで、すぐに完成度の高い楽曲を生成できます。アイデア出し、キャンペーン用コンテンツ、音楽生成プロダクトの体験設計に向いています。
`customMode` を有効にし、`style` と `title` を明示的に指定することで、ジャンルや命名の一貫性を高められます。大量生成やテンプレートベースの運用にも適しています。
音楽生成には数十秒かかることが多いため、ApiPass ではタスク方式で提供しています。`/api/v1/jobs/recordInfo` のポーリング、または `callBackUrl` による Webhook のどちらでも運用できます。
AIが歌うボーカルとプロンプトに合った一貫性のある歌詞を含む完全な楽曲を生成します。Suno V5モデルは、複数の言語とスタイルで自然な響きのボーカルを作成します。
ボーカルなしの純粋なインストゥルメンタルトラックを作成します。BGM、ゲームのサウンドトラック、瞑想アプリ、および歌詞のない音楽を必要とするあらゆる用途に最適です。
ポップス、ロック、ヒップホップからクラシック、エレクトロニック、ワールドミュージックまで、何百もの音楽ジャンルをサポートします。複数のスタイルを組み合わせたり、ネガティブタグを使用して不要な要素を除外したりできます。
クリエイティブなビジョンに合わせて、男性と女性のボーカルから選択できます。AIは、音楽スタイルに適応する自然な響きの声を提供します。
スタイルの重み、奇抜さの制限、オーディオの重みなどのパラメーターを使用して、作成した楽曲を微調整します。プロンプトへの厳密な従順さと創造的な探求のバランスをとります。
次のようなワークフローは `suno/generate` と非同期タスク、Webhook の組み合わせに特に向いています。
ユーザーの短いプロンプトから 2 つの候補曲を返し、創作支援やエンタメ体験に活用できます。
広告文や商品訴求を音楽テーマに変換し、マーケティング用の音源制作を効率化できます。
まず taskId を返し、後から Webhook で受けた結果を CMS や業務システムへ書き戻す構成にできます。
複数候補を前提に、編集・審査・公開の各工程に組み込みやすい音楽生成パイプラインを作れます。
ゼロから作るのか、既存の素材を使うのかで選ぶべき API が変わります。
まず歌詞テキストだけを作りたい場合は `suno/lyrics` が向いています。音声やカバー画像を含む完成曲を直接得たい場合は `suno/generate` を使うのが適切です。
`suno/generate` は新しい曲をゼロから作る用途です。既存の Suno 曲を続きを生成したいなら `suno/extend`、既存音源を別スタイルで作り直したいなら `suno/cover` が適しています。
短いアイデアからすぐに曲を作り、複数スタイルを試して比較できる創作支援ツールを実装できます。
広告文、キャンペーンテーマ、商品説明から自動的に楽曲を生成し、動画やプロモーション素材の音源制作を効率化できます。
シーンやキャラクター設定に応じた BGM やテーマ曲を素早く試作し、企画段階の検証スピードを上げられます。
キュー処理、CMS、サーバーオートメーションに組み込み、ユーザーの待ち時間を抑えながらバックグラウンドで楽曲を生成できます。
ApiPass ダッシュボードで API Key を作成します。`suno/generate` へのすべてのリクエストでこのキーを使います。
`/api/v1/jobs/createTask` に `model: "suno/generate"` を含むリクエストを送り、`input` で prompt や style などを指定します。すぐに `taskId` が返ります。
`taskId` を使って `/api/v1/jobs/recordInfo` をポーリングするか、`callBackUrl` を設定して Webhook を受け取ります。完了後に音声 URL、カバー画像、メタデータを取得できます。
すべてのAPIはBearer Tokenによる認証が必要です。
Authorization: Bearer
SDKを使用してタスクを作成し、返されたtaskIdを保存して、Sunoの結果を取得します。
これらのSDKサンプルを実行する前に、@apipass-dev/apipass-sdkをインストールしてください。
1npm install @apipass-dev/apipass-sdk
2# or
3pnpm add @apipass-dev/apipass-sdk
4# or
5yarn add @apipass-dev/apipass-sdkAPI Keyはサーバーサイドの環境変数に保存してください。SDKはBearer tokenとして自動送信し、JSONヘッダーも追加します。
client.jobs.createTask新しいSuno V5音楽生成タスクを作成します
このサンプルを使って、選択したSDKをすばやく使い始められます。
1import { Apipass } from "@apipass-dev/apipass-sdk";
2
3const client = new Apipass({
4 apiKey: process.env.APIPASS_API_KEY!,
5});
6
7const task = await client.jobs.createTask({
8 "model": "suno/generate",
9 "callBackUrl": "https://your-domain.com/api/callback",
10 "input": {
11 "prompt": "A catchy pop song about summer love with upbeat tempo and cheerful melody",
12 "customMode": false,
13 "instrumental": false,
14 "vocalGender": "f"
15 }
16});
17
18console.log(task.data.taskId);このAPIは、以下の構造のJSONペイロードを受け付けます:
1{
2 "model": "suno/generate",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V5_5 |V5 | V4_5PLUS | V4_5ALL | V4_5 | V4",
6 "prompt": "string",
7 "customMode": "boolean",
8 "instrumental": "boolean",
9 "style": "string",
10 "title": "string",
11 "vocalGender": "m | f",
12 "negativeTags": "string",
13 "styleWeight": "number",
14 "weirdnessConstraint": "number",
15 "audioWeight": "number"
16 },
17 "channel": "auto"
18}model必要stringSuno V5音楽生成用のモデル識別子
"suno/generate"
callBackUrlオプションstring生成完了時にWebhook通知を受信するためのURL
"https://your-domain.com/api/callback"
channelオプションstringchannelパラメータを使用して、APIPASS内の対応するプロバイダーを指定できます。これらのプロバイダーが実際の画像および動画生成タスクを処理します。APIPASSは現在、3つのプロバイダーオプションを提供しています:
channelパラメータのデフォルト値はautoです。有効にすると、APIPASSはリアルタイムの価格と安定性指標に基づいて、利用可能なプロバイダー間でタスクを自動的に割り当て、最小コストと信頼性の高いパフォーマンスのバランスを取ります。カスタムルーティング要件がない限り、デフォルトのauto値を維持してください。
利用可能なオプション：
auto
音楽生成用のパラメータ:
input.model_versionオプションstring使用するSunoモデルバージョン。デフォルトはV5です。
利用可能なオプション：
"V5"
input.promptオプションstring生成する音楽のテキスト説明。customModeがfalseの場合、またはcustomModeがtrueかつinstrumentalがfalseの場合に必須です。
customMode=false: promptは必須で、最大500文字です。customMode=true + instrumental=false: promptは必須です。customMode=true + instrumental=true: promptは任意です。customMode=trueの場合: V4: 最大3000文字; V5_5、V5、V4_5PLUS、V4_5ALL、V4_5: 最大5000文字
"A catchy pop song about summer love with upbeat tempo"
input.customModeオプションbooleanより細かく制御するためにカスタムモードを有効にします。trueの場合、styleとtitleが必須です。
customMode=falseの場合、styleとtitleは無視され、プロバイダーには送信されません。
パラメータモード：
customMode=false + instrumental=false
promptcustomMode=false + instrumental=true
promptcustomMode=true + instrumental=false
styletitlepromptcustomMode=true + instrumental=true
styletitlepromptfalse
input.instrumentalオプションbooleanボーカルなしのインストゥルメンタル音楽を生成します。
false
input.styleオプションstring音楽のスタイル/ジャンル。customModeがtrueの場合に必須です。
customMode=trueの場合に必須です。customMode=falseの場合は無視されます。 V4: 最大200文字; V5_5、V5、V4_5PLUS、V4_5ALL、V4_5: 最大1000文字
"Pop, Upbeat, Summer Vibes"
input.titleオプションstring生成される音楽のタイトル。customModeがtrueの場合に必須です。
最大長: 80文字
"Summer Love"
input.vocalGenderオプションstring生成される楽曲のボーカルの性別。
customMode=trueの場合のみ有効です。
利用可能なオプション：
"f"
input.personaIdオプションstring生成される楽曲のPersona ID。
customMode=trueの場合のみ有効です。
"1234567890"
input.negativeTagsオプションstring生成から除外するスタイルや特徴。
customMode=trueの場合のみ有効です。
"aggressive, heavy metal, screaming"
input.styleWeightオプションnumberスタイルにどの程度厳密に従うか。範囲: 0.0-1.0
customMode=trueの場合のみ有効です。customMode=falseの場合は無視されます。0.00から1.00までの数値です。0.01単位で指定する必要があります。ブール値は受け付けられません。
0.5
input.weirdnessConstraintオプションnumber創造性のレベルを制御します。値が高いほど、より実験的な結果が生成されます。範囲: 0.0-1.0
customMode=trueの場合のみ有効です。customMode=falseの場合は無視されます。0.00から1.00までの数値です。0.01単位で指定する必要があります。ブール値は受け付けられません。
0.3
input.audioWeightオプションnumber生成における音声の影響度。範囲: 0.0-1.0
customMode=trueの場合のみ有効です。customMode=falseの場合は無視されます。0.00から1.00までの数値です。0.01単位で指定する必要があります。ブール値は受け付けられません。
0.5
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_abc123xyz"
6 }
7}codeステータスコード。成功時は200
messageレスポンスメッセージ
data.taskIdステータスと結果の照会に使用する一意のタスクID
生成が完了すると、callBackUrlにPOSTリクエストが送信されます
1{
2 "code": 200,
3 "data": {
4 "taskId": "task_abc123xyz",
5 "state": "success",
6 "completeTime": 1755599644000,
7 "costTime": 45000,
8 "createTime": 1755599599000,
9 "model": "suno/generate",
10 "resultJson": {
11 "data": [
12 {
13 "id": "audio_001",
14 "audio_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_audio.mp3",
15 "image_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_cover.jpeg",
16 "duration": 180.5,
17 "title": "Summer Love",
18 "style": "Pop"
19 },
20 {
21 "id": "audio_002",
22 "audio_url": "https://cdn.apipass.dev/results/task_abc123xyz_1_audio.mp3",
23 "image_url": "https://cdn.apipass.dev/results/task_abc123xyz_1_cover.jpeg",
24 "duration": 175.2,
25 "title": "Summer Love",
26 "style": "Pop"
27 }
28 ]
29 }
30 },
31 "msg": "Task completed successfully."
32}1{
2 "code": 501,
3 "data": {
4 "taskId": "task_abc123xyz",
5 "state": "fail",
6 "failCode": "GENERATION_FAILED",
7 "failMsg": "Music generation failed due to content policy violation"
8 },
9 "msg": "Task failed."
10}client.jobs.recordInfoタスクのステータスを照会し、生成された音楽を取得します
このサンプルを使って、選択したSDKをすばやく使い始められます。
1import { Apipass } from "@apipass-dev/apipass-sdk";
2
3const client = new Apipass({
4 apiKey: process.env.APIPASS_API_KEY!,
5});
6
7const result = await client.jobs.recordInfo("task_abc123xyz");
8
9console.log(result.data.state);
10console.log(result.data.resultJson);1{
2 "code": 200,
3 "data": {
4 "taskId": "task_abc123xyz",
5 "state": "success",
6 "resultJson": {
7 "data": [
8 {
9 "id": "audio_001",
10 "audio_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_audio.mp3",
11 "image_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_cover.jpeg",
12 "duration": 180.5
13 }
14 ]
15 }
16 }
17}codeステータスコード。成功時は200
data.taskIdタスクID
data.state現在の状態: queuing、generating、success、fail
data.resultJson.dataURLとメタデータを含む、生成されたオーディオトラックの配列
APIページにはパラメータスキーマが表示されますが、Sunoには見逃しやすいビジネス特有のモードの組み合わせやコールバックルールがいくつかあります。
すべてのAPIはBearer Tokenによる認証が必要です。
Authorization: Bearer
新しいSuno V5音楽生成タスクを作成します
このAPIは、以下の構造のJSONペイロードを受け付けます:
1{
2 "model": "suno/generate",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V5_5 |V5 | V4_5PLUS | V4_5ALL | V4_5 | V4",
6 "prompt": "string",
7 "customMode": "boolean",
8 "instrumental": "boolean",
9 "style": "string",
10 "title": "string",
11 "vocalGender": "m | f",
12 "negativeTags": "string",
13 "styleWeight": "number",
14 "weirdnessConstraint": "number",
15 "audioWeight": "number"
16 },
17 "channel": "auto"
18}model必要stringSuno V5音楽生成用のモデル識別子
"suno/generate"
callBackUrlオプションstring生成完了時にWebhook通知を受信するためのURL
"https://your-domain.com/api/callback"
channelオプションstringchannelパラメータを使用して、APIPASS内の対応するプロバイダーを指定できます。これらのプロバイダーが実際の画像および動画生成タスクを処理します。APIPASSは現在、3つのプロバイダーオプションを提供しています:
channelパラメータのデフォルト値はautoです。有効にすると、APIPASSはリアルタイムの価格と安定性指標に基づいて、利用可能なプロバイダー間でタスクを自動的に割り当て、最小コストと信頼性の高いパフォーマンスのバランスを取ります。カスタムルーティング要件がない限り、デフォルトのauto値を維持してください。
利用可能なオプション：
auto
音楽生成用のパラメータ:
input.model_versionオプションstring使用するSunoモデルバージョン。デフォルトはV5です。
利用可能なオプション：
"V5"
input.promptオプションstring生成する音楽のテキスト説明。customModeがfalseの場合、またはcustomModeがtrueかつinstrumentalがfalseの場合に必須です。
customMode=false: promptは必須で、最大500文字です。customMode=true + instrumental=false: promptは必須です。customMode=true + instrumental=true: promptは任意です。customMode=trueの場合: V4: 最大3000文字; V5_5、V5、V4_5PLUS、V4_5ALL、V4_5: 最大5000文字
"A catchy pop song about summer love with upbeat tempo"
input.customModeオプションbooleanより細かく制御するためにカスタムモードを有効にします。trueの場合、styleとtitleが必須です。
customMode=falseの場合、styleとtitleは無視され、プロバイダーには送信されません。
パラメータモード：
customMode=false + instrumental=false
promptcustomMode=false + instrumental=true
promptcustomMode=true + instrumental=false
styletitlepromptcustomMode=true + instrumental=true
styletitlepromptfalse
input.instrumentalオプションbooleanボーカルなしのインストゥルメンタル音楽を生成します。
false
input.styleオプションstring音楽のスタイル/ジャンル。customModeがtrueの場合に必須です。
customMode=trueの場合に必須です。customMode=falseの場合は無視されます。 V4: 最大200文字; V5_5、V5、V4_5PLUS、V4_5ALL、V4_5: 最大1000文字
"Pop, Upbeat, Summer Vibes"
input.titleオプションstring生成される音楽のタイトル。customModeがtrueの場合に必須です。
最大長: 80文字
"Summer Love"
input.vocalGenderオプションstring生成される楽曲のボーカルの性別。
customMode=trueの場合のみ有効です。
利用可能なオプション：
"f"
input.personaIdオプションstring生成される楽曲のPersona ID。
customMode=trueの場合のみ有効です。
"1234567890"
input.negativeTagsオプションstring生成から除外するスタイルや特徴。
customMode=trueの場合のみ有効です。
"aggressive, heavy metal, screaming"
input.styleWeightオプションnumberスタイルにどの程度厳密に従うか。範囲: 0.0-1.0
customMode=trueの場合のみ有効です。customMode=falseの場合は無視されます。0.00から1.00までの数値です。0.01単位で指定する必要があります。ブール値は受け付けられません。
0.5
input.weirdnessConstraintオプションnumber創造性のレベルを制御します。値が高いほど、より実験的な結果が生成されます。範囲: 0.0-1.0
customMode=trueの場合のみ有効です。customMode=falseの場合は無視されます。0.00から1.00までの数値です。0.01単位で指定する必要があります。ブール値は受け付けられません。
0.3
input.audioWeightオプションnumber生成における音声の影響度。範囲: 0.0-1.0
customMode=trueの場合のみ有効です。customMode=falseの場合は無視されます。0.00から1.00までの数値です。0.01単位で指定する必要があります。ブール値は受け付けられません。
0.5
1curl -X POST "https://api.apipass.dev/api/v1/jobs/createTask" \
2 -H "Content-Type: application/json" \
3 -H "Authorization: Bearer YOUR_API_KEY" \
4 -d '{
5 "model": "suno/generate",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "prompt": "A catchy pop song about summer love with upbeat tempo and cheerful melody",
9 "customMode": false,
10 "instrumental": false,
11 "vocalGender": "f"
12 }
13 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_abc123xyz"
6 }
7}codeステータスコード。成功時は200
messageレスポンスメッセージ
data.taskIdステータスと結果の照会に使用する一意のタスクID
