Da OpenAI para o FlowModels.
Se você usa o SDK da OpenAI, troque a URL base e a chave e escreva o modelo como provider/model.
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://api.openai.com/v1 |
https://api.flowmodels.one/v1 |
| Chave | OPENAI_API_KEY |
FLOWMODELS_API_KEY |
| Nome do modelo | gpt-5-mini |
openai/gpt-5-mini |
O código antes e depois
from openai import OpenAI
client = OpenAI(
- api_key=os.environ["OPENAI_API_KEY"],
+ base_url="https://api.flowmodels.one/v1",
+ api_key=os.environ["FLOWMODELS_API_KEY"],
)
response = client.chat.completions.create(
- model="gpt-5-mini",
+ model="openai/gpt-5-mini",
messages=[{"role": "user", "content": "Olá!"}],
)
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 |
|---|---|
n, logprobs, top_logprobs, audio, store, metadata, previous_response_id, background, conversation, webhook_endpoint_id |
Em /v1/chat/completions, a API responde com 400 unsupported_field, em vez de ignorá-los em silêncio. Em /v1/responses, são permitidos background, store, conversation, webhook_endpoint_id e metadata. |
max_tokens, max_completion_tokens |
As duas formas funcionam. Sem valor, vale o máximo do modelo, e o valor máximo possível é reservado antes da chamada. |
temperature, top_p |
Modelos com valores de amostragem fixos respondem a estes campos com 400 unsupported_for_model. Confira supported_parameters. |
response_format |
text, json_object e json_schema. Se o modelo não aceitar o formato, vem 400 unsupported_for_model. Se a palavra “json” faltar nas mensagens com json_object, o FlowModels acrescenta uma breve indicação. |
tools, tool_choice |
Somente o tipo function. O FlowModels não executa suas funções; o modelo informa tool_calls. Ferramentas integradas como web_search ou code_interpreter não existem aqui como tipo de ferramenta; nos modelos que aceitam, você ativa a busca na web com web_search: true. |
stream_options |
Só é permitido include_usage, e apenas junto com stream: true. |
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.
- Os modelos de texto da OpenAI estão no catálogo a partir do GPT-5. Se você usa modelos mais antigos, escolha um modelo da lista antes de migrar.
-
Você gera imagens com
POST /v1/images/generationsno formato da OpenAI, apenas com os tamanhossquare,portrait,landscapee2kem vez de pixels e com exatamente uma imagem por requisição. O FlowModels não oferece batch, assistants nem ajuste fino. Essas chamadas continuam na OpenAI.