Salta al contenuto
GetAPI
Italiano
Menu

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.
powershell
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade openai

Configurare e inviare

  1. Impostare GETAPI_ONE_API_KEY nell'ambiente; non incollare chiave nel file.
  2. Creare client con https://www.getapi.one/v1 come base_url.
  3. Sostituire segnaposto evidente con ID esatto attuale Responses.
  4. Eseguire script solo accettando eventuale addebito.
  5. Prima verifica senza tentativi SDK. Aggiungere solo ripetizioni limitate e osservabili dopo aver deciso operazioni sicure.
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)

Comprendere il contratto

CampoValore richiesto
base_urlhttps://www.getapi.one/v1
api_keyGETAPI_ONE_API_KEY dall'ambiente server
modelID esatto del catalogo attuale
methodclient.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

SintomoControllo
401 o errore autenticazioneRicopiare chiave ONE, confermare abilitazione e variabile del processo.
404Mantenere esattamente un /v1 in base_url e usare Responses solo per modello che lo dichiari.
Modello non disponibile o incompatibileRicopiare 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