README

描述

这个PHP库提供了一个强大的接口，用于与Cartesia REST API交互，允许您将Cartesia的高级语音克隆和语音合成功能无缝集成到您的PHP应用程序中。请注意，此库并非与Cartesia AI官方关联。

主要功能

• 高质量的语音合成：使用Cartesia的尖端模型将文本转换为自然、生动的语音。
• 自定义语音克隆：创建个性化的合成语音，捕捉您希望的声音的独特本质和语调。
• 简化语音管理：轻松管理您的克隆语音，包括列出、检索、更新和删除。
• 直观且用户友好的界面：库提供简单且文档齐全的接口，使与您的PHP项目集成快速且简单。

入门

安装

安装Cartesia PHP库的推荐方法是使用Composer

composer require lucianotonet/cartesia-php

使用

以下是一个基本示例，说明如何使用库将文本生成语音

require 'vendor/autoload.php';

use LucianoTonet\CartesiaPHP\CartesiaClient;

// Initialize the Cartesia client with your API key
$client = new CartesiaClient('your_api_key');

// Define the speech synthesis parameters
$modelId = 'sonic-english'; // Voice model ID
$transcript = 'Hello, world!'; // Text to be converted to speech
$voiceId = 'a0e99841-438c-4a64-b679-ae501e7d6091'; // Cloned voice ID

// Make a speech synthesis request
try {
    $response = $client->streamSpeechBytes([
        'context_id' => 'happy-monkeys-fly',
        'model_id' => $modelId,
        'transcript' => $transcript,
        'voice' => [
            'mode' => 'id',
            'id' => $voiceId
        ],
        'output_format' => [
            'container' => 'raw',
            'encoding' => 'pcm_f32le',
            'sample_rate' => 44100
        ]
    ]);

    // Save the generated audio to a file
    file_put_contents('hello_world.wav', $response->getBody());

    echo "Audio successfully generated at hello_world.wav\n";
} catch (Exception $e) {
    echo 'Error: ' . $e->getMessage() . "\n";
}

路线图

• API状态和版本
• 创建语音
• 删除语音
• 更新语音
• 获取语音
• 列出语音
• 克隆语音（片段）
• 混合语音
• 流式传输语音（字节）
• 流式传输语音（服务器端事件）
• 流式传输语音（WebSocket）
• 本地化语音

运行示例

要运行examples目录中提供的示例，请将.env.example文件复制到.env，并将CARTESIA_API_KEY常量更新为您的Cartesia API密钥

# .env
CARTESIA_API_KEY=your_api_key

然后，在包根目录中启动PHP服务器

php -S 127.0.0.1:80

现在您可以在浏览器中通过http://127.0.0.1/examples/访问示例。

完整文档

有关所有可用功能和选项的详细信息，请参阅原始REST API文档：https://docs.cartesia.ai。

有关完整源代码和示例，请访问GitHub存储库：https://github.com/lucianotonet/cartesia-php

支持

如果您遇到任何问题或对库有任何疑问，请随时在GitHub上打开一个问题。对项目的贡献也受欢迎！