1. Crie uma chave API
Crie ou faça login em sua conta IteraCompute e, em seguida, crie uma chave no Console.
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.
Crie ou faça login em sua conta IteraCompute e, em seguida, crie uma chave no Console.
Crie um provedor compatível com OpenAI com o baseURL IteraCompute e passe seu modelo para generateText.
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.
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.
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);# 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.
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)'Windows PowerShell 5.1 ou PowerShell 7+. Usa comandos integrados; não requer WSL, cURL ou Python.
$env:ITERACOMPUTE_API_KEY = "your-api-key"
$body = @{
model = "Auto"
messages = @(@{ role = "user"; content = "Reply with exactly: Hello!" })
max_tokens = 512
reasoning = $false
} | ConvertTo-Json -Depth 5
$response = Invoke-RestMethod -Method Post `
-Uri "https://api.iteracompute.com/v1/chat/completions" `
-Headers @{ Authorization = "Bearer $env:ITERACOMPUTE_API_KEY" } `
-ContentType "application/json" -Body $body -TimeoutSec 180 -ErrorAction Stop
$text = $response.choices[0].message.content
if ([string]::IsNullOrWhiteSpace($text)) {
throw "Empty model reply: activation is incomplete"
}
$textO 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.
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.mjsUse 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.
Hello!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.
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.
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.
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.
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.
Conecte sua chave, escolha um modelo e envie sua primeira solicitação.