---
title: "Vercel AI SDK: createOpenAICompatible com base URL própria"
description: "Chame a BroadNet Inference pelo Vercel AI SDK com createOpenAICompatible do @ai-sdk/openai-compatible: generateText, streamText, ferramentas e reasoning effort."
url: https://broadrouter.com/pt/guides/vercel-ai-sdk-openai-compatible/
lang: pt-BR
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduzido do inglês com ajuda de IA. [Leia o original em inglês](https://broadrouter.com/guides/vercel-ai-sdk-openai-compatible/) (atualizado em 2026-11-16).

# Como usar o Vercel AI SDK com a BroadNet Inference

Atualizado em 2026-11-16

Instale ai e @ai-sdk/openai-compatible e chame createOpenAICompatible com name broadnet, baseURL https://inference.broadnet.ai/v1 e a sua chave da BroadNet em apiKey. Passe ao provider um ID de modelo da BroadNet, como broadnet/glm-5.3, e use generateText ou streamText normalmente. Mantenha a chave no servidor e dê aos modelos de raciocínio um maxOutputTokens generoso.

O [AI SDK](https://ai-sdk.dev/providers/openai-compatible-providers) da Vercel é um toolkit em TypeScript para apps com LLM. O pacote `@ai-sdk/openai-compatible` cria um provider para qualquer API que siga o formato de chat completions da OpenAI. A BroadNet Inference segue, então você só troca a base URL, a chave e os IDs de modelo. Se preferir o client da OpenAI puro, veja [o guia do SDK Node](https://broadrouter.com/pt/guides/openai-node-sdk/).

## Configuração

1.  **Instale os pacotes.** No momento em que este guia foi escrito, o npm distribui `ai` 7.x e `@ai-sdk/openai-compatible` 3.x.
    
    ```bash
    npm install ai @ai-sdk/openai-compatible
    export BROADNET_API_KEY='your-broadnet-key'
    ```
    
2.  **Crie o provider.** A opção `includeUsage` adiciona os dados de uso às respostas em streaming.
    
    ```ts
    // broadnet.ts
    import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
    
    export const broadnet = createOpenAICompatible({
      name: 'broadnet',
      baseURL: 'https://inference.broadnet.ai/v1',
      apiKey: process.env.BROADNET_API_KEY,
      includeUsage: true, // usage data in streaming responses
    });
    ```
    
3.  **Gere texto.** O raciocínio conta para `maxOutputTokens`.
    
    ```ts
    import { generateText } from 'ai';
    import { broadnet } from './broadnet';
    
    const { text, usage, finishReason } = await generateText({
      model: broadnet('broadnet/glm-5.3'),
      prompt: 'Explain idempotency keys in two sentences.',
      maxOutputTokens: 4000, // reasoning counts toward this
    });
    
    console.log(text, finishReason, usage);
    ```
    
4.  **Faça streaming.** Troque `generateText` por `streamText` e leia `textStream`. O [guia de streaming](https://broadrouter.com/pt/guides/streaming-chat-completions/) explica o formato que trafega por baixo.
    

O `name` que você passa vira a chave das opções e dos metadados do provider, então use um nome curto e estável. `provider('id')` e `provider.chatModel('id')` criam um modelo de chat; não existe configuração separada por modelo. Mantenha a chave no servidor. Não importe esse arquivo em código que roda no navegador, ou a chave vai parar nas mãos de todos os visitantes.

A documentação do provider lista geração de texto, streaming, tool calling, saídas estruturadas, conteúdo de raciocínio e entrada de imagens como recursos suportados, com a observação de que alguns dependem do provedor. Na BroadNet, a entrada de imagens funciona com DeepSeek V4.1 Flash, Qwen3.8 27B e Gemma 4 VL 26B. O GLM 5.3 aceita só texto.

## Opções que vale a pena definir

-   **reasoningEffort.** Passe pela `providerOptions`, sob o nome do provider. A documentação do AI SDK diz que os valores exatos dependem do provedor; a documentação da BroadNet mostra `low`.

```ts
const result = await generateText({
  model: broadnet('broadnet/deepseek-v4.1-flash'),
  prompt: 'Classify: "refund my order" -> intent?',
  providerOptions: { broadnet: { reasoningEffort: 'low' } },
});
```

-   **supportsStructuredOutputs.** O AI SDK só envia JSON schemas quando essa opção é `true` no provider. A BroadNet lista saída estruturada para GLM 5.3 e Qwen3.8 27B. Se você ativar, use esses modelos para saída com schema.
-   **maxRetries.** `generateText` tenta de novo duas vezes por padrão. Ajuste conforme o seu rate limit.
-   **Saída de raciocínio.** O AI SDK lê o conteúdo de raciocínio quando o provedor o devolve. O campo de nível superior `reasoningText` do resultado agora está marcado como obsoleto em favor de `finalStep.reasoningText`. Não crie lógica que dependa da presença do raciocínio.

## Qual modelo escolher

| Necessidade | Modelo | Contexto |
| --- | --- | --- |
| Tool calling, saída estruturada | [`broadnet/glm-5.3`](https://broadrouter.com/pt/models/glm-5.3/) | 1.048.576 |
| Imagens com ferramentas, árabe | [`broadnet/qwen3.8-27b`](https://broadrouter.com/pt/models/qwen3.8-27b/) | 262.144 |
| Contexto longo, plano de preço fixo | [`broadnet/deepseek-v4.1-flash`](https://broadrouter.com/pt/models/deepseek-v4.1-flash/) | 1.048.576 |
| Chamadas baratas com texto e imagem | [`broadnet/gemma-4-26b-a4b`](https://broadrouter.com/pt/models/gemma-4-vl-26b/) | 32.768 |

Os preços por token de cada modelo estão na [página de preços](https://broadrouter.com/pt/pricing/).

## Solução de problemas

-   **401.** `BROADNET_API_KEY` está faltando no runtime (confira as variáveis de ambiente do seu provedor de hospedagem), está errada, expirou ou ficou sem cota de pagamento por uso.
-   **providerOptions ignoradas.** A chave precisa ser igual ao `name` do provider em camelCase. Com `name: 'broadnet'`, use `providerOptions.broadnet`.
-   **Erros de modelo.** O ID precisa ser exatamente o da BroadNet, com o prefixo `broadnet/`. GLM 5.3, Qwen3.8 27B e DeepSeek V4.1 Flash exigem uma recarga; o crédito inicial de $5 cobre o Gemma 4 VL 26B e os dois modelos Transcribe.
-   **Texto vazio, finishReason “length”.** O raciocínio consumiu o orçamento. Aumente `maxOutputTokens` ou reduza `reasoningEffort`. [Por que as respostas vêm vazias](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/).
-   **429 sob carga.** Uma chave de pagamento por uso permite 30 requisições por minuto e 4 em andamento. Funções serverless escalam rápido, então limite a concorrência no seu app. Veja [erros e novas tentativas](https://broadrouter.com/pt/guides/errors-and-retries/).
-   **Agentes em paralelo com uma chave de plano.** Uma [sessão do plano ilimitado](https://broadrouter.com/pt/guides/unlimited-llm-api-sessions/) roda uma requisição por vez. Rodar `Promise.all` com vários agentes exige uma sessão por agente; caso contrário, as requisições entram em fila.

## Termos neste guia

[Streaming](https://broadrouter.com/pt/glossary/streaming/)

Streaming é uma forma de devolver a resposta de um modelo de linguagem em pequenos pedaços enquanto ela ainda está sendo gerada, em vez de uma resposta única no final. APIs compatíveis com a OpenAI fazem streaming via server-sent events quando a requisição define stream como true.

[Tool calling (chamada de ferramentas)](https://broadrouter.com/pt/glossary/tool-calling/)

Tool calling, também chamado de function calling ou chamada de ferramentas, é um recurso de APIs de LLM em que o modelo devolve um pedido estruturado para executar uma função definida pelo desenvolvedor, com argumentos JSON. A aplicação executa a função e devolve o resultado; o modelo nunca executa código sozinho.

[Pagamento por uso (pay-as-you-go)](https://broadrouter.com/pt/glossary/pay-as-you-go/)

Pagamento por uso é um modelo de preço em que você paga só pelo que usa, medido por unidade, como tokens, requisições ou minutos de áudio, sem assinatura nem compromisso mínimo. A maioria das APIs de LLM cobra assim, a partir de um saldo pré-pago ou de uma fatura periódica.

[Rate limit (limite de taxa)](https://broadrouter.com/pt/glossary/rate-limit/)

Um rate limit é um teto que uma API impõe a quanto um cliente pode usá-la em um intervalo de tempo, como requisições por minuto ou tokens por minuto. As requisições acima do limite são recusadas, normalmente com HTTP 429 Too Many Requests, até que o uso volte a ficar abaixo dele.

[Concorrência (concurrency)](https://broadrouter.com/pt/glossary/concurrency/)

Concorrência é o número de requisições que um cliente tem em andamento ao mesmo tempo. APIs de LLM muitas vezes a limitam por chave ou por plano, separadamente das requisições por minuto, porque cada requisição aberta ocupa capacidade de GPU até a resposta terminar.

[Saída estruturada (structured output)](https://broadrouter.com/pt/glossary/structured-output/)

Saída estruturada é um recurso de APIs de LLM que restringe a resposta de um modelo a um formato definido pelo desenvolvedor, normalmente um JSON Schema, para que o código consiga interpretá-la de forma confiável. É mais rigorosa que o JSON mode, que garante um JSON válido, mas não uma estrutura específica.

[Base URL (URL base)](https://broadrouter.com/pt/glossary/base-url/)

A base URL é o endereço raiz fixo de uma API, como https://api.example.com/v1, que um cliente coloca antes de cada caminho de endpoint, como /chat/completions. Nos SDKs compatíveis com a OpenAI, trocar a base URL, junto com a chave de API e o ID do modelo, aponta o mesmo código para outro provedor.

[Token](https://broadrouter.com/pt/glossary/token/)

Um token é a unidade de texto que um modelo de linguagem lê e escreve: uma palavra, parte de uma palavra, um sinal de pontuação ou uma sequência de bytes gerada pelo tokenizador do modelo. As APIs de LLM contam, limitam e normalmente cobram o uso em tokens.

## Perguntas frequentes

### Uso @ai-sdk/openai ou @ai-sdk/openai-compatible?

Use @ai-sdk/openai-compatible para APIs de terceiros compatíveis com a OpenAI. Ele chama o endpoint de chat completions, que é o que a BroadNet Inference oferece.

### Por que o texto gerado vem vazio?

Na BroadNet, o raciocínio conta para max\_tokens. Se maxOutputTokens for pequeno, o modelo pode gastar tudo antes de a resposta começar. Aumente o valor ou defina reasoningEffort como low.

### Como recebo o uso de tokens durante o streaming?

Defina includeUsage como true ao criar o provider. A documentação do AI SDK diz que isso adiciona os dados de uso às respostas em streaming. O padrão é false.

### Preciso de uma configuração separada para cada modelo da BroadNet?

Não. Um único provider createOpenAICompatible cobre todos os modelos. Chame broadnet('model-id') ou broadnet.chatModel('model-id') com qualquer ID de modelo de chat da BroadNet.

## Guias relacionados

-   [Como usar o SDK Node.js da OpenAI com a BroadNet Inference](https://broadrouter.com/pt/guides/openai-node-sdk/)
-   [Streaming de chat completions e conexões que caem](https://broadrouter.com/pt/guides/streaming-chat-completions/)
-   [Por que um modelo de raciocínio devolve uma resposta vazia](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/)
-   [Adicionar a BroadNet Inference ao opencode como provedor personalizado](https://broadrouter.com/pt/guides/opencode-custom-provider/)
-   [Todas as ferramentas que funcionam com a BroadNet Inference (em inglês)](https://broadrouter.com/integrations/): SDKs, agentes de programação, interfaces de chat e ferramentas de automação, com as configurações exatas de cada uma

Teste com a sua carga de trabalho real. Contas novas começam com US$ 5 de crédito para Gemma e transcrição. DeepSeek, GLM e Qwen3.8 exigem uma recarga.

[Começar](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-vercel-ai-sdk-openai-compatible&utm_content=page-cta) ·

**Fontes**

-   [Documentação do AI SDK, provedores OpenAI Compatible (conferido em 2026-11-14)](https://ai-sdk.dev/providers/openai-compatible-providers)
-   [Documentação do AI SDK, referência de generateText (conferido em 2026-11-14)](https://ai-sdk.dev/docs/reference/ai-sdk-core/generate-text)
-   [npm, pacote @ai-sdk/openai-compatible (3.x, conferido em 2026-11-14)](https://www.npmjs.com/package/@ai-sdk/openai-compatible)
-   [Referência da API da BroadNet Inference (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-vercel-ai-sdk-openai-compatible&utm_content=sources)
