Conclusões de chat comuns

API de chat unificada para alternar modelos de texto pelo parâmetro model. O formato da requisição é compatível com OpenAI Chat Completions.

O Claude Sonnet 4.6 (claude-sonnet-4-6) é suportado pelo fornecedor, mas não está publicado atualmente na RequestBeam. Não é o padrão de uma integração ativa. Antes de chamar qualquer modelo, confirme o acesso com sua própria resposta de GET https://api.apihop.ai/v1/models.

Este endpoint retorna uma resposta JSON completa por padrão. Defina stream: true explicitamente quando precisar de streaming SSE.

POST https://api.apihop.ai/v1/chat-completions

Autenticação

Todas as requisições exigem autenticação com token Bearer.

Authorization: Bearer YOUR_API_KEY

Se a autenticação falhar, verifique:

• Se a chave de API está correta
• Se a chave é válida para esta URL base da API
• Se o cabeçalho da requisição está escrito corretamente
• Se um proxy reescreve o cabeçalho de autorização

Corpo da requisição

  [
    {"role": "system", "content": "You are a helpful Python tutor."},
    {"role": "user", "content": "How should I learn programming?"}
  ]

Limites de amostragem específicos do modelo: gpt-6-astra não aceita os campos antigos temperature, top_p ou top_logprobs; omita-os mesmo quando um cliente antigo os inclui. O Playground GPT-6 Astra da RequestBeam também oculta os controles antigos de amostragem e penalidade. claude-sonnet-5 rejeitou top_p em uma reverificação de integração documentada, portanto omita-o também nesse modelo. Encaminhar um campo opcional por um proxy não comprova que o modelo do provedor escolhido o suporte.

Diferenças de parâmetros entre modelos

Os modelos de texto atuais suportam requisições Chat mínimas com e sem streaming, mas aceitação e efeitos de parâmetros opcionais variam conforme o modelo escolhido e sua implementação de compatibilidade.

A reverificação mais recente, em 2026-09-26, aceitou claude-fable-5 com temperature: 0 e retornou texto. A mesma verificação rejeitou claude-sonnet-5 com top_p: 0.9, retornando HTTP 400 e top_p is deprecated. Omita top_p nesse modelo. Aceitação não comprova efeito na amostragem nem garante outros modelos ou requisições futuras; não presuma que todos os parâmetros de amostragem sejam suportados.

As verificações OpenAI de 2026-09-26 aceitaram stop para gpt-5.6-sol e gpt-5.6-terra. A aceitação de parâmetros pode mudar no provedor e não prova que uma sequência de parada seja eficaz.

O encaminhamento Chat nativo compatível com OpenAI preserva top_p e stop na requisição ao provedor. Uma rota que converte Chat em Responses preserva top_p, mas não encaminha stop. Encaminhar um campo não comprova suporte nem efeito no provedor; nenhum dos dois tem garantia válida em todas as rotas da plataforma.

Comece com uma requisição mínima ao trocar de modelo e verifique amostragem, sequências de parada e parâmetros avançados de ferramentas separadamente. Para sequências de parada, inspecione o texto real e o motivo da parada, não apenas o status HTTP. HTTP 200 não comprova efeito de amostragem. Os orçamentos de saída devem cobrir o raciocínio e o texto final do modelo.

Exemplo de requisição

{
  "model": "gpt-5.4",
  "messages": [
    {
      "role": "user",
      "content": "Hello, introduce yourself briefly."
    }
  ],
  "stream": false
}

Resposta

Exemplo de sucesso

{
  "id": "chatcmpl-9876543210",
  "object": "chat.completion",
  "created": 1677652288,
  "model": "gpt-5.4",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "I am an AI assistant that can help with writing, coding, and analysis."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 28,
    "completion_tokens": 42,
    "total_tokens": 70
  }
}

Resposta de erro

Consulte Códigos de erro e solução de problemas para a referência completa, diferenças de protocolo e etapas de diagnóstico.

Erros HTTP de Chat Completions usam um corpo JSON plano, incluindo erros HTTP do provedor retornados antes do início de um stream SSE. Por exemplo, HTTP 402 retorna:

{
  "code": 40000,
  "message": "Insufficient credit. Required: 30000, Available: 20000",
  "type": "api_error"
}

• code: código numérico de erro da plataforma, separado do status HTTP e não uma string
• message: descrição legível do erro
• type: api_error
• requestId: identificador opcional da requisição para diagnóstico

Verifique primeiro o status HTTP para determinar se a requisição foi bem-sucedida e depois compare o code numérico para o tratamento específico da aplicação. Não compare code com strings como "400", não presuma que seja igual ao status HTTP nem interprete message como identificador estável do erro. messages ausente ou com tipo incorreto é rejeitado com HTTP 400 e code: 10000 antes de chamar o provedor.

Este formato de erro se aplica a respostas HTTP de Chat Completions, não a erros em um stream SSE já iniciado ou em outros protocolos API. O catálogo de modelos e endpoints de protocolos nativos têm seus próprios formatos de erro documentados.