Endpoint e variabili d'ambiente del gateway AI

Oltre a acquisizione con un clic per gli strumenti AI già pronti, puoi anche chiamare direttamente il gateway AI nelle tue applicazioni, script o in qualsiasi strumento AI. Questo articolo presenta i formati di endpoint esposti dal gateway e come accedere utilizzando chiavi virtuali.

Endpoint proxy

Il servizio proxy del gateway AI è in ascolto su http://127.0.0.1:11580. Per compatibilità con SDK e strumenti di diversi fornitori, il gateway offre endpoint in diversi formati di protocollo sulla stessa porta:

Formato protocollo	Percorso endpoint	Scenario applicativo
Compatibile OpenAI	http://127.0.0.1:11580/v1	Qualsiasi SDK / strumento che utilizza il formato API OpenAI (es. /v1/chat/completions)
Compatibile Anthropic	http://127.0.0.1:11580/v1/messages	SDK Anthropic e Claude Code, ecc.
Compatibile Gemini	http://127.0.0.1:11580/v1beta	SDK Google Gemini, ecc.

Devi solo scegliere il formato corrispondente in base al protocollo dell'SDK che utilizzi e indirizzare le richieste all'indirizzo del gateway; il gateway instrada le richieste al canale del fornitore corrispondente in base ai permessi della chiave virtuale.

Autenticazione: utilizzo di chiavi virtuali

Tutte le richieste al gateway vengono autenticate utilizzando una chiave virtuale, non la chiave reale del fornitore. Crea prima una chiave virtuale nella pagina Chiavi e copia il relativo testo in chiaro.

Nella pagina Gateway AI → Endpoint, puoi selezionare una chiave virtuale; il gateway genera direttamente frammenti di variabili d'ambiente copiabili per gli strumenti più comuni.

Esempio di variabili d'ambiente

Gli esempi seguenti presuppongono che tu abbia già ottenuto una chiave virtuale (indicata come <你的虚拟密钥>).

SDK / strumenti compatibili OpenAI

export OPENAI_BASE_URL="http://127.0.0.1:11580/v1"
export OPENAI_API_KEY="<你的虚拟密钥>"

Claude Code / Anthropic

# Nota: il protocollo Anthropic utilizza l'indirizzo radice del gateway, senza /v1
export ANTHROPIC_BASE_URL="http://127.0.0.1:11580"
export ANTHROPIC_AUTH_TOKEN="<你的虚拟密钥>"

Gemini

export GOOGLE_GEMINI_BASE_URL="http://127.0.0.1:11580"
export GEMINI_API_KEY="<你的虚拟密钥>"

Esempio di chiamata (compatibile OpenAI)

curl http://127.0.0.1:11580/v1/chat/completions \
  -H "Authorization: Bearer <你的虚拟密钥>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Il parametro model deve essere un modello già configurato nei canali e per il quale la chiave virtuale è autorizzata alla chiamata.

Prerequisiti

• Il servizio proxy del gateway AI è in esecuzione.
• È stato configurato almeno un canale sano ed è stata creata una chiave virtuale con i permessi appropriati per modelli / canali.

Domande frequenti (FAQ)

• D: La richiesta restituisce un errore di autenticazione?
  • R: Verifica di utilizzare una chiave virtuale (non la chiave reale del fornitore) e che la chiave non sia scaduta o revocata.
• D: Viene segnalato che il modello non è disponibile o non si hanno i permessi?
  • R: Verifica che il model sia configurato in un canale e che i «Modelli / canali consentiti» della chiave virtuale corrente lo includano.
• D: Quale formato di endpoint devo usare?
  • R: Scegli in base al protocollo dell'SDK che utilizzi: per lo stile OpenAI usa /v1; per lo stile Anthropic usa /v1/messages (il Base URL non include /v1); per lo stile Gemini usa /v1beta.
• D: Altri dispositivi sulla rete locale possono accedere al gateway?
  • R: Per impostazione predefinita, il gateway è in ascolto solo su 127.0.0.1 (solo macchina locale). Questa è l'impostazione consigliata per motivi di sicurezza.

Riepilogo

Il gateway AI fornisce endpoint locali unificati in tre formati compatibili OpenAI / Anthropic / Gemini. Grazie all'autenticazione tramite chiavi virtuali, puoi collegare qualsiasi applicazione o strumento AI al gateway e beneficiare di una gestione unificata delle chiavi e delle statistiche di utilizzo. Per gli strumenti CLI più comuni, utilizzare direttamente acquisizione con un clic è più semplice.