PHP code example of texhub / openai

    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

texhub / openai example snippets

use TexHub\OpenAI\OpenAI;

$ai = OpenAI::make('sk-...'); // or with org/project: OpenAI::make('sk-...', 'org-...', 'proj-...')

// Simplest possible — just text in, text out:
echo $ai->chat()->text('Объясни квантовую запутанность одним предложением.');

// With a system prompt and options:
$response = $ai->chat()->ask(
    'Напиши слоган для кофейни',
    system: 'Ты креативный копирайтер.',
    options: ['model' => 'gpt-4o', 'temperature' => 0.9],
);
echo $response->content();
echo $response->totalTokens();

use TexHub\OpenAI\Builders\Tool;
use TexHub\OpenAI\Builders\Message;

$response = $ai->chat()->create([
    'messages' => [Message::user('Какая погода в Душанбе?')],
    'tools' => [
        Tool::function('get_weather', 'Получить погоду по городу', Tool::objectSchema(
            properties: ['city' => ['type' => 'string']],
             Душанбе?'),
                $response->message(),
                Message::toolResult($call['id'], json_encode($result)),
            ],
            'tools' => [/* same tools */],
        ]);
        echo $final->content();
    }
}

use TexHub\OpenAI\Builders\Message;

// Remote URL:
$ai->chat()->vision('Что на картинке?', ['https://example.com/photo.jpg']);

// Local file as a data URL:
$ai->chat()->vision('Опиши фото', [Message::imageDataUrl('/path/to/photo.jpg')]);

$json = $ai->chat()->json([Message::user('Верни {"city","country"} для Душанбе')]);

$ai->chat()->streamText('Расскажи историю', function (string $delta) {
    echo $delta; // tokens arrive live
});

use TexHub\OpenAI\Builders\Tool;

// 1) Create a reusable assistant
$assistant = $ai->assistants()->create('gpt-4o', [
    'name' => 'Data Analyst',
    'instructions' => 'Ты аналитик. Отвечай кратко, считай через code interpreter.',
    'tools' => [Tool::codeInterpreter()],
]);

// 2) Create a thread, add a message, run, and wait for completion
$thread = $ai->threads()->create();
$ai->threads()->addMessage($thread->id(), 'Посчитай факториал 10');

$run = $ai->threads()->runAndPoll($thread->id(), $assistant->id());

// 3) Read the assistant's reply
foreach ($ai->threads()->messages($thread->id())->data() as $message) {
    // newest first
}

$ai->threads()->submitToolOutputs($threadId, $runId, [
    ['tool_call_id' => 'call_1', 'output' => json_encode(['result' => 42])],
]);

$file = $ai->files()->upload('/path/to/manual.pdf', purpose: 'assistants');

$ai->files()->list(['purpose' => 'assistants']);
$content = $ai->files()->download($file->id());
$ai->files()->delete($file->id());

// In-memory upload:
$ai->files()->uploadContents($csvString, 'data.csv');

$image = $ai->images()->generate('Кот-космонавт, акварель', 'gpt-image-1', [
    'size' => '1024x1024',
    'n' => 1,
]);

$image->firstUrl();   // when response_format=url
$image->base64();     // when response_format=b64_json

$ai->images()->edit('/path/in.png', 'Добавь радугу', maskPath: '/path/mask.png');
$ai->images()->variation('/path/in.png');

// Speech → text
$ai->audio()->transcribe('/path/voice.mp3', options: ['language' => 'ru'])->get('text');

// Text → speech (returns mp3 bytes, or write to file)
$ai->audio()->speechToFile('Привет, мир!', '/path/out.mp3', voice: 'alloy');

$vector = $ai->embeddings()->vector('текст для поиска');           // array<float>
$flagged = $ai->moderations()->isFlagged('какой-то текст');        // bool

// Per-request token usage is on every response:
$ai->chat()->ask('hi')->usage();        // ['prompt_tokens'=>..,'completion_tokens'=>..,'total_tokens'=>..]

// Org-wide analytics (

use TexHub\OpenAI\Exceptions\ApiException;
use TexHub\OpenAI\Exceptions\TransportException;

try {
    $ai->chat()->text('hi');
} catch (ApiException $e) {
    $e->httpStatus;   // 401, 429, 500, ...
    $e->errorType;    // invalid_request_error, rate_limit_exceeded, ...
    $e->errorCode;    // e.g. invalid_api_key
    $e->isRateLimit(); $e->isRetryable();
} catch (TransportException $e) {
    // network failure
}

$ai->http()->post('moderations', ['input' => 'text', 'model' => 'omni-moderation-latest']);
$ai->http()->get('models');

use TexHub\OpenAI\Laravel\OpenAI;

echo OpenAI::chat()->text('Привет из Laravel!');
OpenAI::assistants()->create('gpt-4o', ['name' => 'Bot']);

use TexHub\OpenAI\OpenAI;
use TexHub\OpenAI\Config;
use TexHub\OpenAI\Tests\Support\FakeTransport;

$t = (new FakeTransport())->push([
    'choices' => [['message' => ['content' => 'Hi!'], 'finish_reason' => 'stop']],
]);
$ai = new OpenAI(new Config('sk-test'), $t);

$ai->chat()->text('hello'); // "Hi!"
// assert on $t->lastJson(), $t->lastHeaders(), $t->lastRequest()

bash
php artisan vendor:publish --tag=openai-config

src/
├── OpenAI.php               # entry — chat()/assistants()/threads()/files()/images()/audio()/…
├── Config.php               # immutable configuration
├── Http/                    # Transport, CurlTransport (JSON/multipart/SSE), HttpClient, FileParam
├── Builders/                # Message (incl. vision), Tool (functions, code_interpreter, file_search)
├── Resources/               # Chat, Responses, Models, Embeddings, Files, Images, Audio,
│                            #   Moderations, Assistants, Threads, Usage
├── Responses/               # Response (ArrayAccess), ChatResponse, ImageResponse, ListResponse
├── Exceptions/              # ApiException, TransportException, ConfigurationException
└── Laravel/                 # ServiceProvider + Facade