Configuración de la API de Astra con autenticación oficial de OpenAI

Empieza por el proveedor y la cuenta de facturación

Usa gpt-6-astra mediante la API de OpenAI con tu propia clave de OpenAI Platform. Para una aplicación, empieza con el ejemplo de Responses que aparece abajo. Para trabajar con código local, usa los comandos de inicio de sesión y selección de modelo de Codex CLI. Ambas vías utilizan tu cuenta de Platform y generan cargos de API según las tarifas aplicables de OpenAI.

Antes de ejecutar una solicitud, confirma quién es el propietario del proyecto de Platform, si su clave puede acceder al modelo y qué controles de facturación se aplican. Que un modelo aparezca en ChatGPT o Codex no concede acceso a todos los proyectos de API. Mantén separados en tus notas el inicio de sesión de suscripción y el inicio de sesión con clave de API. Esa distinción es esencial para diagnosticar después un límite o conciliar cargos.

Prepara la clave y el cliente en un entorno de confianza

Crea una clave de API en el panel de OpenAI y proporciónala como OPENAI_API_KEY mediante tu entorno privado o un gestor de secretos. El SDK oficial lee esa variable. Nunca incrustes la clave en JavaScript del navegador, un repositorio público, una captura de pantalla ni una transcripción de terminal compartida. Evita el trazado del shell mientras manejas credenciales.

Para el ejemplo de JavaScript de abajo, instala el paquete oficial openai en tu proyecto con npm install openai. Registra la versión instalada en tu lockfile. El baseURL explícito selecciona OpenAI en lugar de un endpoint personalizado heredado. Revisa también la configuración existente del agente: una sobreescritura del proveedor y una credencial de otro servicio no se vuelven compatibles solo porque ambos acepten una cabecera Authorization.

Envía una solicitud de Responses y lee la respuesta

Crea astra-example.mjs con el código siguiente y ejecuta después node astra-example.mjs. El prompt solicita una lista breve para que puedas inspeccionar la respuesta recibida antes de conectar un flujo de trabajo más grande. Los reintentos automáticos del SDK están desactivados para esta primera solicitud, lo que facilita diagnosticar errores de conexión o de cuenta.

Cuando el estado sea completed, response.output_text contiene la salida de texto combinada del SDK. Imprímela en la salida estándar para que otro programa pueda consumirla o redirigirla a un archivo. Envía los metadatos de la respuesta a la salida de error estándar para mantenerlos separados de la respuesta. En respuestas incompletas, conserva incomplete_details y usage y devuelve un código de salida distinto de cero.

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: 'https://api.openai.com/v1',
  maxRetries: 0,
})
const response = await client.responses.create({
  model: 'gpt-6-astra',
  input: 'List three checks for a small code change.',
})
console.error(JSON.stringify({
  id: response.id,
  model: response.model,
  status: response.status,
  usage: response.usage,
  incomplete_details: response.incomplete_details,
}))
if (response.status === 'completed') {
  console.log(response.output_text)
} else {
  process.exitCode = 1
}

Selecciona la autenticación mediante clave de API para Codex local

OpenAI documenta el inicio de sesión mediante clave de API para trabajar con Codex localmente. En la CLI, consulta el estado de codex login antes de cambiar las credenciales. El comando documentado que aparece abajo usa stdin y evita pegar un secreto como argumento del comando. Después de iniciar sesión, vuelve a comprobar el método de autenticación activo y selecciona el modelo exacto con el indicador de modelo de la CLI.

El comando final abre una sesión interactiva con Astra seleccionado. Iníciala en el directorio de tu proyecto para que el agente pueda leer los archivos correctos y las instrucciones del repositorio. Revisa las sobreescrituras de proveedor existentes y confirma la cuenta activa. El modo de clave de API admite el trabajo local; Codex cloud requiere autenticación de ChatGPT. Para continuar localmente una tarea en la nube, lleva primero a tu proyecto local los archivos de trabajo y un resumen breve de lo que queda por hacer.

codex login status
printenv OPENAI_API_KEY | codex login --with-api-key
codex login status
codex --model gpt-6-astra

Ajusta las capacidades a la ruta del cliente

Astra admite Responses y Chat Completions, pero las llamadas a herramientas requieren Responses. Usa Responses para un agente que ejecute funciones o herramientas personalizadas. Un cliente escrito para leer chat choices no puede interpretar la salida de Responses cambiando solo la URL, y una prueba de texto aislada no ejercita un ciclo de herramientas.

Añade una capacidad cada vez mediante un ejemplo pequeño de tu aplicación. Para las herramientas, valida los argumentos, ejecuta la función en tu aplicación y devuelve el resultado mediante Responses con el call_id correspondiente. Para la salida estructurada, valida el esquema y gestiona las respuestas incompletas. Para streaming, procesa tanto los eventos de finalización y cancelación como el texto. Mantén disponible la solicitud de texto simple como ruta de diagnóstico mientras incorporas estas funciones.

Diagnostica por separado los fallos de acceso, velocidad y finalización

Usa el estado HTTP y los campos de error estructurados antes de reintentar. La guía de errores de OpenAI distingue la autenticación no válida, los créditos agotados, los límites de gasto aplicados y la presión sobre la tasa de solicitudes. En particular, una respuesta 429 no basta para elegir un remedio: inspecciona error.code y la configuración de cuenta pertinente.

Ante una presión temporal sobre la tasa, respeta Retry-After cuando esté presente y usa reintentos acotados. Los fallos de facturación o de límite de gasto requieren una decisión sobre la cuenta, no solicitudes repetidas. Un resultado de Responses marcado como incomplete es otra condición y puede haber consumido tokens. Conserva la información de error redactada y el uso; no conviertas un timeout o un recibo ausente en un intento exitoso o gratuito.

Disponibilidad del proveedor y evidencia: 5 de septiembre de 2026

OpenAI ha anunciado GPT-6 Astra con un despliegue gradual y su referencia del modelo documenta la API oficial. Los ejemplos de aquí siguen esas fuentes; para esta guía no se ejecutó ninguna solicitud de pago ni ningún cambio de autenticación de Codex. La comprobación del catálogo público de APIsRouter del 5 de septiembre de 2026 devolvió HTTP 200, success: true y 34 modelos, sin ninguna entrada de Astra o GPT-6.

Usa las credenciales de OpenAI únicamente con el endpoint oficial mostrado arriba. Comprueba el catálogo en vivo de APIsRouter para conocer sus propias ofertas. Una inclusión posterior de Astra seguiría requiriendo comprobar su ID exacto de modelo, precio y funciones necesarias del cliente antes de usarla en tu aplicación.

Conecta la respuesta con un flujo de trabajo local útil

Elige una tarea local con un resultado concreto, como explicar una función y proponer una prueba. Proporciona al agente la ruta del archivo pertinente, el comportamiento esperado y el comando de prueba. Después de un cambio de código, inspecciona el diff y ejecuta las pruebas específicas. Conserva juntos el input original y la respuesta devuelta para comparar fácilmente las revisiones.

En una aplicación, pasa el texto completado a tu pantalla de revisión o canalización documental. Si el siguiente paso espera datos legibles por máquina, usa una salida estructurada y valida los campos obligatorios antes de almacenarlos. Conserva la identidad y el uso de la solicitud junto a la tarea y establece una política de reintentos acotada. Amplía el flujo de trabajo después de que funcionen conjuntamente sus comprobaciones básicas de entrada, manejo de respuesta y finalización.

Preguntas frecuentes