Criar conta
Somente para empresas e profissionais autônomos

Menu

Todos os guias

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, e GET /v1/models lista o seu modelo.
  • Uma chamada sem streaming retorna choices[0].message.content como esperado.
  • Com stream: true, os eventos chegam; com stream_options.include_usage, o consumo vem no último evento.
  • Chamadas de ferramentas e response_format funcionam com exatamente o modelo que você usa.
  • Seu tratamento de erros separa 429 insufficient_quota (saldo esgotado) de 429 rate_limit_exceeded, 429 concurrent_requests_exceeded e 503 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_failed e 503 provider_overloaded, se precisar continuar funcionando sem uma rota alternativa.

Crie uma chave, escolha um modelo e comece.

O FlowModels é destinado exclusivamente a empresas e profissionais autônomos.