GetAPI.ONE
Chiamare GetAPI.ONE da Python
Installare SDK Python ufficiale, impostare base ONE, fare richiesta Responses controllata e verificare senza credenziali nel codice.
Preparare progetto e credenziale
- Python 3.10 o successivo e ambiente virtuale.
- Chiave GetAPI.ONE abilitata con scadenza e quota deliberate.
- ID copiato dal catalogo attuale con Responses dichiarato.
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade openaiConfigurare e inviare
- Impostare GETAPI_ONE_API_KEY nell'ambiente; non incollare chiave nel file.
- Creare client con https://www.getapi.one/v1 come base_url.
- Sostituire segnaposto evidente con ID esatto attuale Responses.
- Eseguire script solo accettando eventuale addebito.
- Prima verifica senza tentativi SDK. Aggiungere solo ripetizioni limitate e osservabili dopo aver deciso operazioni sicure.
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)Comprendere il contratto
| Campo | Valore richiesto |
|---|---|
| base_url | https://www.getapi.one/v1 |
| api_key | GETAPI_ONE_API_KEY dall'ambiente server |
| model | ID esatto del catalogo attuale |
| method | client.responses.create |
Verificare il risultato previsto
- Processo termina senza errori autenticazione o endpoint.
- response.output_text contiene risposta breve richiesta.
- Console GetAPI.ONE mostra registro corrispondente della chiave.
Correggere errori comuni
| Sintomo | Controllo |
|---|---|
| 401 o errore autenticazione | Ricopiare chiave ONE, confermare abilitazione e variabile del processo. |
| 404 | Mantenere esattamente un /v1 in base_url e usare Responses solo per modello che lo dichiari. |
| Modello non disponibile o incompatibile | Ricopiare ID esatto attuale, senza dedurre alias. |
Mantenere l'integrazione sicura
- Eseguire SDK solo in server o strumenti locali affidabili, mai JavaScript browser.
- Escludere .env dal controllo versione e ruotare subito chiavi esposte.
- Usare chiavi limitate separate per sviluppo e produzione.
Passaggi successivi
- Ricevere una risposta in streamingGestire eventi SSE ed esiti terminali.
- Scegliere un modelloAllineare compito al contratto endpoint.