O Vercel AI SDK com um URL base personalizado

Todos os modelos, chat completions

npm install ai @ai-sdk/openai-compatible

Modelos Claude, protocolo Anthropic

npm install ai @ai-sdk/anthropic

import { createOpenAI } from '@ai-sdk/openai';

const openai = createOpenAI({
  baseURL: 'https://aigrow.gg/v1',
  apiKey: 'ag_your_key_here',
});

const model = openai.chat('gpt-6-astra');

import { createAnthropic } from '@ai-sdk/anthropic';
import { generateText } from 'ai';

const anthropic = createAnthropic({
  baseURL: 'https://aigrow.gg/v1',
  apiKey: 'ag_your_key_here',
});

const { text } = await generateText({
  model: anthropic('claude-opus-5.5'),
  prompt: 'Reply with the word ready',
});

404 em /v1/responses

O modelo veio de openai(...) em @ai-sdk/openai, que chama a Responses API. Use createOpenAICompatible como no bloco, ou openai.chat(...).

404 no fornecedor Anthropic

O baseURL perdeu o /v1. O fornecedor Anthropic acrescenta apenas /messages, por isso o seu baseURL é https://aigrow.gg/v1.

Os pedidos continuam a ir para a OpenAI

A importação openai já pronta usa OPENAI_BASE_URL ou, na falta dela, api.openai.com. Crie o seu próprio fornecedor com o baseURL, como no bloco.

A minha ferramenta indica 401 ou erro de autenticação

A chave está em falta ou foi escrita incorretamente. Copie-a de novo em Acesso à API no painel e certifique-se de que é enviada como chave, e não como nome de modelo. Uma chave revogada falha da mesma forma: crie uma nova e substitua-a.

Recebo 402 ou uma mensagem sobre crédito

O seu saldo está vazio. Abra Acesso à API no painel, resgate um código ou compre outro pacote e o pedido seguinte será processado. Não é preciso mudar mais nada.

Aparece 404 ou Unknown model

O modelo tem de ser um dos que o endpoint disponibiliza, por exemplo claude-opus-5.5. A grafia própria do fornecedor também funciona (claude-opus-5-5, anthropic/claude-opus-5.5), mas um id com data ou qualquer modelo fora do catálogo é rejeitado antes de o pedido ser encaminhado e nada é cobrado. Peça GET /v1/models com a sua chave para obter a lista atual, ou consulte os ids na lista de preços.

Os pedidos são rejeitados com 429

A capacidade do endpoint é partilhada por todos os clientes: cerca de 20 pedidos por minuto e 4 em simultâneo. Cada resposta 429 inclui um cabeçalho retry-after, e os SDKs da OpenAI e da Anthropic esperam esse tempo e voltam a tentar por conta própria. Num ciclo seu, aguarde os segundos indicados ou reduza a concorrência.

O modelo está indisponível neste momento

Um 404 que indica que o modelo não está disponível neste momento significa que ele está brevemente em baixo no fornecedor de origem, e não um problema com a sua chave ou saldo. Tente novamente daqui a pouco ou envie o pedido para outro modelo.

Recebo um 502 ou 503

Uma falha transitória na origem ou na configuração, sem qualquer cobrança no seu saldo. Repita o pedido; se continuar a falhar, contacte-nos através da loja e vamos analisar.

O Vercel AI SDK é faturado por token às taxas de crédito da lista de preços. Um agente volta a enviar a conversa inteira a cada passo, por isso uma tarefa longa custa mais do que a última mensagem sugere; o registo de atividade em Acesso à API mostra quanto custou cada pedido.

Como defino um URL base personalizado no Vercel AI SDK?

Crie um fornecedor com createOpenAICompatible a partir de @ai-sdk/openai-compatible, com baseURL definido como https://aigrow.gg/v1 e apiKey definido como a sua chave, e depois passe-lhe um id de modelo, como claude-opus-5.5.

Porque é que o @ai-sdk/openai dá erro 404 com um URL base personalizado?

Desde o AI SDK 5, openai(...) chama a Responses API em /v1/responses. O endpoint disponibiliza apenas chat completions, por isso crie o modelo com openai.chat(...) ou use o fornecedor OpenAI Compatible.

O fornecedor Anthropic aceita um baseURL personalizado?

Sim. O createAnthropic aceita baseURL, cujo valor por defeito é https://api.anthropic.com/v1, pelo que para a AIGROW é https://aigrow.gg/v1. Defina apiKey ou authToken com a sua chave.

O streamText e as chamadas de ferramentas funcionam?

Sim. O streamText faz streaming nos dois fornecedores, e as ferramentas que define com tool() são enviadas como chamadas de função que o seu código executa. includeUsage: true acrescenta a contagem de tokens a um resultado em streaming.

Fontes: Vercel AI SDK OpenAI Compatible provider · Vercel AI SDK OpenAI provider · Vercel AI SDK Anthropic provider. Consultado em 21 de outubro de 2026.