Da Anthropic para o FlowModels.
O FlowModels fala o formato da OpenAI. Por isso, você chama os modelos Claude com o SDK da OpenAI: mensagens, ferramentas e campos de resposta são diferentes do SDK da Anthropic.
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 | anthropic |
openai |
| URL base | https://api.anthropic.com |
https://api.flowmodels.one/v1 |
| Chave | ANTHROPIC_API_KEY |
FLOWMODELS_API_KEY |
| Nome do modelo | claude-sonnet-5-5 |
anthropic/claude-sonnet-5-5 |
O código antes e depois
- import anthropic
- client = anthropic.Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"])
+ from openai import OpenAI
+ client = OpenAI(
+ base_url="https://api.flowmodels.one/v1",
+ api_key=os.environ["FLOWMODELS_API_KEY"],
+ )
- message = client.messages.create(
- model="claude-sonnet-5-5",
- max_tokens=1024,
- system="Responda de forma breve.",
- messages=[{"role": "user", "content": "Olá!"}],
- )
- print(message.content[0].text)
+ response = client.chat.completions.create(
+ model="anthropic/claude-sonnet-5-5",
+ max_tokens=1024,
+ 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 |
Vira uma mensagem com role: "system". |
max_tokens |
Continua possível, mas não é obrigatório. Sem valor, vale o máximo do modelo, e o valor máximo possível é reservado antes da chamada. |
stop_sequences |
Aqui se chama stop. |
tools (input_schema) |
Aqui se chama tools[].function.parameters, cada entrada com type: "function". |
tool_choice |
auto, none, required ou {"type":"function","function":{"name":"…"}}. |
tool_use, tool_result |
Aqui se chamam tool_calls na resposta e role: "tool" com tool_call_id na mensagem seguinte. |
thinking |
Por meio de reasoning_effort. Os níveis que um modelo conhece estão em capabilities.reasoning_levels. |
response_format |
Os modelos da Anthropic não informam formato JSON. A API responde com 400 unsupported_for_model, em vez de retornar texto livre em silêncio. |
Blocos de imagem |
Conteúdo do tipo image vira um bloco image_url, apenas em mensagens com role: "user". |
Streaming |
Em vez de content_block_delta, chegam eventos no formato de chunks, e você lê o texto em choices[0].delta.content. |
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 emcontent[0].text.