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/modelsresponde sem erro e inclui seu modelo.- Uma chamada normal retorna
choices[0].message.contentcomo esperado. - Com
stream: true, os eventos chegam, veja Transmitir respostas em streaming. - Seu tratamento de erros separa
429 insufficient_quotae429 spend_limit_exceeded(saldo ou limite) de429 rate_limit_exceedede503 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.