Do OpenRouter para o FlowModels.
O OpenRouter fala o mesmo formato, então a migração envolve principalmente a URL base, a chave, a grafia dos IDs de modelos e os campos de rotas alternativas.
O que muda
A URL base, a chave e o nome do modelo. Todo o resto continua igual, desde que você não use campos da tabela abaixo.
| Item | Antes | No FlowModels |
|---|---|---|
| URL base | https://openrouter.ai/api/v1 |
https://api.flowmodels.one/v1 |
| Chave | OPENROUTER_API_KEY |
FLOWMODELS_API_KEY |
| Nome do modelo | google/gemini-3.7-flash |
gemini/gemini-3.7-flash |
O código antes e depois
client = OpenAI(
- base_url="https://openrouter.ai/api/v1",
- api_key=os.environ["OPENROUTER_API_KEY"],
+ base_url="https://api.flowmodels.one/v1",
+ api_key=os.environ["FLOWMODELS_API_KEY"],
)
response = client.chat.completions.create(
- model="google/gemini-3.7-flash",
+ model="gemini/gemini-3.7-flash",
messages=[{"role": "user", "content": "Olá!"}],
- extra_headers={"HTTP-Referer": "https://example.com", "X-Title": "Meu produto"},
- extra_body={"models": ["openai/gpt-5-mini"], "provider": {"sort": "price"}},
)
Sem failover automático.
O FlowModels chama exatamente o modelo que você indicar. Em um 429 ou 503 do provedor, a API repete a mesma chamada no máximo duas vezes e, depois, você recebe o erro com o respectivo código. Se o seu serviço precisar recorrer a outro modelo, quem decide é o seu código.
Campos que se comportam de outro jeito
O que vale é o que o modelo escolhido aceita. Os campos aceitos estão em GET /v1/models, sob supported_parameters.
| Campo | Comportamento no FlowModels |
|---|---|
models, route, provider, transforms, plugins |
O FlowModels não avalia estes campos do OpenRouter. Remova-os para que o seu código não dependa deles. |
IDs de modelos |
O prefixo é o provedor desta API: x-ai/… vira xai/…, google/… vira gemini/…, e as versões podem ter outra grafia. Confira cada ID na página de modelos ou em GET /v1/models. |
Sufixos como :nitro ou :online |
O catálogo não conhece esses nomes de modelo, e eles terminam em 404 model_not_found. Nos modelos que aceitam, você ativa a busca na web com web_search: true. |
reasoning |
Em /v1/chat/completions o campo se chama reasoning_effort, em /v1/responses é reasoning.effort. Os níveis que um modelo conhece estão em capabilities.reasoning_levels. |
usage |
Você recebe o consumo no corpo da resposta sem nenhum campo adicional; com streaming, com stream_options.include_usage no último evento. |
HTTP-Referer, X-Title |
O FlowModels não avalia estes cabeçalhos. Você pode removê-los. |
O que verificar depois da migração
-
A nova chave está em
FLOWMODELS_API_KEY, eGET /v1/modelslista o seu modelo. -
Uma chamada sem streaming retorna
choices[0].message.contentcomo esperado. -
Com
stream: true, os eventos chegam; comstream_options.include_usage, o consumo vem no último evento. -
Chamadas de ferramentas e
response_formatfuncionam com exatamente o modelo que você usa. -
Seu tratamento de erros separa
429 insufficient_quota(saldo esgotado) de429 rate_limit_exceeded,429 concurrent_requests_exceedede503 provider_overloaded. - O registro de requisições do seu painel mostra o modelo, os tokens e o custo da chamada.
-
Sua aplicação reage por conta própria a
502 routing_execution_failede503 provider_overloaded, se precisar continuar funcionando sem uma rota alternativa.