Endpoint dan Pembolehubah Persekitaran Gerbang AI

Selain menggunakan Pengambilalihan Satu Klik untuk alat AI sedia ada, anda juga boleh memanggil Gerbang AI secara terus dalam aplikasi, skrip atau mana-mana alat AI anda sendiri. Artikel ini memperkenalkan format endpoint yang didedahkan oleh gerbang, serta cara menyambung menggunakan kunci maya.

Endpoint Proksi

Perkhidmatan proksi Gerbang AI mendengar pada http://127.0.0.1:11580. Untuk keserasian dengan SDK dan alat daripada penyedia berbeza, gerbang menyediakan endpoint dalam pelbagai format protokol pada port yang sama:

Format Protokol	Laluan Endpoint	Senario Penggunaan
Serasi OpenAI	http://127.0.0.1:11580/v1	Mana-mana SDK / alat yang menggunakan format OpenAI API (contohnya /v1/chat/completions)
Serasi Anthropic	http://127.0.0.1:11580/v1/messages	Anthropic SDK, Claude Code, dll.
Serasi Gemini	http://127.0.0.1:11580/v1beta	Google Gemini SDK, dll.

Anda hanya perlu memilih format yang sepadan mengikut protokol SDK yang digunakan, dan menghalakan permintaan ke alamat gerbang. Gerbang akan menghalakan permintaan ke saluran penyedia yang sepadan berdasarkan kebenaran kunci maya.

Pengesahan: Menggunakan Kunci Maya

Semua permintaan ke gerbang disahkan menggunakan kunci maya, bukan kunci sebenar penyedia. Sila cipta kunci maya terlebih dahulu di halaman Kunci dan salin plaintextnya.

Pada halaman Gerbang AI → Endpoint (Endpoints), anda boleh memilih kunci maya, dan gerbang akan menjana snippet pembolehubah persekitaran yang boleh disalin untuk alat biasa.

Contoh Pembolehubah Persekitaran

Contoh di bawah menganggap anda sudah memperoleh kunci maya (dinyatakan sebagai <你的虚拟密钥>, iaitu kunci maya anda).

SDK / Alat Serasi OpenAI

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

Claude Code / Anthropic

# Nota: Protokol Anthropic menggunakan alamat akar gerbang, tanpa /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="<你的虚拟密钥>"

Contoh Panggilan (Serasi 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": "你好"}]
  }'

Di sini, model mestilah model yang telah anda konfigurasikan dalam saluran dan yang dibenarkan untuk dipanggil oleh kunci maya tersebut.

Prasyarat

• Perkhidmatan proksi Gerbang AI sedang berjalan.
• Sekurang-kurangnya satu saluran yang sihat telah dikonfigurasikan, dan kunci maya dengan kebenaran model / saluran yang berkaitan telah dicipta.

Soalan Lazim (FAQ)

• S: Permintaan mengembalikan kegagalan pengesahan?
  • J: Pastikan anda menggunakan kunci maya (bukan kunci sebenar penyedia), dan kunci itu belum tamat tempoh serta belum dibatalkan.
• S: Model tidak tersedia atau tiada kebenaran?
  • J: Pastikan model tersebut telah dikonfigurasikan dalam sesuatu saluran, dan 'Model / Saluran Dibenarkan' pada kunci maya semasa merangkuminya.
• S: Format endpoint manakah yang patut digunakan?
  • J: Pilih mengikut protokol SDK yang anda gunakan—gaya OpenAI guna /v1, gaya Anthropic guna /v1/messages (Base URL tanpa /v1), gaya Gemini guna /v1beta.
• S: Bolehkah peranti lain dalam LAN mengakses gerbang?
  • J: Secara lalai gerbang hanya mendengar pada 127.0.0.1 (mesin tempatan sahaja). Ini ialah tetapan yang disyorkan atas sebab keselamatan.

Kesimpulan

Gerbang AI menyediakan endpoint tempatan yang bersatu dalam tiga format serasi OpenAI / Anthropic / Gemini. Dengan pengesahan kunci maya, anda boleh menyambungkan mana-mana aplikasi atau alat AI ke gerbang, dan menikmati pengurusan kunci serta statistik penggunaan yang bersatu. Untuk alat CLI biasa, menggunakan Pengambilalihan Satu Klik secara terus adalah lebih mudah.