API OpenAI — exemplo prático

Pré-requisitos

• Conta OpenAI com billing ou provedor compatível (Azure OpenAI).
• Chave em variável de ambiente — nunca commitar no Git.
• Extensão curl habilitada no PHP.

Exemplo PHP (chat completion)

<?php
declare(strict_types=1);

$apiKey = getenv('OPENAI_API_KEY');
if ($apiKey === false || $apiKey === '') {
    fwrite(STDERR, "Defina OPENAI_API_KEY\n");
    exit(1);
}

$payload = [
    'model'       => 'gpt-4o-mini',
    'temperature' => 0.2,
    'messages'    => [
        [
            'role'    => 'system',
            'content' => 'Responda em português, de forma concisa.',
        ],
        [
            'role'    => 'user',
            'content' => 'Explique o que é embedding em uma frase.',
        ],
    ],
];

$ch = curl_init('https://api.openai.com/v1/chat/completions');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Authorization: Bearer ' . $apiKey,
    ],
    CURLOPT_POSTFIELDS     => json_encode($payload, JSON_THROW_ON_ERROR),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 60,
]);

$response = curl_exec($ch);
$httpCode = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($response === false || $httpCode >= 400) {
    fwrite(STDERR, "Erro HTTP {$httpCode}: {$response}\n");
    exit(1);
}

$data = json_decode($response, true, 512, JSON_THROW_ON_ERROR);
echo $data['choices'][0]['message']['content'] . PHP_EOL;

Boas práticas na integração

• Retry com backoff em erros 429/5xx; limite tentativas.
• Logue request_id da API, não o conteúdo sensível do usuário.
• Streaming (SSE) para respostas longas na UI — melhor UX.
• Cache respostas idênticas quando fizer sentido (FAQ interno).

Alternativas compatíveis

• Azure OpenAI — mesmo formato com endpoint e deployment próprios.
• Ollama local — modelos Llama/Mistral sem enviar dados à nuvem.
• LiteLLM / OpenRouter — proxy unificado para vários provedores.