Compatibility Notes

Known compatibility behavior for clients, tools, and upstream-specific APIs.

Pass-through routes

The /v1/*, /v1beta/*, /gemini/*, and selected /openai/* routes are proxy surfaces. OneRouter validates the key, forwards the request, records metadata/usage, and returns the upstream response. If an upstream-specific route changes, the exact response shape can change too.

Avoid unsupported assumptions

Only use file storage, task polling, routing parameters, or callbacks when the relevant API page documents them. A job ID or media URL returned by one model does not imply that every model supports the same task workflow.