Repolode
Enviar
orhanerday

orhanerday/open-ai

Cliente PHP mantido pela comunidade para a REST API da OpenAI, com suporte a streaming e sem dependências de terceiros em tempo de execução.

Ver no GitHub
Estrelas
2,361
Forks
292
Issues abertas
0
Último commit
há 16 dias

O que é?

Esta biblioteca encapsula a REST API da OpenAI para aplicações PHP. Ela oferece métodos dedicados para chat completions, a Responses API, imagens, embeddings, áudio, arquivos, fine-tuning, moderação, vector stores, batches, uploads, sessões realtime, webhooks e relatórios de uso da organização. As requisições usam as extensões nativas cURL e JSON do PHP; por isso, é necessário usar PHP 7.4 ou superior, sem outros pacotes em tempo de execução.

Para endpoints sem um método dedicado, o método genérico request() envia chamadas pelo prefixo de API configurado, com corpos JSON ou multipart. Nas chamadas com streaming, os chunks de server-sent events são enviados para um callback. É possível alterar a URL base e a versão da API, o que permite usar provedores compatíveis com a OpenAI. Também estão disponíveis configurações de proxy, timeout, headers e opções do cURL.

O tratamento de respostas inclui um objeto Response com status, headers e decodificação de JSON, exceções opcionais para erros HTTP e novas tentativas automáticas com backoff exponencial para limites de requisições e determinados erros de servidor.

Recursos principais

  • 01Métodos dedicados para chat, Responses, imagens, embeddings, áudio, arquivos e fine-tuning
  • 02Respostas em streaming entregues por meio de um callback
  • 03Método genérico request() para endpoints REST sem métodos dedicados
  • 04URL base e versão da API configuráveis para provedores compatíveis com a OpenAI
  • 05Novas tentativas automáticas para limites de requisições e determinados erros de servidor
  • 06Verificação de assinatura de webhook

Casos de uso

  • Adicionar chat ou geração de imagens da OpenAI a uma aplicação Laravel, Symfony ou CakePHP
  • Transmitir a saída do modelo para um navegador por meio de server-sent events
  • Chamar provedores compatíveis com a OpenAI usando PHP e alterando a URL base
  • Gerenciar arquivos, batches ou vector stores em scripts PHP de back-office

Início rápido

  1. 1

    Instale a biblioteca com o Composer

    composer require orhanerday/open-ai
  2. 2

    Defina a variável de ambiente OPENAI_API_KEY (Linux ou macOS)

    export OPENAI_API_KEY='your-api-key'
  3. 3

    Salve o exemplo do README como example.php e execute-o

    php example.php

Antes de usar

  • Aviso de segurança do runtime do PHP: CVE-2026-109618 e CVE-2026-109619 afetam o próprio PHP. Portanto, atualize o PHP antes de usar.
  • O modo WebSocket e o direcionamento durante um turno não são compatíveis; é necessário usar um cliente separado.

Em coleções

Ferramentas de streaming

Tópicos

#openai#php#llm#api-client#streaming#sdk#cakephp#dall-e#dalle2#gpt-3

Perguntas frequentes

O que é open-ai?
Cliente PHP mantido pela comunidade para a REST API da OpenAI, com suporte a streaming e sem dependências de terceiros em tempo de execução. Esta biblioteca encapsula a REST API da OpenAI para aplicações PHP. Ela oferece métodos dedicados para chat completions, a Responses API, imagens, embeddings, áudio, arquivos, fine-tuning, moderação, vector stores, batches, uploads, sessões realtime, webhooks e relatórios de uso da organização. As requisições usam as extensões nativas cURL e JSON do PHP; por isso, é necessário usar PHP 7.4 ou superior, sem outros pacotes em tempo de execução.
open-ai é gratuito? Qual é a licença?
open-ai é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
open-ai ainda é mantido?
Manutenção ativa. O último commit de open-ai foi em 21 de out. de 2026.
Para que posso usar open-ai?
Adicionar chat ou geração de imagens da OpenAI a uma aplicação Laravel, Symfony ou CakePHP Transmitir a saída do modelo para um navegador por meio de server-sent events Chamar provedores compatíveis com a OpenAI usando PHP e alterando a URL base Gerenciar arquivos, batches ou vector stores em scripts PHP de back-office
Como instalar open-ai?
Instale a biblioteca com o Composer: composer require orhanerday/open-ai Defina a variável de ambiente OPENAI_API_KEY (Linux ou macOS): export OPENAI_API_KEY='your-api-key' Salve o exemplo do README como example.php e execute-o: php example.php
Onde consigo open-ai?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/orhanerday/open-ai

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados