Migrate an application to FlyRouter
Move one application or API key at a time, verify its protocol and model IDs, and compare actual request records before increasing traffic. A shared SDK format does not guarantee every provider-specific feature behaves identically.
Updated:
Inventory before changing the endpoint
Record the current endpoint, SDK version, model ID, streaming mode, tools, structured output, image inputs, timeouts and retries. Keep the previous configuration available for rollback. Do not copy production credentials into public examples.
Match the protocol
| Application protocol | FlyRouter base URL | Guide |
|---|---|---|
| OpenAI Chat Completions / Responses | https://api.flyrouter.ai/v1 | Quickstart |
| Anthropic Messages | https://api.flyrouter.ai | Claude Code |
| Gemini native | https://api.flyrouter.ai | API reference |
Use the exact ID in the pricing directory. A name accepted by another gateway may be an alias that is not accepted here. Configure the API key in an environment variable or your secret manager.
Validate a small set of requests
- Send a short text request and inspect status, model ID and usage.
- Test streaming and cancellation if your app uses them.
- Test tool calls and structured output against your actual schema, not only a greeting prompt.
- Test image input and caching separately when required.
- Check the console deduction and retry behavior. Ensure your application does not retry indefinitely.
Record the client version and date with each result. Mark untested features as untested; a successful text request is not evidence that all agent features work.
Move traffic and keep rollback available
Start with a small workload and watch errors, completion quality, latency and total cost. Keep the old endpoint and model mapping as a configuration option. If a required feature fails, stop increasing traffic and use the previous configuration while investigating.
Use errors and retries, token cost reconciliation and service metrics for evaluation. No automatic failover between providers is implied by this migration process.