https://bsf.ai/assets/gateway-de-api-de-ia-para-desenvolvedores-brasileiros-Da3AVgeX.js

1import{j as e}from"./main-DniETxk8.js";let n={title:"Gateway de API de IA para desenvolvedores brasileiros",description:"Como usar uma única chave de API para Claude, GPT e Gemini no Claude Code, nos SDKs compatíveis com OpenAI e nas suas próprias aplicações",image:"https://bsf.ai/og.jpg",date:new Date(17849376e5),published:!0,categories:["product","tutorial"],author:"bsf-ai",tags:["ai-api","api-gateway","claude-code"]},r={contents:[{heading:"gateway-de-api-de-ia-para-desenvolvedores-brasileiros",content:"Quem desenvolve com IA hoje raramente fica em um provedor só. Um projeto usa Claude para escrever código, outro usa GPT para extrair dados e um terceiro testa Gemini porque o contexto longo sai mais barato. O resultado é previsível: várias contas, várias chaves de API espalhadas por arquivos `.env` e uma fatura diferente para cada fornecedor."},{heading:"gateway-de-api-de-ia-para-desenvolvedores-brasileiros",content:"Um gateway de API de IA resolve essa parte chata. Ele fica entre as suas aplicações e os provedores de modelos, e expõe **um endpoint e uma chave** no lugar de vários. É exatamente isso que a bsf.ai faz."},{heading:"o-que-muda-com-um-gateway-no-meio",content:"Sem gateway, cada novo modelo significa uma conta nova, um SDK novo e mais um lugar para conferir gasto. Com a bsf.ai no meio do caminho:"},{heading:"o-que-muda-com-um-gateway-no-meio",content:"**Uma chave de API** atende todos os modelos suportados — Claude, GPT, Gemini, DeepSeek e outros."},{heading:"o-que-muda-com-um-gateway-no-meio",content:"**Trocar de modelo é trocar uma string.** O nome do modelo vai na requisição; o endpoint e a credencial continuam os mesmos."},{heading:"o-que-muda-com-um-gateway-no-meio",content:"**O uso fica em um lugar só.** Requisições, consumo de tokens, latência e gasto aparecem no mesmo console, separados por chave, modelo e período."},{heading:"o-que-muda-com-um-gateway-no-meio",content:"**A cobrança é uma carteira pré-paga em dólar.** Você recarrega um valor e o consumo é descontado conforme chama os modelos, normalmente por tokens de entrada e de saída. Alguns modelos são cobrados por chamada."},{heading:"compatível-com-openai-a-migração-é-de-duas-linhas",content:"A bsf.ai expõe um endpoint compatível com OpenAI. Se a sua aplicação já usa o SDK da OpenAI, LangChain, Dify ou uma extensão de IDE, migrar é trocar a Base URL e a chave — a lógica de negócio não muda:"},{heading:"compatível-com-openai-a-migração-é-de-duas-linhas",content:"Para chamar outro modelo, você muda o valor de `model`. Nada além disso."},{heading:"claude-code-e-os-agentes-de-terminal",content:"Agentes de código são o caso de uso que mais cresce — e o que mais assusta na hora da conta, porque uma sessão longa consome muito mais token do que uma chamada avulsa."},{heading:"claude-code-e-os-agentes-de-terminal",content:"O Claude Code aceita um endpoint personalizado, então dá para apontá-lo para a bsf.ai e continuar trabalhando do jeito de sempre. A vantagem prática aparece depois: como o tráfego passa pelo gateway, você consegue criar uma chave separada só para o agente, definir um limite de gasto para ela e olhar no console quanto aquela sessão realmente custou. O mesmo vale para Codex, Cline, Continue, Cursor e outros clientes compatíveis — a documentação tem o passo a passo de cada um."},{heading:"uma-chave-por-projeto-não-uma-chave-para-tudo",content:"Compartilhar a mesma credencial entre desenvolvimento, produção e três agentes é a receita para não descobrir de onde veio o pico de consumo. O padrão que costuma funcionar melhor:"},{heading:"uma-chave-por-projeto-não-uma-chave-para-tudo",content:"Uma chave por ambiente (`dev`, `staging`, `prod`)."},{heading:"uma-chave-por-projeto-não-uma-chave-para-tudo",content:"Uma chave por agente de código ou automação."},{heading:"uma-chave-por-projeto-não-uma-chave-para-tudo",content:"Um limite de gasto em cada chave, dimensionado para o pior mês plausível."},{heading:"uma-chave-por-projeto-não-uma-chave-para-tudo",content:"Se uma chave vazar ou um loop sair do controle, o estrago fica contid

1o naquela chave — e você revoga só ela, sem parar o resto."},{heading:"como-começar",content:"Crie sua conta em bsf.ai."},{heading:"como-começar",content:"Abra o console e gere uma chave de API."},{heading:"como-começar",content:"Aponte a Base URL do seu cliente para `https://api.bsf.ai`."},{heading:"como-começar",content:"Recarregue a carteira e acompanhe o consumo no painel de uso."},{heading:"como-começar",content:"Antes de recarregar, vale abrir a página de preços: a calculadora mostra o preço de entrada e de saída de cada modelo e estima quanto rende um determinado valor. É a forma mais rápida de comparar o custo de dois modelos para a mesma tarefa antes de escrever qualquer código."},{heading:"quando-um-gateway-não-ajuda",content:'Vale a honestidade: se você usa um único modelo, de um único provedor, em um único projeto, um gateway adiciona pouca coisa. O ganho aparece quando existem vários modelos, vários ambientes ou várias pessoas no time — ou seja, quando o problema deixa de ser "chamar a API" e passa a ser "administrar quem chama, quanto chama e quanto isso custou".'},{heading:"quando-um-gateway-não-ajuda",content:"Se esse já é o seu cenário, comece pelo guia de início rápido ou vá direto ao console criar a primeira chave."}],headings:[{id:"gateway-de-api-de-ia-para-desenvolvedores-brasileiros",content:"Gateway de API de IA para desenvolvedores brasileiros"},{id:"o-que-muda-com-um-gateway-no-meio",content:"O que muda com um gateway no meio"},{id:"compatível-com-openai-a-migração-é-de-duas-linhas",content:"Compatível com OpenAI: a migração é de duas linhas"},{id:"claude-code-e-os-agentes-de-terminal",content:"Claude Code e os agentes de terminal"},{id:"uma-chave-por-projeto-não-uma-chave-para-tudo",content:"Uma chave por projeto, não uma chave para tudo"},{id:"como-começar",content:"Como começar"},{id:"quando-um-gateway-não-ajuda",content:"Quando um gateway não ajuda"}]},d=[{depth:1,url:"#gateway-de-api-de-ia-para-desenvolvedores-brasileiros",title:e.jsx(e.Fragment,{children:"Gateway de API de IA para desenvolvedores brasileiros"})},{depth:2,url:"#o-que-muda-com-um-gateway-no-meio",title:e.jsx(e.Fragment,{children:"O que muda com um gateway no meio"})},{depth:2,url:"#compatível-com-openai-a-migração-é-de-duas-linhas",title:e.jsx(e.Fragment,{children:"Compatível com OpenAI: a migração é de duas linhas"})},{depth:2,url:"#claude-code-e-os-agentes-de-terminal",title:e.jsx(e.Fragment,{children:"Claude Code e os agentes de terminal"})},{depth:2,url:"#uma-chave-por-projeto-não-uma-chave-para-tudo",title:e.jsx(e.Fragment,{children:"Uma chave por projeto, não uma chave para tudo"})},{depth:2,url:"#como-começar",title:e.jsx(e.Fragment,{children:"Como começar"})},{depth:2,url:"#quando-um-gateway-não-ajuda",title:e.jsx(e.Fragment,{children:"Quando um gateway não ajuda"})}];function s(o){const a={a:"a",code:"code",h1:"h1",h2:"h2",li:"li",ol:"ol",p:"p",pre:"pre",span:"span",strong:"strong",ul:"ul",...o.components};return e.jsxs(e.Fragment,{children:[e.jsx(a.h1,{id:"gateway-de-api-de-ia-para-desenvolvedores-brasileiros",children:"Gateway de API de IA para desenvolvedores brasileiros"}),`
2`,e.jsxs(a.p,{children:["Quem desenvolve com IA hoje raramente fica em um provedor só. Um projeto usa Claude para escrever código, outro usa GPT para extrair dados e um terceiro testa Gemini porque o contexto longo sai mais barato. O resultado é previsível: várias contas, várias chaves de API espalhadas por arquivos ",e.jsx(a.code,{children:".env"})," e uma fatura diferente para cada fornecedor."]}),`
3`,e.jsxs(a.p,{children:["Um gateway de API de IA resolve essa parte chata. Ele fica entre as suas aplicações e os provedores de modelos, e expõe ",e.jsx(a.strong,{children:"um endpoint e uma chave"})," no lugar de vários. É exatamente isso que a bsf.ai faz."]}),`
4`,e.jsx(a.h2,{id:"o-que-muda-com-um-gateway-no-meio",children:"O que muda com um gateway no meio"}),`
5`,e.jsx(a.p,{children:"Sem gateway, cada novo modelo significa uma conta nova, um SDK novo e mais um lugar para conferir gasto. Com a bsf.ai no meio do caminho:"}),`
6`,e.jsxs(a.ul,{children:[`
7`,e.jsxs(a.li,{children:[e.jsx(a.strong,{children:"Uma chave de API"})," atende todos os modelos suportados — Claude, GPT, Gemini, DeepSeek e outros."]}),`
8`,e.jsxs(a.li,{children:[e.jsx(a.strong,{children:"Trocar de modelo é trocar uma string."})," O nome do modelo vai na requisição; o endpoint e a credencial continuam os mesmos."]}),`
9`,e.jsxs(a.li,{children:[e.jsx(a.strong,{children:"O uso fica em um lugar só."})," Requisições, consumo de tokens, latência e gasto aparecem no mesmo console, separados por chave, modelo e período."]}),`
10`,e.jsxs(a.li,{children:[e.jsx(a.strong,{children:"A cobrança é uma carteira pré-paga em dólar."})," Você recarrega um valor e o consumo é descontado conforme chama os modelos, normalmente por tokens de entrada e de saída. Alguns modelos são cobrados por chamada."]}),`
11`]}),`

12`,e.jsx(a.h2,{id:"compatível-com-openai-a-migração-é-de-duas-linhas",children:"Compatível com OpenAI: a migração é de duas linhas"}),`
13`,e.jsx(a.p,{children:"A bsf.ai expõe um endpoint compatível com OpenAI. Se a sua aplicação já usa o SDK da OpenAI, LangChain, Dify ou uma extensão de IDE, migrar é trocar a Base URL e a chave — a lógica de negócio não muda:"}),`
14`,e.jsx(e.Fragment,{children:e.jsx(a.pre,{className:"shiki shiki-themes github-light github-dark",style:{"--shiki-light":"#24292e","--shiki-dark":"#e1e4e8","--shiki-light-bg":"#fff","--shiki-dark-bg":"#24292e"},tabIndex:"0",icon:'<svg viewBox="0 0 24 24"><path d="M14.25.18l.9.2.73.26.59.3.45.32.34.34.25.34.16.33.1.3.04.26.02.2-.01.13V8.5l-.05.63-.13.55-.21.46-.26.38-.3.31-.33.25-.35.19-.35.14-.33.1-.3.07-.26.04-.21.02H8.77l-.69.05-.59.14-.5.22-.41.27-.33.32-.27.35-.2.36-.15.37-.1.35-.07.32-.04.27-.02.21v3.06H3.17l-.21-.03-.28-.07-.32-.12-.35-.18-.36-.26-.36-.36-.35-.46-.32-.59-.28-.73-.21-.88-.14-1.05-.05-1.23.06-1.22.16-1.04.24-.87.32-.71.36-.57.4-.44.42-.33.42-.24.4-.16.36-.1.32-.05.24-.01h.16l.06.01h8.16v-.83H6.18l-.01-2.75-.02-.37.05-.34.11-.31.17-.28.25-.26.31-.23.38-.2.44-.18.51-.15.58-.12.64-.1.71-.06.77-.04.84-.02 1.27.05zm-6.3 1.98l-.23.33-.08.41.08.41.23.34.33.22.41.09.41-.09.33-.22.23-.34.08-.41-.08-.41-.23-.33-.33-.22-.41-.09-.41.09zm13.09 3.95l.28.06.32.12.35.18.36.27.36.35.35.47.32.59.28.73.21.88.14 1.04.05 1.23-.06 1.23-.16 1.04-.24.86-.32.71-.36.57-.4.45-.42.33-.42.24-.4.16-.36.09-.32.05-.24.02-.16-.01h-8.22v.82h5.84l.01 2.76.02.36-.05.34-.11.31-.17.29-.25.25-.31.24-.38.2-.44.17-.51.15-.58.13-.64.09-.71.07-.77.04-.84.01-1.27-.04-1.07-.14-.9-.2-.73-.25-.59-.3-.45-.33-.34-.34-.25-.34-.16-.33-.1-.3-.04-.25-.02-.2.01-.13v-5.34l.05-.64.13-.54.21-.46.26-.38.3-.32.33-.24.35-.2.35-.14.33-.1.3-.06.26-.04.21-.02.13-.01h5.84l.69-.05.59-.14.5-.21.41-.28.33-.32.27-.35.2-.36.15-.36.1-.35.07-.32.04-.28.02-.21V6.07h2.09l.14.01zm-6.47 14.25l-.23.33-.08.41.08.41.23.33.33.23.41.08.41-.08.33-.23.23-.33.08-.41-.08-.41-.23-.33-.33-.23-.41-.08-.41.08z" fill="currentColor" /></svg>',children:e.jsxs(a.code,{children:[e.jsxs(a.span,{className:"line",children:[e.jsx(a.span,{style:{"--shiki-light":"#D73A49","--shiki-dark":"#F97583"},children:"from"}),e.jsx(a.span,{style:{"--shiki-light":"#24292E","--shiki-dark":"#E1E4E8"},children:" openai "}),e.jsx(a.span,{style:{"--shiki-light":"#D73A49","--shiki-dark":"#F97583"},children:"import"}),e.jsx(a.span,{style:{"--shiki-light":"#24292E","--shiki-dark":"#E1E4E8"},children:" OpenAI"})]}),`
15`,e.jsx(a.span,{className:"line"}),`
16`,e.jsxs(a.span,{className:"line",children:[e.jsx(a.span,{style:{"--shiki-light":"#24292E","--shiki-dark":"#E1E4E8"},children:"client "}),e.jsx(a.span,{style:{"--shiki-light":"#D73A49","--shiki-dark":"#F97583"},children:"="}),e.jsx(a.span,{style:{"--shiki-light":"#24292E","--shiki-dark":"#E1E4E8"},children:" OpenAI("})]}),`
17`,e.jsxs(a.span,{className:"line",children:[e.jsx(a.span,{style:{"--shiki-light":"#E36209","--shiki-dark":"#FFAB70"},children:"    base_url"}),e.jsx(a.span,{style:{"--shiki-light":"#D73A49","--shiki-dark":"#F97583"},children:"="}),e.jsx(a.span,{style:{"--shiki-light":"#032F62","--shiki-dark":"#9ECBFF"},children:'"https://api.bsf.ai/v1"'}),e.jsx(a.span,{style:{"--shiki-light":"#24292E","--shiki-dark":"#E1E4E8"},children:","})]}),`
18`,e.jsxs(a.span,{className:"line",children:[e.jsx(a.span,{style:{"--shiki-light":"#E36209","--shiki-dark":"#FFAB70"},children:"    api_key"}),e.jsx(a.span,{style:{"--shiki-light":"#D73A49","--shiki-dark":"#F97583"},children:"="}),e.jsx(a.span,{style:{"--shiki-light":"#032F62","--shiki-dark":"#9ECBFF"},children:'"<sua-chave-bsf-ai>"'}),e.jsx(a.span,{style:{"--shiki-light":"#24292E","--shiki-dark":"#E1E4E8"},children:","})]}),`
19`,e.jsx(a.span,{className:"line",children:e.jsx(a.span,{style:{"--shiki-light":"#24292E","--shiki-dark":"#E1E4E8"},children:")"})}),`
20`,e.jsx(a.span,{className:"line"}),`
21`,e.jsxs(a.span,{className:"line",children:[e.jsx(a.span,{style:{"--shiki-light":"#24292E","--shiki-dark":"#E1E4E8"},children:"resposta "}),e.jsx(a.span,{style:{"--shiki-light":"#D73A49","--shiki-dark":"#F97583"},children:"="}),e.jsx(a.span,{style:{"--shiki-light":"#24292E","--shiki-dark":"#E1E4E8"}

21,children:" client.chat.completions.create("})]}),`
22`,e.jsx(a.span,{className:"line",children:e.jsx(a.span,{style:{"--shiki-light":"#6A737D","--shiki-dark":"#6A737D"},children:"    # o identificador de cada modelo está na página de preços da bsf.ai"})}),`
23`,e.jsxs(a.span,{className:"line",children:[e.jsx(a.span,{style:{"--shiki-light":"#E36209","--shiki-dark":"#FFAB70"},children:"    model"}),e.jsx(a.span,{style:{"--shiki-light":"#D73A49","--shiki-dark":"#F97583"},children:"="}),e.jsx(a.span,{style:{"--shiki-light":"#032F62","--shiki-dark":"#9ECBFF"},children:'"<id-do-modelo>"'}),e.jsx(a.span,{style:{"--shiki-light":"#24292E","--shiki-dark":"#E1E4E8"},children:","})]}),`
24`,e.jsxs(a.span,{className:"line",children:[e.jsx(a.span,{style:{"--shiki-light":"#E36209","--shiki-dark":"#FFAB70"},children:"    messages"}),e.jsx(a.span,{style:{"--shiki-light":"#D73A49","--shiki-dark":"#F97583"},children:"="}),e.jsx(a.span,{style:{"--shiki-light":"#24292E","--shiki-dark":"#E1E4E8"},children:"[{"}),e.jsx(a.span,{style:{"--shiki-light":"#032F62","--shiki-dark":"#9ECBFF"},children:'"role"'}),e.jsx(a.span,{style:{"--shiki-light":"#24292E","--shiki-dark":"#E1E4E8"},children:": "}),e.jsx(a.span,{style:{"--shiki-light":"#032F62","--shiki-dark":"#9ECBFF"},children:'"user"'}),e.jsx(a.span,{style:{"--shiki-light":"#24292E","--shiki-dark":"#E1E4E8"},children:", "}),e.jsx(a.span,{style:{"--shiki-light":"#032F62","--shiki-dark":"#9ECBFF"},children:'"content"'}),e.jsx(a.span,{style:{"--shiki-light":"#24292E","--shiki-dark":"#E1E4E8"},children:": "}),e.jsx(a.span,{style:{"--shiki-light":"#032F62","--shiki-dark":"#9ECBFF"},children:'"Explique o que faz um gateway de API."'}),e.jsx(a.span,{style:{"--shiki-light":"#24292E","--shiki-dark":"#E1E4E8"},children:"}],"})]}),`
25`,e.jsx(a.span,{className:"line",children:e.jsx(a.span,{style:{"--shiki-light":"#24292E","--shiki-dark":"#E1E4E8"},children:")"})})]})})}),`
26`,e.jsxs(a.p,{children:["Para chamar outro modelo, você muda o valor de ",e.jsx(a.code,{children:"model"}),". Nada além disso."]}),`
27`,e.jsx(a.h2,{id:"claude-code-e-os-agentes-de-terminal",children:"Claude Code e os agentes de terminal"}),`
28`,e.jsx(a.p,{children:"Agentes de código são o caso de uso que mais cresce — e o que mais assusta na hora da conta, porque uma sessão longa consome muito mais token do que uma chamada avulsa."}),`
29`,e.jsxs(a.p,{children:["O Claude Code aceita um endpoint personalizado, então dá para apontá-lo para a bsf.ai e continuar trabalhando do jeito de sempre. A vantagem prática aparece depois: como o tráfego passa pelo gateway, você consegue criar uma chave separada só para o agente, definir um limite de gasto para ela e olhar no console quanto aquela sessão realmente custou. O mesmo vale para Codex, Cline, Continue, Cursor e outros clientes compatíveis — a ",e.jsx(a.a,{href:"https://docs.bsf.ai",children:"documentação"})," tem o passo a passo de cada um."]}),`
30`,e.jsx(a.h2,{id:"uma-chave-por-projeto-não-uma-chave-para-tudo",children:"Uma chave por projeto, não uma chave para tudo"}),`
31`,e.jsx(a.p,{children:"Compartilhar a mesma credencial entre desenvolvimento, produção e três agentes é a receita para não descobrir de onde veio o pico de consumo. O padrão que costuma funcionar melhor:"}),`
32`,e.jsxs(a.ol,{children:[`
33`,e.jsxs(a.li,{children:["Uma chave por ambiente (",e.jsx(a.code,{children:"dev"}),", ",e.jsx(a.code,{children:"staging"}),", ",e.jsx(a.code,{children:"prod"}),")."]}),`
34`,e.jsx(a.li,{children:"Uma chave por agente de código ou automação."}),`
35`,e.jsx(a.li,{children:"Um limite de gasto em cada chave, dimensionado para o pior mês plausível."}),`
36`]}),`
37`,e.jsx(a.p,{children:"Se uma chave vazar ou um loop sair do controle, o estrago fica contido naquela chave — e você revoga só ela, sem parar o resto."}),`
38`,e.jsx(a.h2,{id:"como-começar",children:"Como começar"}),`
39`,e.jsxs(a.ol,{children:[`
40`,e.jsxs(a.li,{children:["Crie sua conta em ",e.jsx(a.a,{href:"https://bsf.ai",children:"bsf.ai"}),"."]}),`
41`,e.jsx(a.li,{children:"Abra o console e gere uma chave de API."}),`
42`,e.jsxs(a.li,{children:["Aponte a Base URL do seu cliente para ",e.jsx(a.code,{children:"https://api.bsf.ai"}),"."]}),`
43`,e.jsx(a.li,{children:"Recarregue a carteira e acompanhe o consumo no painel de uso."}),`
44`]}),`
45`,e.jsxs(a.p,{children:["Antes de recarregar, vale abrir a ",e.jsx(a.a,{href:"https://bsf.ai/price",children:"página de preços"}),": a calculadora mostra o preço de entrada e de saída de cada modelo e estima quanto rende um determinado valor. É a forma mais rápida de comparar o custo de dois modelos para a mesma tarefa antes de escrever qualquer código."]}),`
46`,e.jsx(a.h2,{id:"quando-um-gateway-não-ajuda",children:"Quando um gateway não ajuda"}),`
47`,e.jsx(a.p,{children:'Vale a honestidade: se você usa um único modelo, de um único provedor, em um único projeto, um gateway adiciona pouca coisa. O ganho aparece quando existem vários modelos, vários ambientes ou várias pessoas no time — ou seja, quando o problema deixa de ser "chamar a API" e passa a ser "administrar quem chama, quanto chama e quanto isso custou".'}),`
48`,e.jsxs(a.p,{children:["Se esse já é o seu cenário, comece pelo ",e.jsx(a.a,{href:"https://docs.bsf.ai/en/quickstart",children:"guia de início rápido"})," ou vá direto ao ",e.jsx(a.a,{href:"https://bsf.ai/dashboard",children:"console"})," criar a primeira chave."]})]})}function t(o={}){const{wrapper:a}=o.components||{};return a?e.jsx(a,{...o,children:e.jsx(s,{...o})}):s(o)}export{t as default,n as frontmatter,r as structuredData,d as toc};