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

# تحويل النص إلى كلام (TTS)

> استدعِ /audio/speech باستخدام SDK PHP.

**الطريقة**: `$client->createSpeech(...)`

### مثال

```php theme={null}
<?php

require 'vendor/autoload.php';

use Phaseo\Sdk\Phaseo;

$client = new Phaseo(getenv('PHASEO_API_KEY'));
$audioFile = $client->createSpeech([
    'model' => 'openai/gpt-4o-mini-tts',
    'input' => 'Hello world',
    'voice' => 'alloy',
    'format' => 'mp3'
]);
file_put_contents('output.mp3', $audioFile->fread($audioFile->getSize()));
```

### المعلمات الأساسية

* `model` (مطلوب): معرّف نموذج يدعم تحويل النص إلى كلام.
* `input` (مطلوب): النص المطلوب تحويله إلى كلام.
* `voice`: إعداد صوتي مسبق (يعتمد على النموذج، مثل `alloy`).
* `format`: ‏`mp3` و`wav` و`flac` وغيرها.
* `speed`: معامل سرعة التشغيل (عادةً من 0.25 إلى 4).

### القيمة المعادة

بيانات صوتية ثنائية (`\SplFileObject`)


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