Criar conta
Somente para empresas e profissionais autônomos

Menu

Todos os guias

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, 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.
  • 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/generations no formato da OpenAI, apenas com os tamanhos square, portrait, landscape e 2k em 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.

Crie uma chave, escolha um modelo e comece.

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