Alibaba Cloud Model Studio:Voice cloning HTTP API reference

Authorization

string

はい

認証トークン。フォーマットは Bearer <your_api_key> です。<your_api_key> を実際の API キーに置き換えます。

Content-Type

string

はい

リクエストボディのメディアタイプ。モデルシリーズに応じて設定します：

• Qwen-Audio-TTS/Qwen-Audio-Realtime/CosyVoice：application/json。

リクエストボディ

modelstring(必須)

voice-enrollment に設定します。

inputobject(必須)

入力パラメーター。

この例では、シンガポールリージョンのエンドポイントを使用します。北京リージョンの場合は、https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/tts/customization を使用します。

{WorkspaceId} を実際のワークスペース ID に置き換えます。

curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/customization \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "voice-enrollment",
    "input": {
        "action": "create_voice",
        "target_model": "qwen-audio-3.1-tts-plus",
        "prefix": "myvoice",
        "audio": "https://your-audio-url.wav",
        "language_hints": ["en"],
        "enable_volume_normalization": "false"
    }
}'

ローカルの WAV ファイルを使用する場合は、以下のコードで Base64 Data URI を生成し、audio の値を作成または更新リクエストの input.audio に指定します。sample.wav をローカル音声ファイルのパスに置き換えてください。

import base64
from pathlib import Path

audio = "data:audio/wav;base64," + base64.b64encode(
    Path("sample.wav").read_bytes()
).decode("ascii")

レスポンスボディ

request_idstring

このリクエストの一意の識別子。

outputobject

モデルから返されたデータ。

usageobject

このリクエストの使用量情報。

リクエストボディ

modelstring(必須)

voice-enrollment に設定します。

inputobject(必須)

入力パラメーター。

この例では、シンガポールリージョンのエンドポイントを使用します。北京リージョンの場合は、https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/tts/customization を使用します。

{WorkspaceId} を実際のワークスペース ID に置き換えます。

curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/customization \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "voice-enrollment",
    "input": {
        "action": "list_voice",
        "prefix": "myvoice",
        "page_size": 10,
        "page_index": 0
    }
}'

レスポンスボディ

request_idstring

このリクエストの一意の識別子。

outputobject

モデルから返されたデータ。

usageobject

このリクエストの使用量情報。

リクエストボディ

modelstring(必須)

voice-enrollment に設定します。

inputobject(必須)

入力パラメーター。

この例では、シンガポールリージョンのエンドポイントを使用します。北京リージョンの場合は、https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/tts/customization を使用します。

{WorkspaceId} を実際のワークスペース ID に置き換えます。

curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/customization \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "voice-enrollment",
    "input": {
        "action": "query_voice",
        "voice_id": "yourVoiceId"
    }
}'

レスポンスボディ

request_idstring

このリクエストの一意の識別子。

outputobject

モデルから返されたデータ。

usageobject

このリクエストの使用量情報。

{
    "output": {
        "gmt_create": "2024-12-11 13:38:02",
        "resource_link": "https://yourAudioFileUrl",
        "target_model": "qwen-audio-3.1-tts-plus",
        "gmt_modified": "2024-12-11 13:38:02",
        "status": "OK"
    },
    "usage": {
        "count": 1
    },
    "request_id": "xxxx-xxxx-xxxx"
}

リクエストボディ

modelstring(必須)

voice-enrollment に設定します。

inputobject(必須)

入力パラメーター。

この例では、シンガポールリージョンのエンドポイントを使用します。北京リージョンの場合は、https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/tts/customization を使用します。

curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/customization \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "voice-enrollment",
    "input": {
        "action": "update_voice",
        "voice_id": "yourVoiceId",
        "audio": "https://new-audio-url.wav"
    }
}'

レスポンスボディ

request_idstring

このリクエストの一意の識別子。

outputobject

モデルから返されたデータ。更新操作はビジネスデータを返しません。レスポンスには preview_audio フィールドが含まれる場合がありますが、これは無視できる空のオブジェクトです。

usageobject

このリクエストの使用量情報。

{
    "output": {
        "preview_audio": {}
    },
    "usage": {
        "count": 1
    },
    "request_id": "xxxx-xxxx-xxxx"
}

リクエストボディ

modelstring(必須)

voice-enrollment に設定します。

inputobject(必須)

入力パラメーター。

この例では、シンガポールリージョンのエンドポイントを使用します。北京リージョンの場合は、https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/tts/customization を使用します。

{WorkspaceId} を実際のワークスペース ID に置き換えます。

curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/customization \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "voice-enrollment",
    "input": {
        "action": "delete_voice",
        "voice_id": "yourVoiceId"
    }
}'

レスポンスボディ

request_idstring

このリクエストの一意の識別子。

outputobject

モデルが返すデータ。空のオブジェクトです。

usageobject

このリクエストの使用量情報。

DEPLOYING

審査中または処理中です。

OK

審査に合格しました。音声は使用可能です。

UNDEPLOYED

審査が拒否されました。音声は使用できません。