Criar conta
Somente para empresas e profissionais autônomos

Menu

Todos os guias

Do Google Gemini para o FlowModels.

O FlowModels fala o formato da OpenAI. Por isso, você chama os modelos Gemini com o SDK da OpenAI: reescreva as mensagens, a configuração e as ferramentas.

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
SDK google-genai openai
URL base https://generativelanguage.googleapis.com https://api.flowmodels.one/v1
Chave GEMINI_API_KEY FLOWMODELS_API_KEY
Nome do modelo gemini-3.7-flash gemini/gemini-3.7-flash

O código antes e depois

- from google import genai
- from google.genai import types
- 
- client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
+ from openai import OpenAI
+ 
+ client = OpenAI(
+     base_url="https://api.flowmodels.one/v1",
+     api_key=os.environ["FLOWMODELS_API_KEY"],
+ )
  
- response = client.models.generate_content(
-     model="gemini-3.7-flash",
-     contents="Olá!",
-     config=types.GenerateContentConfig(
-         system_instruction="Responda de forma breve.",
-         temperature=0.2,
-     ),
- )
- print(response.text)
+ response = client.chat.completions.create(
+     model="gemini/gemini-3.7-flash",
+     temperature=0.2,
+     messages=[
+         {"role": "system", "content": "Responda de forma breve."},
+         {"role": "user", "content": "Olá!"},
+     ],
+ )
+ print(response.choices[0].message.content)

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
system_instruction Vira uma mensagem com role: "system".
contents, parts Viram messages com role e content. Imagens são blocos do tipo image_url, apenas em mensagens com role: "user".
max_output_tokens, stop_sequences Aqui se chamam max_tokens e stop.
response_mime_type, response_schema Por meio de response_format com json_schema. O FlowModels filtra o seu schema para as chaves que o Gemini aceita.
function_declarations Aqui se chamam tools[].function. O modelo informa tool_calls; o FlowModels não executa suas funções.
search_domain_filter Modelos sem filtro de domínio, como o Gemini, recusam o campo com 400 unsupported_for_model.
Streaming Com stream: true, o texto chega em choices[0].delta.content, em vez de por generate_content_stream.

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.
  • Seu código lê a resposta em choices[0].message.content, e não em response.text.

Crie uma chave, escolha um modelo e comece.

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