Pular para conteúdo
GetAPI
Português (Brasil)
Menu

GetAPI.ONE

Chamar GetAPI.ONE com Python

Instale SDK Python oficial OpenAI, aponte para a base ONE, faça uma solicitação Responses controlada e verifique sem inserir credenciais no código.

Preparar projeto e credencial

  • Python 3.10 ou posterior e ambiente virtual.
  • Chave API GetAPI.ONE habilitada com validade e cota deliberadas.
  • ID copiado do catálogo atual com endpoint declarado Responses.
powershell
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade openai

Configurar e enviar a solicitação

  1. Defina GETAPI_ONE_API_KEY no ambiente; não cole a chave no arquivo.
  2. Crie o cliente com https://www.getapi.one/v1 como base_url.
  3. Troque o marcador evidente por ID exato atual que declare Responses.
  4. Execute o script somente ao aceitar possível cobrança.
  5. A primeira verificação desativa repetições do SDK. Adicione apenas tentativas limitadas e observáveis após decidir o que pode ser repetido com segurança.
python main.py
import os
from openai import OpenAI

api_key = os.environ.get("GETAPI_ONE_API_KEY")
if not api_key:
    raise RuntimeError("Set GETAPI_ONE_API_KEY before running this program")

with OpenAI(
    api_key=api_key,
    base_url="https://www.getapi.one/v1",
    timeout=30.0,
    max_retries=0,
) as client:
    response = client.responses.create(
        model="<MODEL_ID_FROM_CURRENT_CATALOG>",
        input="Reply with one short readiness check.",
    )
    print(response.output_text)

Entender o contrato

CampoValor necessário
base_urlhttps://www.getapi.one/v1
api_keyGETAPI_ONE_API_KEY do ambiente servidor
modelID exato do catálogo atual
methodclient.responses.create

Verificar o resultado esperado

  • O processo termina sem erro de autenticação ou endpoint.
  • response.output_text contém a resposta curta solicitada.
  • O console GetAPI.ONE mostra registro correspondente da chave.

Corrigir erros comuns

SintomaVerificação
401 ou erro de autenticaçãoCopie novamente a chave ONE, confira habilitação e se a variável pertence ao processo.
404Mantenha exatamente um /v1 em base_url e use Responses somente com modelo que declare o endpoint.
Modelo indisponível ou incompatívelCopie novamente o ID exato atual; não deduza aliases.

Manter a integração segura

  • Execute SDK somente em código de servidor ou ferramenta local confiável, nunca JavaScript de navegador.
  • Exclua .env do controle de versão e rote imediatamente uma chave exposta.
  • Use chaves separadas e limitadas em desenvolvimento e produção.

Próximos passos