1. Cree una clave API
Cree o inicie sesión en su cuenta IteraCompute, luego cree una clave en la consola.
Cree experiencias de IA en TypeScript.
La promoción gratuita termina el 24 de noviembre de 2026 a las 00:00, hora del Pacífico de EE. UU. Quienes tengan una recarga neta positiva acreditada antes del cierre conservan su nivel gratuito. Después, el Auto gratuito compartido queda limitado a estos usuarios y a quienes tengan un plan vigente. Las recargas posteriores no otorgan ni mejoran los beneficios gratuitos. Los tokens Auto del plan y los beneficios gratuitos mensuales compartidos son cuotas independientes.
Cree o inicie sesión en su cuenta IteraCompute, luego cree una clave en la consola.
Cree un proveedor compatible con OpenAI con IteraCompute baseURL y pase su modelo a generateText.
Utilice el ID de modelo API exacto para el modelo elegido.Verifique su contexto y capacidades antes de habilitar las funciones de agente o visión.
Mantenga las claves API en su entorno de servidor o almacén de credenciales de herramientas.Reemplace el campo clave de ejemplo con su propia clave cuando corresponda.
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}'Compruebe que choices[0].message.content contenga texto visible;HTTP 200 por sí solo es insuficiente.El razonamiento puede consumir el presupuesto de producción.Para Qwen gratis, utiliza el ejemplo de la primera llamada gratuita a la API para desactivar el pensamiento, luego envíe un mensaje dentro de su herramienta.
Bash en macOS, Linux o WSL requiere cURL y Python 3. Conserva response.json localmente.
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 o PowerShell 7+. Usa comandos integrados; no requiere WSL, cURL ni 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"
}
$textLa prueba tiene éxito cuando choices[0].message.content contiene texto no vacío. Este comando lo imprime y falla si la respuesta está vacía; registrarse o recibir HTTP 200 no basta para completar la activación. Salida esperada: Hello! (el texto puede variar).
Este ejemplo de Auto desactiva el pensamiento para una respuesta breve y visible.401/403: verifique la clave y el permiso del modelo.429: verifique el uso mensual y las solicitudes simultáneas en la consola, luego respete el Retry-After.La capacidad libre puede hacer cola;no realice repetidos intentos paralelos.
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.mjsUtilice Node.js 22 o posterior.Ejecute example.mjs en el servidor.Mantenga la clave en una variable de entorno del servidor o en un secreto de implementación;nunca use NEXT_PUBLIC_ o VITE_ para ello, confirme un archivo .env ni llame a la API desde el código del navegador.Este ejemplo utiliza Finalizaciones de chat con Qwen gratuito;su opción de pensamiento es específica de Auto.
Hello!Las capacidades describen la API de IteraCompute. Su disponibilidad también depende de la herramienta y su configuración; los controles de razonamiento varían según el modelo.
Verifique la clave API y el permiso para Auto.El nivel gratuito no requiere saldo ni tarjeta.Otros modelos pueden requerir saldo pagado.
Utilice OpenAI Compatible, la URL base /v1 y Auto exactamente.Utilice Finalizaciones de chat;no asuma el soporte de Respuestas.Qwen3.8-Max es un modelo pago diferente.
De forma gratuita, la entrada más la salida máxima solicitada deben caber en 131072 tokens.Reduzca los archivos/historial adjuntos o el presupuesto de salida.HTTP 200 con contenido vacío está incompleto;Pruebe el breve ejemplo de llamada gratuita, que incapacita el pensamiento.
Verifique el uso mensual de toda la cuenta y las solicitudes simultáneas en la consola.Respete el Retry-After y evite los reintentos paralelos.La cuota agotada no tiene exceso pagado automáticamente;Espere el reinicio mensual de UTC o desbloquee un nivel superior con una recarga.
401 / 403: verifique la clave y el permiso del modelo.Qwen gratuito no requiere saldo ni tarjeta.Para modelos pagos, consulta también saldo disponible.
Conecte su clave, elija un modelo y envíe su primera solicitud.