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

# Suno 音声クローン API 接続説明

> Suno Music Generation 集成指南 - XHuoAPI

SUNO は任意の音声ファイルを使ってカスタム音声キャラクターを作成し、音声クローンを利用した音楽生成を可能にします。既存の Persona API（Suno 生成の `audio_id` を使用）とは異なり、本 API は公開アクセス可能な `audio_url`、すなわち自身の人声録音を受け入れます。本ドキュメントでは音声クローン API の接続方法を解説します。

## ステップ1：音声キャラクターの作成

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

**音声ファイルの要件：**

* 形式：MP3 または WAV
* 長さ：最低10秒以上
* 内容：単一人物のクリアな人声、背景ノイズや音楽はできるだけ少なく

```bash theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/suno/voices' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "audio_url": "http://cos.aitutu.cc/mp4/ru-user-voice.mp3",
  "name": "RU User Voice Test",
  "description": "ユーザー音声録音サンプル"
}'
```

結果は以下の通りです：

```json theme={null}
{
  "success": true,
  "task_id": "b9150e51-d87c-4556-a55e-100947a63bdf",
  "data": {
    "persona_id": "e95013f8-eaee-4741-a42f-1d559a9d0b2b",
    "name": "RU User Voice Test",
    "is_public": false
  }
}
```

`data` の `persona_id` フィールドが作成された音声キャラクターの ID です。`is_public` フィールドは常に `false` で、アップロード音声から作成された音声キャラクターはプライベートであるためです。

## ステップ2：音声キャラクターを使用した音楽生成

音声キャラクター ID を取得したら、[Suno Audios Generation API](https://api.xhuoapi.ai/documents/4da95d9d-7722-4a72-857d-bf6be86036e9) を使って音楽生成が可能です。`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.xhuoapi.ai/v1/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": "e95013f8-eaee-4741-a42f-1d559a9d0b2b"
}'
```

結果は以下の通りです：

```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` アクションと組み合わせて使用することもでき、クローン音声で既存の楽曲をカバーすることも可能です。