mirror of
https://github.com/Finesssee/ProxyPilot.git
synced 2026-11-19 02:17:46 +00:00
1.7 KiB
1.7 KiB
Compatibility Matrix (Quick Reference)
This project proxies multiple “OpenAI-compatible” clients to multiple upstreams. Small schema differences matter.
Clients
Codex CLI (codex_cli_rs/...)
- Endpoint:
POST /v1/responses - Streaming: SSE (
text/event-stream) - Notes:
data: [DONE]sentinel is tolerated/expected by many Codex/OpenAI clients.- Response output ordering and
output_textfields must be stable.
Droid / Factory CLI (factory-cli/..., Stainless headers)
- Endpoint:
POST /v1/responses - Streaming behavior:
- Sends
stream: truebut typically usesAccept: application/json - CLIProxyAPI uses a non-stream upstream call and synthesizes SSE for reliability.
- Sends
- Notes:
- Droid attempts to JSON-parse each SSE
data:line, sodata: [DONE]must not be emitted for this client.
- Droid attempts to JSON-parse each SSE
Upstreams
Antigravity (cloudcode-pa.googleapis.com)
- Endpoints:
v1internal:generateContent(non-stream)v1internal:streamGenerateContent?alt=sse(stream)
- Notes:
request.contents[].parts[].textmust be a string ("text":"..."), not an object.
Model routing rules
gemini-3-pro* provider preference
- Primary:
antigravity - Fallback:
gemini-cli(only used if antigravity is unavailable/cooling) - Rotation: disabled between these two providers to keep the primary stable.
Regression tests
- Droid SSE parsing:
sdk/api/handlers/openai/openai_responses_handlers_sse_done_test.go - Codex SSE done sentinel:
sdk/api/handlers/openai/openai_responses_handlers_sse_json_compat_test.go - Antigravity request shape:
internal/runtime/executor/antigravity_executor_shape_test.go - Gemini-3-pro provider ordering:
internal/util/provider_test.goandsdk/cliproxy/auth/provider_rotation_test.go