Enviar uma solicitação API GetAPI.ONE

Pré-requisitos e limites

• Chave GetAPI.ONE limitada armazenada em GETAPI_ONE_API_KEY.
• Modelo atual que liste explicitamente o tipo de endpoint que você deseja chamar.
• Linha de comando com curl instalado e HTTPS de saída permitido para www.getapi.one.
• Aceitação de que uma solicitação real pode gerar cobrança. Os exemplos foram revisados sem enviar solicitações a modelos.

• Criar e carregar uma chave
• Escolher um modelo compatível com o endpoint

1. Escolher o endpoint declarado

Outras famílias de protocolos usam caminhos e corpos diferentes. Siga o endpoint da página do modelo; não adapte chamadas Anthropic, Gemini, de imagem ou vídeo aos dois exemplos acima.

2. Exemplo da API Responses

Use somente após escolher um modelo que liste Responses. Substitua YOUR_RESPONSES_MODEL antes de executar.

curl --fail-with-body https://www.getapi.one/v1/responses \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_RESPONSES_MODEL",
    "input": "Reply with the word ready."
  }'

3. Exemplo de Chat Completions

Use apenas quando o modelo selecionado listar o endpoint OpenAI Chat. Substitua YOUR_CHAT_MODEL antes de executar.

curl --fail-with-body https://www.getapi.one/v1/chat/completions \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_CHAT_MODEL",
    "messages": [
      {"role": "user", "content": "Reply with the word ready."}
    ]
  }'

4. Conferir o resultado

1. Leia primeiro o estado HTTP. Um estado 2xx indica que o gateway aceitou e concluiu a solicitação HTTP, mas o cliente ainda precisa verificar o objeto de resposta e sua saída esperada.
2. Em Responses, examine estado e estrutura de saída. Em Chat Completions, examine a estrutura choices. Não presuma o mesmo formato nos dois protocolos.
3. Abra o registro de solicitações ou uso GetAPI.ONE e confira horário, endpoint, modelo e identificador quando disponível.

Streaming e novas tentativas

Streaming altera o transporte e tratamento de eventos; o suporte depende do endpoint e modelo. Comece sem streaming e consulte a referência do protocolo e a página do modelo antes de adicionar parâmetros stream.

• Não repita automaticamente erros de autenticação, cota, permissão ou seleção de modelo.
• Antes de repetir após tempo limite ou falha do provedor, determine se a solicitação original pode ter sido processada e se é seguro repetir a operação.
• Limite tentativas e use espera progressiva nas aplicações; preserve identificadores e horários para diagnóstico.

Ramificações de erro

• Lista de solução de problemas
• Preparar um relatório de suporte