> ## 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 は、任意の音声ファイルを通じてカスタム音声キャラクターを作成し、音声クローンを音楽生成に利用することを可能にします。既存の Persona API（Suno によって生成された `audio_id` を使用）とは異なり、この API は公開アクセス可能な `audio_url`、つまりあなた自身の声の録音を受け入れます。本ドキュメントでは音声クローン API の接続方法を説明します。

## 第一步：音声キャラクターの作成

この API には三つの入力パラメータがあります：`audio_url`（必須）、これは単一の明瞭な人声を含む公開アクセス可能な MP3 または WAV 形式の音声ファイルの URL です；`name` と `description`（任意）、これは音声キャラクターの名前と説明です。

> **音声ファイルの要件**
>
> * 音声フォーマットは `WAV` または `MP3` でなければなりません
> * 音声の長さは `10~240 秒` の間で、`30~60 秒` のクリーンな単一の声の素材を推奨します
> * 音声には**明瞭で識別可能な単一の話し声または歌声**が含まれている必要があります
> * **バックグラウンドノイズ、伴奏、エコー、リバーブ**を必ず避けてください；伴奏付きの完全な曲は通常、声紋検証を通過できません
> * **複数の話者**や**複数の声**を含めないでください
> * 音量が低すぎる、音声が不明瞭、ノイズが多すぎる素材は、**クローン失敗**や**生成効果が悪い**原因となる可能性があります
>   **使用制限の説明**
> * アップロードされた音声を通じて作成された音声キャラクターは**プライベートリソース**です
> * この音声キャラクターは**アカウント間での再利用をサポートしていません**
> * 作成成功後はできるだけ早く使用することをお勧めします。長期間使用しないと**無効または使用不可**になる可能性があります
> * 返された `name` はシステムによって自動生成されますので、返された `persona_id` を基準にしてください

> **呼び出し失敗時はまず再試行してください**
> 音声クローンは計算集約型のタスクであり、素材が完全に準拠していても一定の確率で偶発的な失敗が発生します。一般的な返り値には `voices_sound_different`（声紋検証未通過）などがあります。**この種の失敗は音声の質とは無関係で、同じ素材を使用して再試行することで通常成功します**。統合時には失敗結果に対して 1\~2 回の自動再試行を実装することをお勧めします。失敗したリクエストは課金されません。

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/suno/voices' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "audio_url": "https://cdn.acedata.cloud/suno_demo.mp3",
  "name": "My Voice",
  "description": "単人清晰人声示例"
}'
```

> 上記の `https://cdn.acedata.cloud/suno_demo.mp3` は直接呼び出し可能なサンプル素材です（MP3、41 秒、単一のクリーンな声）。
> `WAV` 形式のサンプルが必要な場合は、次の URL を使用できます
> `https://cdn.acedata.cloud/uploads/82d23b97-ec1c-4b41-91b8-989fc51f8765`（WAV、41 秒、モノラル 44.1kHz）。

結果は以下の通りです：

```json theme={null}
{
  "success": true,
  "task_id": "0fa609a6-c8d9-4bb5-8574-e4c93bb55d02",
  "data": {
    "persona_id": "1ab79a71-a229-4350-8f02-402ff02eac16",
    "name": "VOICE_20260803037676",
    "is_public": false
  }
}
```

`data` の `persona_id` フィールドが作成された音声キャラクターの ID です。`is_public` フィールドは常に `false` で、アップロードされた音声を通じて作成された音声キャラクターはプライベートです。返された `name` はシステムによって自動生成されるため、以降は `persona_id` を使用してこの音声キャラクターを参照してください。

## 第二步：音声キャラクターを使用して音楽を生成

音声キャラクター ID を取得したら、[Suno Audios Generation API](https://platform.acedata.cloud/documents/suno-audios) を使用して音楽生成を行うことができます。`action` を `generate` に設定し、`persona_id` を上記で返された音声キャラクター ID に設定します。生成された曲はクローンされた声で歌われます。

> **注意：** 音声クローンは `chirp-v4-5` 以上のモデル（例：`chirp-v4-5`、`chirp-v5`、`chirp-v5-5`）のみをサポートし、`chirp-v4` はサポートしていません。

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/suno/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "model": "chirp-v5-5",
  "prompt": "A warm synth-pop song about city nights",
  "persona_id": "1ab79a71-a229-4350-8f02-402ff02eac16"
}'
```

結果は以下の通りです：

```json theme={null}
{
  "success": true,
  "task_id": "53d8a334-a972-43c5-895e-60c4454e88d5",
  "data": [
    {
      "id": "16463960-077c-4700-bbb3-3c7897b943d3",
      "title": "Soft Neon on My Skin",
      "audio_url": "https://cdn1.suno.ai/16463960-077c-4700-bbb3-3c7897b943d3.mp3",
      "image_url": "https://cdn2.suno.ai/image_16463960-077c-4700-bbb3-3c7897b943d3.jpeg",
      "model": "chirp-v5-5",
      "state": "succeeded",
      "prompt": "A warm synth-pop song about city nights",
      "duration": 156.28
    }
  ]
}
```

生成された曲はクローンされた声で歌われていることがわかります。`persona_id` は `cover` アクションと組み合わせて使用することもでき、クローンされた声で既存の曲をカバーすることができます。