Compatível com OpenAI

Use um modelo com Vercel AI SDK por meio do IteraCompute.

Crie experiências de IA em TypeScript.

A promoção gratuita termina em 24 de novembro de 2026 às 00:00, horário do Pacífico dos EUA. Usuários com recarga líquida positiva creditada antes do prazo mantêm seu nível gratuito. Após o prazo, o Auto gratuito compartilhado fica limitado a esses usuários e a assinantes com plano vigente. Recargas posteriores não concedem nem ampliam os benefícios gratuitos. Os tokens Auto do plano e os benefícios gratuitos mensais compartilhados são cotas independentes.

Conecte-se em três etapas

1. Crie uma chave API

Crie ou faça login em sua conta IteraCompute e, em seguida, crie uma chave no Console.

2. Configure o URL base

Crie um provedor compatível com OpenAI com o baseURL IteraCompute e passe seu modelo para generateText.

3. Selecione o modelo

Use o ID do modelo de API exato para o modelo escolhido.Verifique seu contexto e recursos antes de ativar recursos de agente ou visão.

Escolha seu modelo

Configuração de exemplo

Mantenha as chaves de API em seu ambiente de servidor ou armazenamento de credenciais de ferramentas.Substitua o campo-chave de exemplo pela sua própria chave, quando aplicável.

exemplo.mjs · Node.js 22+
import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
import { generateText } from "ai";

if (!process.env.ITERACOMPUTE_API_KEY) {
  throw new Error("Set ITERACOMPUTE_API_KEY on the server.");
}
const itera = createOpenAICompatible({
  name: "iteracompute",
  baseURL: "https://api.iteracompute.com/v1",
  apiKey: process.env.ITERACOMPUTE_API_KEY,
});
const { text } = await generateText({
  model: itera("Auto"),
  prompt: "Reply with exactly: Hello!",
  maxOutputTokens: 512,

});
if (!text.trim()) throw new Error("Empty model reply: activation is incomplete.");
console.log(text);

Teste a conexão

cURL · Conclusões de bate-papo
# Bash / zsh / WSL; set ITERACOMPUTE_API_KEY in your environment first.
curl --fail-with-body https://api.iteracompute.com/v1/chat/completions \
  -H "Authorization: Bearer $ITERACOMPUTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"Auto","messages":[{"role":"user","content":"Reply with exactly: Hello!"}],"max_tokens":512}'

Verifique se choices[0].message.content contém texto visível;O HTTP 200 por si só é insuficiente.O raciocínio pode consumir o orçamento de produção.Para Qwen grátis, use o exemplo da primeira chamada gratuita à API para desativar o pensamento e envie um prompt dentro de sua ferramenta.

Primeira chamada gratuita à API

  1. Entre na conta e confirme que ela pode usar o Auto conforme os requisitos abaixo.
  2. Crie uma chave que permita Auto e salve o segredo exibido uma única vez.Abrir API Keys
  3. Escolha seu shell abaixo e substitua your-api-key pela sua chave.
Auto

Bash no macOS, Linux ou WSL requer cURL e Python 3. Mantenha response.json local.

export ITERACOMPUTE_API_KEY="your-api-key"

curl --fail-with-body --max-time 180 https://api.iteracompute.com/v1/chat/completions \
  -H "Authorization: Bearer $ITERACOMPUTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"Auto","messages":[{"role":"user","content":"Reply with exactly: Hello!"}],"max_tokens":512,"reasoning":false}' \
  -o response.json && python3 -c 'import json; r=json.load(open("response.json")); text=r["choices"][0]["message"]["content"]; assert text and text.strip(), "Empty model reply: activation is incomplete"; print(text)'

O teste tem sucesso quando choices[0].message.content contém texto não vazio. Este comando imprime o texto e falha se a resposta estiver vazia; cadastrar-se ou receber HTTP 200 não basta para concluir a ativação. Saída esperada: Hello! (o texto pode variar).

Este exemplo Auto desativa o pensamento para uma resposta curta e visível.401/403: verifique a chave e a permissão do modelo.429: verifique o uso mensal e as solicitações em andamento no Console e, em seguida, repita Retry-After.A capacidade livre pode ficar em fila;não dispare repetidas tentativas paralelas.

Execute o exemplo mínimo completo

Bash · setup and run
mkdir itera-ai-example
cd itera-ai-example
npm init -y
npm install ai@7.0.137 @ai-sdk/openai-compatible@3.0.67
export ITERACOMPUTE_API_KEY="your-api-key"
# Save the example above as example.mjs
node example.mjs

Use Node.js 22 ou mais recente.Execute example.mjs no servidor.Mantenha a chave em uma variável de ambiente do servidor ou em segredo de implantação;nunca use NEXT_PUBLIC_ ou VITE_ para isso, envie um arquivo .env ou chame a API do código do navegador.Este exemplo usa conclusões de bate-papo com Qwen grátis;sua opção de pensamento é específica para Auto.

Saída de exemplo
Hello!

Versão e verificação

Versão testada
ai 7.0.137 · @ai-sdk/openai-compatible 3.0.67 · Node.js 25.2.1
Resultado
Geração de texto no servidor aprovada.

Capacidades do modelo selecionado

As capacidades descrevem a API da IteraCompute. A disponibilidade também depende da ferramenta e de suas configurações; os controles de raciocínio variam por modelo.

  • Conclusões de bate-papoSuportado
  • Chamada de ferramentaSuportado
  • RaciocínioSuportado
  • Entrada de imagemSuportado
  • TransmissãoSuportado

Solução de problemas

401 / 403

Verifique a chave de API e a permissão para Auto.O nível gratuito não requer saldo ou cartão.Outros modelos podem exigir saldo pago.

404/Ponto final errado

Use OpenAI compatível, o URL base /v1 e exatamente Auto.Use conclusões de bate-papo;não assuma suporte de respostas.Qwen3.8-Max é um modelo diferente e pago.

400 / Contexto ou resposta vazia

Para Gratuito, a entrada mais a saída máxima solicitada devem conter 131.072 tokens.Reduza arquivos/histórico anexados ou orçamento de produção.HTTP 200 com conteúdo vazio está incompleto;experimente o breve exemplo da chamada gratuita, que desativa o pensamento.

429 / Limites gratuitos

Verifique o uso mensal de toda a conta e as solicitações em andamento no console.Honre o Retry-After e evite novas tentativas paralelas.Cota esgotada não tem excedente pago automaticamente;aguarde a redefinição mensal do UTC ou desbloqueie um nível superior com uma recarga.

401/403: verifique a chave e a permissão do modelo.O Qwen grátis não requer saldo ou cartão.Para modelos pagos, verifique também o saldo disponível.

Referência de configuração do Vercel AI SDK →

Comece a construir com Vercel AI SDK.

Conecte sua chave, escolha um modelo e envie sua primeira solicitação.