SDK PHP (Laravel و openai-php)

composer require openai-php/client guzzlehttp/guzzle

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

$client = OpenAI::factory()
    ->withBaseUri('https://api.uttapen.ir/v1')
    ->withApiKey(getenv('UTTAPEN_API_KEY'))   // sk-up-...
    ->make();

OPENAI_API_KEY=sk-up-...
OPENAI_BASE_URL=https://api.uttapen.ir/v1

$result = $client->chat()->create([
    'model' => 'openai/gpt-5-mini',
    'messages' => [
        ['role' => 'system', 'content' => 'پاسخ کوتاه و فارسی بده.'],
        ['role' => 'user', 'content' => 'تفاوت Eloquent و Query Builder چیست؟'],
    ],
    'max_tokens' => 300,
]);

echo $result->choices[0]->message->content, PHP_EOL;
echo $result->usage->promptTokens, '/', $result->usage->completionTokens, PHP_EOL;

// هدرهای هزینه
$headers = $result->meta()->toArray()['custom'];
echo $headers['x-uttapen-cost-toman'], ' تومان — موجودی ', $headers['x-uttapen-balance-toman'], PHP_EOL;

$stream = $client->chat()->createStreamed([
    'model' => 'openai/gpt-5-mini',
    'messages' => [['role' => 'user', 'content' => 'یک کلاس Validator برای کد ملی بنویس.']],
]);

foreach ($stream as $response) {
    echo $response->choices[0]->delta->content ?? '';
    flush();
}

$http = new \GuzzleHttp\Client(['base_uri' => 'https://api.uttapen.ir/v1/']);
$res = $http->post('chat/completions', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('UTTAPEN_API_KEY'),
        'X-Uttapen-Include-Meta' => '1',
    ],
    'json' => ['model' => 'openai/gpt-5-mini', 'messages' => [['role' => 'user', 'content' => 'سلام']], 'stream' => true],
    'stream' => true,
]);

$body = $res->getBody();
$buffer = '';
while (!$body->eof()) {
    $buffer .= $body->read(1024);
    while (($pos = strpos($buffer, "\n\n")) !== false) {
        $event = substr($buffer, 0, $pos);
        $buffer = substr($buffer, $pos + 2);
        if (!str_starts_with($event, 'data: ')) continue;
        $payload = substr($event, 6);
        if ($payload === '[DONE]') break 2;
        $json = json_decode($payload, true);
        if (($json['object'] ?? '') === 'uttapen.meta') {
            echo "\n[هزینه: {$json['cost_toman']} تومان]\n";
        } else {
            echo $json['choices'][0]['delta']['content'] ?? '';
        }
    }
}

$tools = [[
    'type' => 'function',
    'function' => [
        'name' => 'get_weather',
        'description' => 'دمای فعلی یک شهر',
        'parameters' => ['type' => 'object', 'properties' => ['city' => ['type' => 'string']], 'required' => ['city']],
    ],
]];

$messages = [['role' => 'user', 'content' => 'هوای تهران؟']];
$r1 = $client->chat()->create(['model' => 'openai/gpt-5-mini', 'messages' => $messages, 'tools' => $tools]);
$msg = $r1->choices[0]->message;
$messages[] = $msg->toArray();

foreach ($msg->toolCalls as $call) {
    $args = json_decode($call->function->arguments, true);
    $messages[] = [
        'role' => 'tool',
        'tool_call_id' => $call->id,
        'content' => json_encode(['city' => $args['city'], 'temp_c' => 31], JSON_UNESCAPED_UNICODE),
    ];
}
$r2 = $client->chat()->create(['model' => 'openai/gpt-5-mini', 'messages' => $messages, 'tools' => $tools]);
echo $r2->choices[0]->message->content;

$emb = $client->embeddings()->create([
    'model' => 'openai/text-embedding-3-small',
    'input' => ['قرارداد اجاره', 'اجاره‌نامهٔ ملک مسکونی'],
]);
foreach ($emb->embeddings as $item) {
    echo $item->index, ': ', count($item->embedding), ' بعد', PHP_EOL;
}

use OpenAI\Exceptions\ErrorException;
use OpenAI\Exceptions\TransporterException;

try {
    $result = $client->chat()->create(['model' => 'openai/gpt-5-mini', 'messages' => $messages]);
} catch (ErrorException $e) {
    match ($e->getStatusCode()) {
        401 => Log::error('کلید uttapen نامعتبر است'),
        402 => Log::warning('موجودی کافی نیست: ' . $e->getMessage()),
        429 => sleep(5),
        default => Log::error("{$e->getStatusCode()} {$e->getErrorCode()}: {$e->getMessage()}"),
    };
} catch (TransporterException $e) {
    Log::error('اتصال به uttapen برقرار نشد: ' . $e->getMessage());
}

class SummarizeDocument implements ShouldQueue
{
    public int $timeout = 300;
    public int $tries = 2;

    public function handle(): void
    {
        $result = OpenAI::chat()->create([
            'model' => 'anthropic/claude-sonnet-4.5',
            'messages' => [['role' => 'user', 'content' => $this->text]],
            'max_tokens' => 1500,
        ]);
        $requestId = $result->meta()->toArray()['custom']['x-uttapen-request-id'] ?? null;
        $this->document->update(['summary' => $result->choices[0]->message->content, 'llm_request_id' => $requestId]);
    }
}