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.
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade openaiConfigurar e enviar a solicitação
- Defina GETAPI_ONE_API_KEY no ambiente; não cole a chave no arquivo.
- Crie o cliente com https://www.getapi.one/v1 como base_url.
- Troque o marcador evidente por ID exato atual que declare Responses.
- Execute o script somente ao aceitar possível cobrança.
- 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.
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
| Campo | Valor necessário |
|---|---|
| base_url | https://www.getapi.one/v1 |
| api_key | GETAPI_ONE_API_KEY do ambiente servidor |
| model | ID exato do catálogo atual |
| method | client.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
| Sintoma | Verificação |
|---|---|
| 401 ou erro de autenticação | Copie novamente a chave ONE, confira habilitação e se a variável pertence ao processo. |
| 404 | Mantenha exatamente um /v1 em base_url e use Responses somente com modelo que declare o endpoint. |
| Modelo indisponível ou incompatível | Copie 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
- Receber uma resposta por streamingTrate eventos de ciclo SSE e resultados terminais.
- Escolher um modeloAlinhe a tarefa ao contrato do endpoint.