> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Suno 参考音声アップロード API 連携ガイド

> Suno Music Generation API guide - Ace Data Cloud

SUNO では、参考音声をアップロードして二次創作を行うことができます。本ドキュメントでは、関連 API の連携方法について説明します。

通常のアップロードには `audio_url` のみが必要です。これは公開アクセス可能な音声 CDN アドレスです。`mode` のデフォルトは `standard` であるため、既存の呼び出しを変更する必要はありません。通常のアップロードが成功すると **0.06 Credits** を消費します。アップロードが失敗した場合は課金されません。

ここで入力する `audio_url` は `https://cdn.acedata.cloud/suno_demo.mp3` であり、公開アクセス可能な CDN アドレスです。

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/suno/upload' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "audio_url": "https://cdn.acedata.cloud/suno_demo.mp3"
}'
```

結果は以下のとおりです。

```
{
    "success": true,
    "task_id": "058f8450-3df4-4f8b-8b64-ebc2e59ed3bc",
    "data": {
        "audio_id": "00135f7d-cda1-4d70-b007-779f07143586",
        "lyric": "[Intro]\nHa-ha-ha-ha-ha-ha\n[Verse 1]\nCandy skies are dripping blue\nStuck in world of chewed up glue\nThe sun's a lollipop melting slow\nDripped in sugar on the ground below\nOh-oh\n[Chorus]\nIt's a bubblegum catastrophe\nSticky mess can't set it free\nPop it once it multiplies\nCandy chaos in disguise\nIt's a bubblegum catastrophe\nSticky mess can't set it free\nPop it once it multiplies\nCandy chaos in disguise\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nCandy chaos in disguise\n[Verse 2]\nJellybean mountains crumble fast\nRainbows made of soda blast\nEvery step's a gummy bear trap\nMy sugar rush is taking a nap\nOh-oh\n[Bridge]\nChew it up (ha-ha-ha-ha)\nSpit it out (ha-ha-ha-ha)\nRound and round (ha-ha-ha-ha)\nWithout a doubt (ha-ha-ha-ha)\n[Chorus]\nIt's a bubblegum catastrophe\nSticky mess can't set it free\nPop it once it multiplies\nCandy chaos in disguise\nIt's a bubblegum catastrophe\nSticky mess can't set it free\nPop it once it multiplies\nCandy chaos in disguise\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\n[Outro]\nCotton candy clouds collapse\nChocolate rivers running laps\nEverywhere's a sugar flood\nMy shoes are drowning caramel\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nIt's a bubblegum catastrophe\nSticky mess can't set it free\nPop it once it multiplies\nCandy chaos in disguise\nIt's a bubblegum catastrophe\nSticky mess can't set it free\nPop it once it multiplies\nCandy chaos in disguise",
        "style": "Upbeat bubblegum pop track with a high-energy electronic production style. The song features a bright, processed female vocal with a youthful and energetic tone, often layered with harmonies and occasional pitch-shifted ad-libs. The instrumentation is dominated by bouncy, staccato synthesizer chords, a driving four-on-the-floor electronic drum beat with crisp claps on the backbeat, and a prominent, melodic bassline. The tempo is approximately 128 BPM in a major key, utilizing a standard pop chord progression of I-V-vi-IV. Production elements include heavy use of sidechain compression, vocal chops, and shimmering sound effects that contribute to a sugary, hyper-pop aesthetic. The structure follows a verse-chorus-verse-chorus-bridge-chorus format with a high-energy build-up leading into the explosive, hook-driven choruses.",
        "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-001",
        "image_large_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-002",
        "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
        "title": "up-d6c3970d-6db1-41e3-b966-90539c93678a",
        "duration": 131.16
    }
}
```

ご覧のとおり、`data` は常にオブジェクトであり、`audio_id` はアップロード後の楽曲 ID です。`lyric`、`style`、`duration`、タイトル、メディア URL などの解析結果は任意フィールドであり、具体的には返却内容に準拠します。

楽曲 ID を取得した後は、[Suno Audios Generation API](https://platform.acedata.cloud/documents/suno-audios) を通じて、`upload_extend`、`upload_cover`、または区間サンプリングなど、`audio_id` を必要とする操作を呼び出すことができます。Inspo インスピレーション作成機能を通じて、1～4 本の完全な参考音声に基づいて新しい音楽を作成する場合は、`action=inspo` を直接呼び出し、元の公開音声 URL リストを渡してください。サービスがアップロードと解析を自動的に完了するため、クライアント側で音声 metadata を組み立てる必要はありません。

## 拡張アップロードモード

> `audio_url` は入力アドレスであり、音声処理フローに直接渡され、最終メディア永続化サービスによって事前に転送・保存されることはありません。タスク処理中に公開アクセス可能であることを確認してください。

通常のアップロードで、所有している、または使用許諾を受けている音声を処理できない場合は、`mode` を `enhanced` に設定できます。このモードでは、1～100 文字の `name` も必須であり、公開アクセス可能な HTTPS `audio_url` を使用する必要があります。

拡張アップロードは固定で非同期処理を採用しており、通常 2 分以上かかります。処理に成功すると **1.87 Credits** を消費します。処理に失敗した場合は課金されません。

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/suno/upload' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "audio_url": "https://cdn.acedata.cloud/suno_demo.mp3",
    "mode": "enhanced",
    "name": "My Song"
  }'
```

インターフェースは直ちに `task_id` と `trace_id` を返します。[Suno Tasks API](https://platform.acedata.cloud/documents/suno-tasks) を使用してタスクを照会し、成功後に `response.data.audio_id` からアップロード後の音声 ID を読み取ります。HTTPS `callback_url` を指定して最終状態を受信することもできます。

拡張アップロードで取得した `audio_id` は、Cover、Samples、Mashup に使用できます。伴奏および MIDI 抽出、全トラック分離、ボーカル／伴奏分離は、依然として音声の所属アカウントによる制限を受ける可能性があります。記載されていない操作については、アカウントをまたいだ利用を保証しません。音声が短いほど、通常は処理成功率が高くなります。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.