К содержимому

PHP LLM API: SDK, запрос и обработка ошибок

PHP-клиент OpenAI.

Установка

Установите клиент в проекте и передайте ключ через переменную RELAY_API_KEY среды.

bash
composer require openai-php/client guzzlehttp/guzzle

Первый запрос

Задайте адрес, ключ и идентификатор модели, затем прочитайте текст ответа.

ts
<?php
require __DIR__ . '/vendor/autoload.php';

$client = OpenAI::factory()
    ->withApiKey(getenv('RELAY_API_KEY'))
    ->withBaseUri('https://relay-llm.ru/v1')
    ->make();

$reply = $client->chat()->create([
    'model' => 'gpt-5.6-luna',
    'messages' => [['role' => 'user', 'content' => 'Say hello in one sentence.']],
]);
echo $reply->choices[0]->message->content, PHP_EOL;

Потоковый ответ

Поток показывает текст по мере генерации и сохраняет usage, если протокол его отдаёт.

ts
<?php
require __DIR__ . '/vendor/autoload.php';

$client = OpenAI::factory()
    ->withApiKey(getenv('RELAY_API_KEY'))
    ->withBaseUri('https://relay-llm.ru/v1')
    ->make();

$stream = $client->chat()->createStreamed([
    'model' => 'gpt-5.6-luna',
    'messages' => [['role' => 'user', 'content' => 'Say hello in one sentence.']],
]);
foreach ($stream as $chunk) {
    echo $chunk->choices[0]->delta->content ?? '';
}
echo PHP_EOL;

Ошибки и повторы

Клиент использует ограниченное число повторов и выводит идентификатор запроса при ошибке.

ts
<?php
use OpenAI\Exceptions\ErrorException;
use OpenAI\Exceptions\RateLimitException;

require __DIR__ . '/vendor/autoload.php';

$client = OpenAI::factory()
    ->withApiKey(getenv('RELAY_API_KEY'))
    ->withBaseUri('https://relay-llm.ru/v1')
    ->make();

for ($attempt = 1; ; $attempt++) {
    try {
        $reply = $client->chat()->create([
            'model' => 'gpt-5.6-luna',
            'messages' => [['role' => 'user', 'content' => 'Say hello in one sentence.']],
        ]);
        echo $reply->choices[0]->message->content, PHP_EOL;
        break;
    } catch (RateLimitException $error) {
        if ($attempt === 3) {
            throw $error;
        }
        sleep((int) ($error->response->getHeaderLine('Retry-After') ?: 1));
    } catch (ErrorException $error) {
        fwrite(STDERR, $error->getStatusCode() . ' ' . $error->getErrorMessage() . PHP_EOL);
        exit(1);
    }
}
Исполняемые варианты: 3 из 4.
Готовы? Три шага, чтобы начатьВойдите в консоль · пополните баланс · создайте API Key