Skip to main content

Codex

Halakan Codex ke Responses API gerbang. Halaman ini ialah lakaran konfigurasi. Tahap pengesahan klien bagi laluan ini ialah larian hujung ke hujung CLI Codex mock (TestResponses_CodexCLI_MockE2E); binari Codex secara langsung belum dijalankan terhadap gerbang (not verified dalam matriks keserasian) — ia kekal sebagai stand pemilik.

Konfigurasi​

~/.codex/config.toml:

[model_providers.yabanin]
name = "Yabanin"
base_url = "https://gateway.example.internal/v1"
env_key = "YABANIN_API_KEY"
wire_api = "responses"

Letakkan kunci dalam persekitaran, bukan dalam file:

export YABANIN_API_KEY='yb_…'

Endpoint​

POST /v1/responses. Apabila penyedia yang diselesaikan ialah openai dan organisasi tidak mempunyai dasar penafian alat, gerbang memajukan badan tanpa perubahan. Jika tidak, ia menterjemah panggilan itu kepada chat completions.

Bawa kunci penyedia anda sendiri (BYOK)​

Pentadbir organisasi anda menambah kunci penyedia huluan sekali dalam konsol pentadbir (Tetapan → Kunci penyedia — lihat BYOK). Apabila model dihalakan melalui kelayakan organisasi, klien tidak memerlukan perubahan: kekalkan kunci gerbang yb_… di atas dan gerbang mengesahkan ke huluan dengan kunci organisasi.

Had​

  • Model sesi tanpa keadaan (R046 D1): gerbang tidak menyimpan keadaan respons pada mana-mana laluan. previous_response_id ditolak dengan 400 di mana-mana — hantar semula sejarah penuh Codex (store=false) ialah aliran yang disokong.
  • Medan yang terjemahan tidak dapat wakili (reasoning.effort, verbosity, alat yang tidak disokong, …) digugurkan dan diumumkan dalam pengepala respons X-Yabanin-Unsupported — tidak pernah secara senyap.
  • Putus strim (R046-03): jika strim huluan terputus di tengah respons, gerbang menambah peristiwa SSE response.failed, merekod request.failed dan tidak mengenakan caj bagi strim yang terganggu; pemutusan oleh klien mengekalkan caj bagi awalan yang telah digunakan (request.completed). Penghujung yang bersih selepas peristiwa terminal kekal request.completed.
  • Permukaan pengesahan: kunci pembawa API (yb_…) sahaja. Log masuk ChatGPT-OAuth Codex (codex login) tidak disokong; konfigurasikan env_key seperti ditunjukkan di atas.
  • Pengesahan klien: codex exec sebenar (codex-cli 0.162.1) disahkan terhadap gerbang dengan huluan mock (2026-10-18, R046-05); larian huluan berbayar secara langsung ialah stand pemilik yang berasingan.

Semak​

curl -sS -o /dev/null -w '%{http_code}\n' \
-H "Authorization: Bearer $YABANIN_API_KEY" \
https://gateway.example.internal/v1/models

200 bermaksud gerbang menerima kunci. Ia tidak memulakan Codex.