Bỏ qua để đến nội dung

Protocol conversion

Page này document Codex route dùng bởi Codex Desktop và Codex CLI. VS Code cũng được hỗ trợ, và chúng tôi đang bổ sung thêm agent; mỗi route dùng cùng mô hình chuyển đổi này.

Local proxy của Nexus Composer convert Codex request sang protocol mà upstream provider được chọn hỗ trợ — conversion diễn ra trong suốt: client vẫn dùng native API và không cần request code riêng cho từng provider.

Composer route mỗi request tới một upstream provider, dựa trên active route và model đã chọn. Chuyển provider chỉ đổi destination cho các request tiếp theo — Composer không fan out, mirror hay gửi cùng request tới cả OpenAI Official và OneNexus để so sánh.

Protocol surfaces

Phần tiêu đề “Protocol surfaces”

Local proxy nhận request từ Codex và gửi theo format của upstream đang được chọn:

  • OpenAI Responses — /v1/responses, giữ nguyên reasoning item và encrypted reasoning state để resume session.
  • OpenAI Chat Completions — upstream format cho model do OneNexus host; Codex Responses request được convert sang đó, tool call map theo cả hai chiều.

Conversion notes

Phần tiêu đề “Conversion notes”
  • Codex — field store và previous_response_id được theo dõi trong một shared session store, nên conversation có thể tiếp tục trên backend kia bất kể bắt đầu từ đâu; đổi provider không xóa session hay bắt bạn gửi lại history.

Example

Phần tiêu đề “Example”

Một Codex Responses request sau khi được convert sang Chat Completions format để gửi tới upstream:

{
  "model": "glm-5.3",
  "max_tokens": 65536,
  "messages": [
    { "role": "system", "content": "You are a helpful assistant." },
    { "role": "user", "content": "Refactor the retry loop to use backoff." }
  ]
}