FlowModels

Migrar para o FlowModels: endereço base, chave e ID do modelo

Publicado em 11. novembro 2026

Se até agora você conectava diretamente OpenAI, Anthropic, Groq, xAI, Google Gemini ou OpenRouter, normalmente basta mudar três coisas: o endereço base, a chave e o nome do modelo. O FlowModels fala o formato da API da OpenAI, por isso as bibliotecas da OpenAI existentes continuam funcionando.

As três alterações

Ponto Novo valor
Endereço base https://api.flowmodels.one/v1
Chave uma chave de Chaves de API com a permissão Usar IA, por exemplo na variável de ambiente FLOWMODELS_API_KEY
Modelo o identificador completo provedor/modelo, por exemplo openai/gpt-5.6-luna

Em Python, fica assim:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FLOWMODELS_API_KEY"],
    base_url="https://api.flowmodels.one/v1",
)

result = client.chat.completions.create(
    model="anthropic/claude-sonnet-5-5",
    messages=[{"role": "user", "content": "Olá"}],
)

Os identificadores disponíveis estão em Entender os IDs de modelo. Todas as configurações da biblioteca estão em Usar a biblioteca da OpenAI para Python e Node.js com o FlowModels.

O que funciona de outro jeito

Algumas coisas no FlowModels são diferentes, de propósito, do uso direto dos provedores:

  • O modelo continua sendo escolha sua. O FlowModels sempre chama exatamente o modelo que você informa. Se ele estiver sobrecarregado, você recebe um erro e decide como sua aplicação deve reagir. A troca para outro modelo ou provedor nunca acontece sozinha.
  • Os campos são validados, não ignorados. Um campo que o modelo não processa resulta em 400 unsupported_for_model, veja O que um modelo sabe fazer.
  • A cobrança é em euros. O custo de cada resposta aparece em usage.cost, veja Quanto custou minha requisição?.
  • Sem saldo, nada funciona. Faça uma recarga antes da primeira chamada, veja Recarregar saldo e ativar a recarga automática.

O que verificar depois da migração

  • GET /v1/models responde sem erro e inclui seu modelo.
  • Uma chamada normal retorna choices[0].message.content como esperado.
  • Com stream: true, os eventos chegam, veja Transmitir respostas em streaming.
  • Seu tratamento de erros separa 429 insufficient_quota e 429 spend_limit_exceeded (saldo ou limite) de 429 rate_limit_exceeded e 503 provider_overloaded, veja Entender as mensagens de erro do FlowModels.
  • Em Solicitações, sua chamada aparece com modelo, tokens e custo.

Integrações existentes no endereço antigo

Se hoje você chama o FlowModels por https://creativeskyline.de/api/flowai/v1, não precisa mudar nada de imediato: o endereço anterior continua existindo sem redirecionamento, e suas chaves valem tanto nele quanto em https://api.flowmodels.one/v1. Mesmo assim, use o novo endereço em aplicações novas.

A interface de assinatura do FlowAI da FlowSuite (POST /chat) é separada e continua exclusivamente no endereço anterior, veja FlowModels ou chat do FlowAI.

Este artigo foi útil?

Voltar para Primeiros passos e chaves de API