Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
まだ音声はありません。フォームを送信して音声を生成してください。
さまざまなユースケースとパラメータ設定を確認できます
透明な価格設定、隠れた手数料なし。使用量に応じてお支払い。
| ルールとモダリティ | Channel | クレジット | 価格（USD） | 公式/参考価格 | 1日の節約額 |
|---|---|---|---|---|---|
Suno upload-extend musicSuno | Starter | 1per run | $0.005 | - | - |
Suno の完全ガイド
任意の音声ファイルをアップロードし、元の素材にシームレスに合う AI 生成の続きを追加して拡張できます。
Upload & Extend API を使用すると、任意の音声ファイルをアップロードし、AI に音楽の続きを生成させて拡張できます。標準の extend API（Suno で生成されたトラックに対応）とは異なり、この API はあらゆる音声ソースに対応します。自分の録音、他のツールで作成した音楽、任意の音声ファイルを利用できます。AI はアップロードされた音声を解析して、スタイル、テンポ、キー、雰囲気を理解し、元の音声が終わる位置、または指定した任意の地点から自然につながる新しいコンテンツを生成します。
AI に音声を解析させ、自然に合う続きを自動生成します。AI は元の音声からスタイル、テンポ、ムードを推定し、シームレスに拡張します。
開始地点、スタイル、タイトル、プロンプトを指定して細かく制御できます。元の音声との一貫性を保ちながら、特定の方向性で音声を拡張するよう AI をガイドします。
自分の録音、DAW からの書き出し、サンプル、サードパーティ生成の音楽など、任意の音声ソースで動作します。音声が Suno で生成されている必要はありません。
AI が音声を自動解析し、テンポ、キー、スタイル、楽器構成を理解して、自然に聞こえる拡張を生成します。
音声内の任意の地点から拡張できます。曲の途中に新しいセクションを追加したり、アウトロを延長したり、特定の瞬間から続きを生成したりできます。
プロンプトやスタイルパラメータを使用して、拡張部分の展開をガイドできます。元の雰囲気を保つことも、新しい方向へ発展させることも可能です。
わずか数ステップで自分の音声ファイルを拡張できます
拡張したい音声ファイルをアップロードします。最大 50MB の MP3、WAV、OGG、M4A、FLAC 形式に対応しています。
すばやく拡張する場合は自動モードを、続きを細かく制御したい場合はカスタムモードを使用します。
カスタムモードでは、continueAt の位置、スタイル、タイトル、必要に応じて拡張内容を説明するプロンプトを指定します。
リクエストを送信します。AI が音声を解析し、自然に合う続きを生成します。
元の音声に加えて、AI が新しく生成した続きが含まれる拡張済みトラックを取得します。
最適な結果を得るために、以下のガイドラインに従ってください
音質が高く明瞭なソースファイルほど、より良い拡張結果が得られます。強く圧縮された録音やノイズの多い録音は避けてください。
continueAt は自然な音楽的な切り替わり地点に設定してください。フレーズの終わり、セクションの後、または伸ばした音の途中に設定すると、より滑らかな結果が得られます。
プロンプトでは、音楽をどのように発展させたいかを説明します。エネルギーを高める、ブリッジへ移行する、アウトロを作る、特定の要素を追加するなどを指定できます。
制作途中の録音をアップロードし、AI に自然に聞こえる続きを生成させて完成をサポートできます。
サンプル、ライセンス済み音楽、他の AI ツールの出力など、任意のソースの音声を取り込み、拡張できます。
既存の作品を起点に新しい方向へ拡張し、バリエーションや別バージョンを作成できます。
短いループやセグメントをアップロードし、フルレングスの楽曲へ拡張できます。
Suno で生成されたコンテンツに限定されません。あらゆるソースの任意の音声ファイルを、高品質な AI 生成の続きで拡張できます。
高度な AI が元音声の音楽的特徴を理解し、自然で一貫性のある拡張を実現します。
主要な音声形式すべてに対応した使いやすいファイルアップロード API です。アップロード、拡張、ダウンロードを 1 つのシームレスなワークフローで行えます。
すべての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アップロードした音声ファイルを拡張する新しいタスクを作成します
このサンプルを使って、選択した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/upload-extend",
9 "callBackUrl": "https://your-domain.com/api/callback",
10 "input": {
11 "audioUrl": "https://your-storage.com/audio/my-song.mp3",
12 "continueAt": 60,
13 "prompt": "Build into an epic chorus with full instrumentation",
14 "style": "Pop Rock, Anthemic",
15 "title": "My Song (Extended)"
16 }
17});
18
19console.log(task.data.taskId);このAPIは、次の構造のJSONペイロードを受け付けます:
1{
2 "model": "suno/upload-extend",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V5_5 |V5 | V4_5PLUS | V4_5ALL | V4_5 | V4",
6 "audioUrl": "string (required)",
7 "instrumental": "boolean",
8 "continueAt": "integer",
9 "prompt": "string",
10 "style": "string",
11 "title": "string",
12 "vocalGender": "m | f",
13 "personaId": "string",
14 "negativeTags": "string",
15 "styleWeight": "number",
16 "weirdnessConstraint": "number",
17 "audioWeight": "number"
18 },
19 "channel": "auto"
20}model必要stringSuno V5 upload & extend 用のモデル識別子
"suno/upload-extend"
callBackUrlオプションstring拡張が完了したときにWebhook通知を受け取るURL
"https://your-domain.com/api/callback"
channelオプションstringchannel パラメータで、APIPASS 内の対応するプロバイダーを指定できます。これらのプロバイダーが実際の画像および動画生成タスクを処理します。APIPASS は現在、次の3つのプロバイダーオプションを提供しています:
channel パラメータのデフォルト値は auto です。有効にすると、APIPASS はリアルタイムの価格と安定性指標に基づき、利用可能なプロバイダー間でタスクを自動的に割り当て、最小コストと信頼性の高いパフォーマンスのバランスを取ります。カスタムルーティング要件がない限り、デフォルトの auto 値を維持してください。
利用可能なオプション：
auto
upload & extend のパラメータ:
input.model_versionオプションstring使用するSunoモデルバージョン。デフォルトはV5です。
利用可能なオプション：
"V5"
input.audioUrl必要string拡張する音声ファイルのURL。公開アクセス可能なURLである必要があります。
"https://your-storage.com/audio/my-song.mp3"
input.instrumentalオプションbooleanボーカルなしのインストゥルメンタル拡張を生成します。
任意。デフォルトはfalseです。指定する場合はbooleanである必要があります。
false
input.continueAt必要integer拡張を開始する秒数。必須で、> 0 である必要があります。
カスタムパラメータを使用する場合は > 0 である必要があります
60
input.promptオプションstring拡張セクションの説明。
instrumental=false の場合は必須。instrumental=true の場合は任意。 V4: 最大3000文字 V5_5, V5, V4_5PLUS, V4_5ALL, V4_5: 最大5000文字
"Build to an epic chorus with harmonies"
input.style必要string拡張用の音楽スタイル。必須
V4: 最大200文字 V5_5, V5, V4_5PLUS, V4_5ALL, V4_5: 最大1000文字
"Pop Rock, Uplifting"
input.title必要string拡張トラックのタイトル。必須
最大長: 80文字
"My Song (Extended)"
personaIdオプションinputPersona ID の任意の文字列。customMode=true の場合にのみ有効です。
vocalGenderオプションradio拡張で使用するボーカルの性別を選択します。
negativeTagsオプションinput拡張から除外するスタイルや特徴。
styleWeightオプションslider拡張におけるスタイルガイダンスの重み。
weirdnessConstraintオプションslider拡張の創造性レベルを制御します。
audioWeightオプションslider拡張における音声の影響度の重み。
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_upload_ext_xyz789"
6 }
7}codeステータスコード。成功時は200
messageレスポンスメッセージ
data.taskId拡張ステータスの照会に使用するタスクID
拡張が完了すると、callBackUrl にPOSTリクエストが送信されます
1{
2 "code": 200,
3 "data": {
4 "taskId": "task_upload_ext_xyz789",
5 "state": "success",
6 "completeTime": 1755599800000,
7 "costTime": 75000,
8 "model": "suno/upload-extend",
9 "resultJson": {
10 "data": [
11 {
12 "id": "ext_001",
13 "audio_url": "https://cdn.apipass.dev/results/task_upload_ext_xyz789_0_audio.mp3",
14 "image_url": "https://cdn.apipass.dev/results/task_upload_ext_xyz789_0_cover.jpeg",
15 "duration": 180.5
16 }
17 ]
18 }
19 },
20 "msg": "Extension completed successfully."
21}1{
2 "code": 501,
3 "data": {
4 "taskId": "task_upload_ext_xyz789",
5 "state": "fail",
6 "failCode": "INVALID_AUDIO_URL",
7 "failMsg": "Unable to download audio from provided URL"
8 },
9 "msg": "Extension 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_upload_ext_xyz789");
8
9console.log(result.data.state);
10console.log(result.data.resultJson);1{
2 "code": 200,
3 "data": {
4 "taskId": "task_upload_ext_xyz789",
5 "state": "success",
6 "resultJson": {
7 "data": [
8 {
9 "id": "ext_001",
10 "audio_url": "https://cdn.apipass.dev/results/task_upload_ext_xyz789_0_audio.mp3",
11 "image_url": "https://cdn.apipass.dev/results/task_upload_ext_xyz789_0_cover.jpeg",
12 "duration": 180.5
13 }
14 ]
15 }
16 }
17}data.state現在の状態: queuing, generating, success, または fail
data.resultJson.dataURLとメタデータを含む拡張済み音声トラックの配列
APIページにはパラメータスキーマが表示されますが、Sunoには見逃しやすいビジネス特有のモードの組み合わせやコールバックルールがいくつかあります。
すべてのAPIはBearer Tokenによる認証が必要です。
Authorization: Bearer
アップロードした音声ファイルを拡張する新しいタスクを作成します
このAPIは、次の構造のJSONペイロードを受け付けます:
1{
2 "model": "suno/upload-extend",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V5_5 |V5 | V4_5PLUS | V4_5ALL | V4_5 | V4",
6 "audioUrl": "string (required)",
7 "instrumental": "boolean",
8 "continueAt": "integer",
9 "prompt": "string",
10 "style": "string",
11 "title": "string",
12 "vocalGender": "m | f",
13 "personaId": "string",
14 "negativeTags": "string",
15 "styleWeight": "number",
16 "weirdnessConstraint": "number",
17 "audioWeight": "number"
18 },
19 "channel": "auto"
20}model必要stringSuno V5 upload & extend 用のモデル識別子
"suno/upload-extend"
callBackUrlオプションstring拡張が完了したときにWebhook通知を受け取るURL
"https://your-domain.com/api/callback"
channelオプションstringchannel パラメータで、APIPASS 内の対応するプロバイダーを指定できます。これらのプロバイダーが実際の画像および動画生成タスクを処理します。APIPASS は現在、次の3つのプロバイダーオプションを提供しています:
channel パラメータのデフォルト値は auto です。有効にすると、APIPASS はリアルタイムの価格と安定性指標に基づき、利用可能なプロバイダー間でタスクを自動的に割り当て、最小コストと信頼性の高いパフォーマンスのバランスを取ります。カスタムルーティング要件がない限り、デフォルトの auto 値を維持してください。
利用可能なオプション：
auto
upload & extend のパラメータ:
input.model_versionオプションstring使用するSunoモデルバージョン。デフォルトはV5です。
利用可能なオプション：
"V5"
input.audioUrl必要string拡張する音声ファイルのURL。公開アクセス可能なURLである必要があります。
"https://your-storage.com/audio/my-song.mp3"
input.instrumentalオプションbooleanボーカルなしのインストゥルメンタル拡張を生成します。
任意。デフォルトはfalseです。指定する場合はbooleanである必要があります。
false
input.continueAt必要integer拡張を開始する秒数。必須で、> 0 である必要があります。
カスタムパラメータを使用する場合は > 0 である必要があります
60
input.promptオプションstring拡張セクションの説明。
instrumental=false の場合は必須。instrumental=true の場合は任意。 V4: 最大3000文字 V5_5, V5, V4_5PLUS, V4_5ALL, V4_5: 最大5000文字
"Build to an epic chorus with harmonies"
input.style必要string拡張用の音楽スタイル。必須
V4: 最大200文字 V5_5, V5, V4_5PLUS, V4_5ALL, V4_5: 最大1000文字
"Pop Rock, Uplifting"
input.title必要string拡張トラックのタイトル。必須
最大長: 80文字
"My Song (Extended)"
personaIdオプションinputPersona ID の任意の文字列。customMode=true の場合にのみ有効です。
vocalGenderオプションradio拡張で使用するボーカルの性別を選択します。
negativeTagsオプションinput拡張から除外するスタイルや特徴。
styleWeightオプションslider拡張におけるスタイルガイダンスの重み。
weirdnessConstraintオプションslider拡張の創造性レベルを制御します。
audioWeightオプションslider拡張における音声の影響度の重み。
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/upload-extend",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "audioUrl": "https://your-storage.com/audio/my-song.mp3",
9 "continueAt": 60,
10 "prompt": "Build into an epic chorus with full instrumentation",
11 "style": "Pop Rock, Anthemic",
12 "title": "My Song (Extended)"
13 }
14 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_upload_ext_xyz789"
6 }
7}codeステータスコード。成功時は200
messageレスポンスメッセージ
data.taskId拡張ステータスの照会に使用するタスクID
