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