Compatível com OpenAI

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

Crie experiências de IA em TypeScript.

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("qwen/qwen3.8-27b"),
  prompt: "Reply with exactly: Hello!",
  maxOutputTokens: 512,
  providerOptions: { iteracompute: { chat_template_kwargs: { enable_thinking: false } } },
});
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":"qwen/qwen3.8-27b","messages":[{"role":"user","content":"Reply with exactly: Hello!"}],"max_tokens":512}'

Verifique se options[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 primeiro exemplo de chamada gratuita para desativar o pensamento e envie um prompt dentro de sua ferramenta.

Primeira chamada gratuita

  1. Registre-se e verifique seu e-mail ou faça login no Google.Não é necessário cartão ou recarga.
  2. Abra as chaves de API, crie uma chave que permita qwen/qwen3.8-27b e salve o segredo mostrado uma vez.
  3. Execute isso no Bash (macOS, Linux ou WSL) com cURL e Python 3. Substitua your-api-key pela sua chave.Mantenha o response.json local.
Bash · Qwen3.8-27B · $0
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":"qwen/qwen3.8-27b","messages":[{"role":"user","content":"Reply with exactly: Hello!"}],"max_tokens":512,"chat_template_kwargs":{"enable_thinking":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)'

Sucesso significa escolhas não vazias[0].message.content.Este comando imprime e falha em uma resposta vazia;o registro ou o HTTP 200 por si só não completam a ativação.Resultado esperado: Olá!(o texto pode variar).

Este exemplo Qwen 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 o TPM 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 · configurar e executar
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 Qwen3.8-27B.

Verificado em 11 de outubro de 2026 com Node.js 25.2.1, ai 7.0.137 e @ai-sdk/openai-compatível 3.0.67.Resultado real da API: Olá!(espaço em branco inicial omitido).A amostra verifica se há uma resposta não vazia.O exemplo é executado como um aplicativo CLI do lado do servidor.

Saída padrão real · 11 de outubro de 2026
Hello!

Capacidades do modelo selecionado

Estes são recursos de API do modelo selecionado.A disponibilidade de recursos no seu fluxo de trabalho também depende da ferramenta e de suas configurações;os controles de raciocínio variam de acordo com o 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 qwen/qwen3.8-27b.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 qwen/qwen3.8-27b.Use conclusões de bate-papo;não assuma suporte de respostas.Qwen3.8-2.4T-A95B é 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 o TPM 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.