Inviare una richiesta API GetAPI.ONE

Prerequisiti e limiti

• Chiave GetAPI.ONE limitata in GETAPI_ONE_API_KEY.
• Modello attuale che elenchi esplicitamente l'endpoint desiderato.
• Riga di comando con curl e HTTPS in uscita consentito verso www.getapi.one.
• Accettazione di possibili costi reali. Gli esempi sono stati revisionati senza richieste ai modelli.

• Creare e caricare una chiave
• Scegliere un modello compatibile

1. Scegliere l'endpoint dichiarato

Altri protocolli usano percorsi e corpi diversi. Seguire l'endpoint della pagina modello; non adattare Anthropic, Gemini, immagini o video ai due esempi precedenti.

2. Esempio API Responses

Usare solo dopo aver scelto un modello con Responses. Sostituire YOUR_RESPONSES_MODEL prima di eseguire.

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. Esempio Chat Completions

Usare solo se il modello scelto elenca OpenAI Chat. Sostituire YOUR_CHAT_MODEL prima di eseguire.

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. Controllare il risultato

1. Leggere prima lo stato HTTP. 2xx significa che il gateway ha accettato e completato la richiesta HTTP, ma il client deve ancora verificare l'output previsto nell'oggetto risposta.
2. Per Responses controllare stato/struttura output. Per Chat Completions controllare choices. Non presumere lo stesso formato nei due protocolli.
3. Aprire registri GetAPI.ONE e confrontare ora, endpoint, modello e ID quando disponibile.

Streaming e nuovi tentativi

Streaming cambia trasporto e gestione eventi; dipende da endpoint e modello. Iniziare senza streaming e consultare protocollo e pagina modello prima di aggiungere parametri stream.

• Non ripetere automaticamente errori di autenticazione, quota, permessi o selezione modello.
• Prima di ripetere timeout o errori del fornitore, determinare se la richiesta originale è stata elaborata e se ripeterla è sicuro.
• Limitare tentativi e applicare attese progressive; preservare ID e orari per diagnosi.

Rami di errore

• Lista diagnostica
• Preparare un rapporto di assistenza