Compatible con OpenAI

Utilice un modelo con Vercel AI SDK a través de IteraCompute.

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.

Conéctate en tres pasos

1. Cree una clave API

Cree o inicie sesión en su cuenta IteraCompute, luego cree una clave en la consola.

2. Configurar la URL base

Cree un proveedor compatible con OpenAI con IteraCompute baseURL y pase su modelo a generateText.

3. Selecciona el modelo

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.

Elige tu modelo

Configuración de ejemplo

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.

ejemplo.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);

Pruebe la conexión

cURL · Finalizaciones de chat
# 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.

Primera llamada gratuita a la API

  1. Inicie sesión y confirme que su cuenta puede usar Auto según los requisitos indicados más abajo.
  2. Crea una clave que permita Auto y guarda el secreto que se muestra una sola vez.Abrir API Keys
  3. Elige tu consola abajo y sustituye your-api-key por tu clave.
Auto

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)'

La 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.

Ejecute el ejemplo 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

Utilice 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.

Salida de ejemplo
Hello!

Versión y verificación

Versión probada
ai 7.0.137 · @ai-sdk/openai-compatible 3.0.67 · Node.js 25.2.1
Resultado
Generación de texto en el servidor aprobada.

Capacidades del modelo seleccionado

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.

  • Finalizaciones de chatApoyado
  • Llamada de herramientasApoyado
  • RazonamientoApoyado
  • Entrada de imagenApoyado
  • TransmisiónApoyado

Solución de problemas

401 / 403

Verifique la clave API y el permiso para Auto.El nivel gratuito no requiere saldo ni tarjeta.Otros modelos pueden requerir saldo pagado.

404 / Punto final incorrecto

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.

400 / Contexto o respuesta vacía

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.

429 / Límites libres

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.

Referencia de configuración del SDK de AI de Vercel →

Comience a construir con Vercel AI SDK.

Conecte su clave, elija un modelo y envíe su primera solicitud.