"
Navegación principal
API
Referencia API
Codex
ChatGPT
Recursos
Buscar documentos
Sugerido
formato_de_respuesta
esfuerzo_de_razonamiento
streaming
herramientas
Comienza aquí
Descripción general
Inicio rápido
Modelos
Precios
Último: GPT-5.5
Guía de prompts
Conceptos básicos
Generación de texto
Generación de código
Imágenes y visión
Audio y voz
Salida estructurada
Llamada de funciones
API de respuestas
Uso de herramientas
SDK de agentes
Descripción general
Inicio rápido
Definiciones de agentes
Modelos y proveedores
Ejecutando agentes
Agentes en sandbox
Orquestación
Barreras de protección
Resultados y estado
Integraciones y observabilidad
Evalúa flujos de trabajo de agentes
Agentes de voz
Herramientas
Búsqueda web
MCP y conectores
Habilidades
Shell
Uso del ordenador
Búsqueda de herramientas
Ejecuta y escala
Estado de la conversación
Modo en segundo plano
Streaming
Modo WebSocket
Tu información
Entradas de archivos
Evaluación
Primeros pasos
Trabajar con evaluaciones
Webhooks
Modelos externos
Buenas prácticas
Tiempo real y audio
Resumen
Agentes de voz
Traducción en vivo
Generación de voz
Guía de prompts en tiempo real
Optimización de modelos
Ciclo de optimización
Evaluadores
Modelos especializados
Generación de imágenes
Generación de video
Investigación profunda
Embeddings
Moderación
Publicación en producción
Buenas prácticas en producción
Lista de verificación de despliegue
Optimización de precisión
APIs heredadas
Recursos
Términos y políticas
Registro de cambios
Tus datos
Permisos
Límites de velocidad
APIs de administración
Desuso (deprecaciones)
MCP para investigación profunda
Modo de desarrollador
Inicio rápido para desarrolladores
Da tus primeros pasos con la API de OpenAI.
Copiar página
La API de OpenAI ofrece una interfaz sencilla para modelos de IA de vanguardia para generación de texto, procesamiento de lenguaje natural, visión por computadora y más. Empieza creando una clave de API y ejecutando tu primera llamada a la API. Descubre cómo generar texto, analizar imágenes, crear agentes y más.
Crea con la API de OpenAI en Codex
El plugin de OpenAI Developers permite que Codex se conecte a la Plataforma de OpenAI, siga la guía de configuración de la API de OpenAI y cree claves de API de proyecto cuando tu app las necesite.
Crea y exporta una clave de API
Antes de comenzar, crea una clave de API en el panel, que usarás para acceder a la API de forma segura. Guarda la clave en un lugar seguro, como un archivo .zshrc o en otro archivo de texto en tu computadora. Una vez que hayas generado una clave de API, expórtala como una variable de entorno en tu terminal.
macOS / Linux
Windows
Exporta una variable de entorno en sistemas macOS o Linux
export OPENAI_API_KEY="your_api_key_here"
Los SDK de OpenAI se configuran para leer automáticamente tu clave de API desde el entorno del sistema.
Instala el SDK de OpenAI y ejecuta una llamada a la API
JavaScript
Python
.NET
Java
Ir
Para usar la API de OpenAI en entornos de JavaScript del lado del servidor como Node.js, Deno o Bun, puedes usar el SDK oficial de OpenAI para TypeScript y JavaScript. Empieza instalando el SDK con npm o con tu gestor de paquetes preferido:
Instala el OpenAI SDK con npm
npm install openai
Con el OpenAI SDK instalado, crea un archivo llamado example.mjs y copia el código de ejemplo en él:
Prueba una solicitud básica a la API
import OpenAI from "openai";
const client = new OpenAI();
const response = await client.responses.create({
model: "gpt-5.5",
input: "Escribe una historia para la hora de dormir de una sola frase sobre un unicornio."
Constructor de agentes
console.log(response.output_text);
Ejecuta el código con node example.mjs (o el comando equivalente para Deno o Bun). En unos momentos, deberías ver la salida de tu solicitud a la API.
Más información en GitHub
Descubre más capacidades y opciones del SDK en el README de GitHub de la biblioteca.
App inicial de Responses
Comienza a construir con la Responses API.
Generación de texto y prompts
Más información sobre prompts, roles de mensajes y la creación de apps conversacionales.
Agrega créditos para seguir construyendo
¡Felicidades por ejecutar una solicitud de prueba de API gratis! Empieza a construir aplicaciones reales con límites más altos y usa nuestros modelos para generar texto, audio, imágenes, videos y más.
Accede a funciones del panel diseñadas para ayudarte a entregar más rápido:
Playground de chat
Crea y prueba prompts conversacionales y embédelos en tu aplicación.
Agent Builder
Construye, despliega y optimiza flujos de trabajo de agentes.
Analiza imágenes y archivos
Envía URLs de imágenes, archivos subidos o documentos PDF directamente al modelo para extraer texto, clasificar contenido o detectar elementos visuales.
URL de imagen
URL de archivo
Subir archivo
Analiza el contenido de una imagen
import OpenAI from "openai";
const client = new OpenAI();
const response = await client.responses.create({
model: "gpt-5.5",
input: [
{
role: "user",
content: [
{
type: "input_text",
text: "¿Qué hay en esta imagen?",
},
{
type: "input_image",
image_url: "https://openai-documentation.vercel.app/images/cat_and_otter.png",
},
],
},
],
});
console.log(response.output_text);
Guía de entradas de imagen
Aprende a usar entradas de imagen para el modelo y extraer el significado de las imágenes.
Optimizer de prompts
Guía de entradas de archivos
Aprende a usar entradas de archivos para el modelo y extraer el significado de los documentos.
Amplía el modelo con herramientas
Dale al modelo acceso a datos y funciones externas adjuntando herramientas. Usa herramientas integradas como búsqueda web o búsqueda de archivos, o define las tuyas para llamar APIs, ejecutar código o integrarte con sistemas de terceros.
Búsqueda web
Búsqueda de archivos
Llamadas a funciones
MCP remoto
Usa búsqueda web en una respuesta
import OpenAI from "openai";
const client = new OpenAI();
const response = await client.responses.create({
model: "gpt-5.5",
tools: [
{ type: "web_search" },
],
input: "¿Qué historia positiva de noticias hubo hoy?",
});
console.log(response.output_text);
Usa herramientas integradas
Conoce herramientas integradas potentes como la búsqueda web y la búsqueda de archivos.
Guía de llamadas a funciones
Aprende a permitir que el modelo llame a tu propio código personalizado.
Transmite respuestas y crea apps en tiempo real
Usa eventos de streaming con servidor para mostrar resultados a medida que se generan, o la Realtime API para apps de voz y multimodales interactivas.
Transmite eventos desde el API
import { OpenAI } from "openai";
const client = new OpenAI();
const stream = await client.responses.create({
model: "gpt-5.5",
input: [
{
role: "user",
content: "Di 'double bubble bath' diez veces seguidas.",
},
],
stream: true,
});
for await (const event of stream) {
console.log(event);
}
Usa eventos de streaming
Usa eventos de servidor para transmitir respuestas del modelo a los usuarios rápidamente.
Empieza con la Realtime API
Usa WebRTC o WebSockets para apps de IA de reconocimiento y respuesta de voz ultrarrápidas.
Crea agentes
Usa la plataforma de OpenAI para crear agentes capaces de tomar acción—como controlar ordenadores—en nombre de tus usuarios. Usa el Agents SDK para crear la lógica de orquestación en el backend.
Crea un agente de triaje de idioma
import { Agent, run } from '@openai/agents';
const spanishAgent = new Agent({
name: 'Agente de español',
instructions: 'Solo hablas español.',
});
const englishAgent = new Agent({
name: 'Agente de inglés',
instructions: 'Solo hablas inglés',
});
const triageAgent = new Agent({
name: 'Agente de triaje',
instructions:
'Entrega al agente adecuado según el idioma de la solicitud.',
handoffs: [spanishAgent, englishAgent],
});
const result = await run(triageAgent, 'Hola, ¿cómo estás?');
console.log(result.finalOutput);
Crea agentes que puedan tomar acción
Aprende cómo usar la plataforma de OpenAI para construir agentes de IA potentes y capaces."
https://developers.openai.com/api/docs/quickstart#:~:text=Primary%20navigation,capable%20AI%20agents.sync/https://developers.openai.com/api/docs/quickstart#:~:text=Primary%20navigation,capable%20AI%20agents.https://openai-documentation.vercel.app/images/cat_and_otter.png-/manus.space/code/command/deploy$BTC