28/1/23, 12:22 Quickstart tutorial - OpenAI API

Inicio rápido
OpenAI ha entrenado modelos de lenguaje de vanguardia que son muy
buenos para comprender y generar texto. Nuestra API brinda acceso a estos
modelos y puede usarse para resolver prácticamente cualquier tarea que
involucre lenguaje de procesamiento.

En este tutorial de inicio rápido, creará una aplicación de muestra simple. En

el camino, aprenderá conceptos y técnicas clave que son fundamentales para
usar la API para cualquier tarea, que incluyen:

Generación de contenido
resumen
Clasificación, categorización y análisis de sentimiento
Extracción de datos
Traducción
¡Mucho mas!

Introducción
El punto final de finalización es el núcleo de nuestra API y proporciona una
interfaz simple que es extremadamente flexible y poderosa. Ingresa un texto
como mensaje y la API devolverá un texto completo que intenta coincidir con
las instrucciones o el contexto que le dio.

Oportuno Escribe un eslogan para una heladería.

Terminación ¡Servimos sonrisas con cada primicia!

Puede pensar en esto como un autocompletado muy avanzado: el modelo

procesa su mensaje de texto e intenta predecir lo que es más probable que

https://beta.openai.com/docs/quickstart 1/8
28/1/23, 12:22 Quickstart tutorial - OpenAI API

ocurra a continuación.

1 Comience con una instrucción

Imagina que quieres crear un generador de nombres de mascotas. ¡Inventar
nombres desde cero es difícil!

Primero, necesitará un aviso que deje en claro lo que quiere. Comencemos

con una instrucción. Envíe este aviso para generar su primera finalización.

Suggest one name for a horse.

¡No está mal! Ahora, intente hacer su instrucción más específica.

Suggest one name for a black horse.

Como puede ver, agregar un simple adjetivo a nuestro indicador cambia la

finalización resultante. Diseñar su indicador es esencialmente cómo
"programa" el modelo.

2 Agrega algunos ejemplos

Elaborar buenas instrucciones es importante para obtener buenos resultados,
pero a veces no es suficiente. Intentemos hacer su instrucción aún más
compleja.

Suggest three names for a horse that is a superhero.

Esta finalización no es exactamente lo que queremos. Estos nombres son

bastante genéricos, y parece que el modelo no captó la parte del caballo de

https://beta.openai.com/docs/quickstart 2/8
28/1/23, 12:22 Quickstart tutorial - OpenAI API

nuestra instrucción. Veamos si podemos hacer que presente algunas

sugerencias más relevantes.

En muchos casos, es útil mostrar y decirle al modelo lo que quiere. Agregar

ejemplos a su aviso puede ayudar a comunicar patrones o matices. Intente
enviar este mensaje que incluye un par de ejemplos.

Suggest three names for an animal that is a superhero.

Animal: Cat
Names: Captain Sharpclaw, Agent Fluffball, The Incredible
Feline
Animal: Dog
Names: Ruff the Protector, Wonder Canine, Sir Barks-a-Lot
Animal: Horse

¡Bonito! Agregar ejemplos de la salida que esperaríamos para una entrada

dada ayudó al modelo a proporcionar los tipos de nombres que buscábamos.

3 Ajusta tu configuración
El diseño rápido no es la única herramienta que tiene a su disposición.
También puede controlar las finalizaciones ajustando su configuración. Uno
de los ajustes más importantes se llama temperatura .

Es posible que haya notado que si envió el mismo aviso varias veces en los
ejemplos anteriores, el modelo siempre devolvería resultados idénticos o muy
similares. Esto se debe a que su temperatura se fijó en 0 .

Intente volver a enviar el mismo aviso varias veces con la temperatura

establecida en 1 .

La temperatura 1

https://beta.openai.com/docs/quickstart 3/8
28/1/23, 12:22 Quickstart tutorial - OpenAI API

Suggest three names for an animal that is a superhero.

Animal: Cat
Names: Captain Sharpclaw, Agent Fluffball, The Incredible
Feline
Animal: Dog
Names: Ruff the Protector, Wonder Canine, Sir Barks-a-Lot
Animal: Horse
Names:

¿Ves lo que pasó? Cuando la temperatura está por encima de 0, enviar el

mismo aviso da como resultado diferentes finalizaciones cada vez.

Recuerde que el modelo predice qué texto es más probable que siga al texto
que lo precede. La temperatura es un valor entre 0 y 1 que esencialmente le
permite controlar la confianza que debe tener el modelo al hacer estas
predicciones. Bajar la temperatura significa que se correrán menos riesgos y
las terminaciones serán más precisas y deterministas. El aumento de la
temperatura dará como resultado terminaciones más diversas.

BUCEAR PROFUNDO

Entendiendo tokens y probabilidades

Para su generador de nombres de mascotas, probablemente desee poder

generar muchas ideas de nombres. Una temperatura moderada de 0,6
debería funcionar bien.

4 Cree su aplicación

NODO.JS PITÓN (FRASCO)

https://beta.openai.com/docs/quickstart 4/8
28/1/23, 12:22 Quickstart tutorial - OpenAI API

Ahora que ha encontrado un buen aviso y configuración, ¡está listo para

construir su generador de nombres de mascotas! Hemos escrito un código
para que pueda comenzar: siga las instrucciones a continuación para
descargar el código y ejecutar la aplicación.

Configuración
Si no tiene instalado Node.js, instálelo desde aquí . Luego descargue el código
clonando este repositorio .

git clone https://github.com/openai/openai-quickstart-node.git

Si prefiere no usar git, también puede descargar el código usando este

archivo zip .

Agrega tu clave API

Navegue al directorio del proyecto y haga una copia del archivo de variables
de entorno de ejemplo.

cd openai-quickstart-node
cp .env.example .env

Copie su clave API secreta y configúrela como en su archivo

OPENAI_API_KEY recién creado . .env Si aún no ha creado una clave secreta,
puede hacerlo a continuación.

Actualmente no tiene ninguna clave API. Crea uno a continuación.

Crear nuevaclave

Nota importante: al usar Javascript, todas las llamadas a la API deben

realizarse solo en el lado del servidor, ya que hacer llamadas en el código del

https://beta.openai.com/docs/quickstart 5/8
28/1/23, 12:22 Quickstart tutorial - OpenAI API

navegador del lado del cliente expondrá su clave de API. Vea aquí para más
detalles.

Ejecute la aplicación
Ejecute los siguientes comandos en el directorio del proyecto para instalar las
dependencias y ejecutar la aplicación.

npm install
npm run dev

Abra http://localhost:3000 en su navegador y debería ver el generador de

nombres de mascotas.

entender el código
Abrir generate.js en la openai-quickstart-node/pages/api carpeta. En la
parte inferior, verá la función que genera el aviso que estábamos usando
arriba. Dado que los usuarios ingresarán el tipo de animal que es su mascota,
cambia dinámicamente la parte del aviso que especifica el animal.

1 function generatePrompt(animal) {
2 const capitalizedAnimal = animal[0].toUpperCase() + anima
3 return `Suggest three names for an animal that is a super
4
5 Animal: Cat
6 Names: Captain Sharpclaw, Agent Fluffball, The Incredible F
7 Animal: Dog
8 Names: Ruff the Protector, Wonder Canine, Sir Barks-a-Lot
9 Animal: ${capitalizedAnimal}
10 Names:`;
11 }

https://beta.openai.com/docs/quickstart 6/8
28/1/23, 12:22 Quickstart tutorial - OpenAI API

En la línea 9 de generate.js , verá el código que envía la solicitud de API

real. Como se mencionó anteriormente, utiliza el punto final de finalización
con una temperatura de 0,6.

1 const completion = await openai.createCompletion({

2 model: "text-davinci-003",
3 prompt: generatePrompt(req.body.animal),
4 temperature: 0.6,
5 });

¡Y eso es! ¡Ahora debería tener una comprensión completa de cómo su

generador de nombres de mascotas (superhéroes) usa la API de OpenAI!

Clausura
Estos conceptos y técnicas le ayudarán en gran medida a crear su propia
aplicación. Dicho esto, ¡este simple ejemplo demuestra solo una pequeña
parte de lo que es posible! El punto final de finalización es lo suficientemente
flexible como para resolver prácticamente cualquier tarea de procesamiento
de lenguaje, incluida la generación de contenido, el resumen, la búsqueda
semántica, el etiquetado de temas, el análisis de sentimientos y mucho más.

Una limitación a tener en cuenta es que, para la mayoría de los modelos , una
sola solicitud de API solo puede procesar hasta 2048 tokens
(aproximadamente 1500 palabras) entre su aviso y su finalización.

BUCEAR PROFUNDO

Modelos y precios

Para tareas más avanzadas, es posible que desee proporcionar más ejemplos
o contexto de los que puede incluir en un solo mensaje. La API de ajuste fino
es una excelente opción para tareas más avanzadas como esta. El ajuste fino

https://beta.openai.com/docs/quickstart 7/8
28/1/23, 12:22 Quickstart tutorial - OpenAI API

le permite proporcionar cientos o incluso miles de ejemplos para personalizar

un modelo para su caso de uso específico.

Próximos pasos
Para inspirarse y obtener más información sobre el diseño de avisos para
diferentes tareas:

Lea nuestra guía de finalización .

https://beta.openai.com/docs/quickstart 8/8