オーディオ

Suno V5

Suno API は、プロンプト、スタイル、歌詞からスタジオ品質の音楽を生成し、1回の実行で2つのトラックを非同期で提供します。

$0.12 / use

1回の実行につき2トラック非同期ワークフロープロンプトと歌詞のコントロールMP3 + カバーアート

パラメーター

Model Version*

Custom Mode*

有効

Title*

Style of Music*

Lyrics (optional but recommended)

Instrumental Only*

無効

Vocal Gender Preference

出力

生成されたコンテンツがここに表示されます

エンドポイント

POSThttps://api.apixo.ai/api/v1/generateTask/sunoタスクを作成

GEThttps://api.apixo.ai/api/v1/statusTask/suno?taskId={taskId}ステータスを確認（ポーリング）

認証

APIアクセスを確認中...

サインインして無料クレジットを受け取り、プレイグラウンドをテストして、API統合に進みます。

リクエストボディ

request_type

async

Webhookにはcallback_urlを使用したコールバックを利用してください。

provider

official

Seedance 2.0のマニュアルに準拠しています。

input

オブジェクト

モード、プロンプト、リファレンス、サイズ、再生時間、オーディオ設定。

パラメーター

request_type必須

タイプselect

Use async to poll or callback to receive a webhook when ready.async · callback

callback_url条件付き

タイプtext

Publicly accessible URL for callback mode.限定 request_type=callback

mode必須

タイプselect

Choose the generation backend. V5 is fastest with the best vocals.V5 · V4_5 · V4_5PLUS

customMode必須

タイプboolean

Enable to control title/style/lyrics. When off, prompt-only mode is used.

title必須

タイプtext

Appears in metadata and can steer theme. Required when Custom Mode is on.限定 customMode=

style必須

タイプstring

Describe genre/mood/instrumentation. Required in Custom Mode.限定 customMode=

prompt条件付き

タイプstring

Provide full lyrics for sung output. Required when Instrumental is off.限定 customMode=

songDescription必須

タイプstring

Simple mode: one field to steer both style and topic when Custom Mode is off.限定 customMode=

instrumental必須

タイプboolean

Turn on to generate backing track without vocals.

negativeTags条件付き

タイプstring

Negative Tags限定 customMode=

styleWeight条件付き

タイプslider

How strongly to follow the Style description.限定 customMode=

weirdnessConstraint条件付き

タイプslider

Push creativity/experimentation. Higher = wilder.限定 customMode=

audioWeight条件付き

タイプslider

Balance audio vs lyrical fidelity. Higher favors audio fidelity.限定 customMode=

vocalGender条件付き

タイプselect

Best-effort vocal timbre preference (custom mode only).f · m限定 customMode=

パラメーター	タイプ	必須	説明
`request_type`	select	必須	Use async to poll or callback to receive a webhook when ready.async · callback
`callback_url`	text	条件付き	Publicly accessible URL for callback mode.限定 request_type=callback
`mode`	select	必須	Choose the generation backend. V5 is fastest with the best vocals.V5 · V4_5 · V4_5PLUS
`customMode`	boolean	必須	Enable to control title/style/lyrics. When off, prompt-only mode is used.
`title`	text	必須	Appears in metadata and can steer theme. Required when Custom Mode is on.限定 customMode=
`style`	string	必須	Describe genre/mood/instrumentation. Required in Custom Mode.限定 customMode=
`prompt`	string	条件付き	Provide full lyrics for sung output. Required when Instrumental is off.限定 customMode=
`songDescription`	string	必須	Simple mode: one field to steer both style and topic when Custom Mode is off.限定 customMode=
`instrumental`	boolean	必須	Turn on to generate backing track without vocals.
`negativeTags`	string	条件付き	Negative Tags限定 customMode=
`styleWeight`	slider	条件付き	How strongly to follow the Style description.限定 customMode=
`weirdnessConstraint`	slider	条件付き	Push creativity/experimentation. Higher = wilder.限定 customMode=
`audioWeight`	slider	条件付き	Balance audio vs lyrical fidelity. Higher favors audio fidelity.限定 customMode=
`vocalGender`	select	条件付き	Best-effort vocal timbre preference (custom mode only).f · m限定 customMode=

例 (cURL)

curl -X POST "https://api.apixo.ai/api/v1/generateTask/suno" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "mode": "V5",
    "title": "Neon Freeway Nights",
    "style": "Synthwave, dreamy pop",
    "prompt": "Two verses about cruising the city at midnight under neon rain, feeling hopeful.",
    "songDescription": "A dreamy synthwave song about neon city nights and freedom.",
    "customMode": true,
    "instrumental": false,
    "negativeTags": "off-key vocals, muddy mix",
    "styleWeight": 0.7,
    "weirdnessConstraint": 0.25,
    "audioWeight": 0.6,
    "vocalGender": "f"
  }'

完全なAPIドキュメント

出力例

APIXOの Suno V5 APIで生成

2 トラック

Neon Freeway Nights

表示

完全ガイド

Suno APIとは何ですか？

Suno API は、迅速な制作ワークフロー向けに設計されたテキストから音楽を生成するインターフェースです。プロンプト、スタイルタグ、カスタム歌詞を、関連するカバー画像とともに2つの完全な楽曲出力に変換できます。

手動での作曲よりも迅速な反復が重視されるクリエイター向けツール、ブランドコンテンツ生成、自動音楽制作などのユースケースに適しています。

生成ワークフローの仕組み

プロンプトのみ、またはカスタム歌詞モードのパラメータを使用して生成リクエストを送信します。
ポーリングまたはコールバックエンドポイントを介して、非同期でタスクステータスを受信します。
成功時、生成された2つのトラックと対応するアートワークのメタデータを消費します。

Suno API 技術仕様

プロダクトおよびバックエンド統合に関連する動作特性。

出力

1回の生成につき2トラック

コントロールサーフェス

スタイル、奇抜さ、オーディオの重み

生成モード

プロンプトのみ、およびカスタム歌詞モード

配信

非同期ポーリングまたはコールバック

主な機能

デュアルトラック出力

1回の生成につき2つの楽曲バリエーションを返します。制作チームのA/Bテストやクリエイティブな反復作業を加速させます。

クリエイティブ・コントロール・スライダー

スタイルウェイト、Weirdness（奇妙さ）、オーディオウェイトを調整することで、安全な商用トラックから実験的なテクスチャまで出力を変化させることができます。

歌詞とボーカルのワークフロー

プロンプトのみの生成と、インストゥルメンタルやボーカルの性別の好みを指定できるカスタム歌詞モードをサポートしています。

非同期連携に対応

ポーリングまたはコールバック戦略に対応しており、キューベースのバックエンドワークフローへの統合が容易です。

何が構築できますか？

アプリ内音楽生成

UGC、短尺動画、ソーシャル制作ツール向けに、ブランド音楽スニペットやクリエイター向けのトラックを生成します。

ポッドキャストおよびビデオブランディング

制御可能なムードとペースで、イントロ、アウトロ、バンパー、繰り返しのテーマモチーフを制作します。

ショート動画用サウンドトラック

TikTok、Shorts、Reels向けのカスタムBGMを、スタイルや歌詞のフックを素早く反復しながら作成できます。

ゲームおよびインタラクティブオーディオ

ゲームやインタラクティブな体験のためのアンビエントループ、メニューテーマ、軽量なスコア案のプロトタイプを作成します。

注意点と制限事項

1回の生成につき正確に2つのトラックを返します。出力数はカスタマイズできません。
Playgroundのワークフローは非同期優先です。コールバックのオーケストレーションはAPIレベルで利用可能です。
サポートされているバージョンでは、カスタムモードのプロンプト/歌詞の長さは最大5,000文字に制限されています。
ボーカルの性別や特徴はベストエフォート型の制御であり、厳密な保証ではありません。

よくある質問

開発を始める

上記のプレイグラウンドで試し、統合の準備ができたらAPIドキュメントに進んでください。

プレイグラウンドを試す APIドキュメントを見る

Suno V5

出力例

Suno APIとは何ですか？

生成ワークフローの仕組み

Suno API 技術仕様

出力

コントロールサーフェス

生成モード

配信

主な機能

デュアルトラック出力

クリエイティブ・コントロール・スライダー

歌詞とボーカルのワークフロー

非同期連携に対応

何が構築できますか？

アプリ内音楽生成

ポッドキャストおよびビデオブランディング

ショート動画用サウンドトラック

ゲームおよびインタラクティブオーディオ

注意点と制限事項

よくある質問

2曲ではなく1曲だけ生成することはできますか？

歌詞を正確に出力させることはできますか？

このAPIは同期型ですか？

どのファイル形式が返されますか？

開発を始める