Repolode
Enviar
openai

openai/openai-java

SDK oficial de Java y Kotlin para la API REST de OpenAI, con clientes síncronos y asíncronos, streaming y clases tipadas para solicitudes y respuestas.

Ver en GitHub
Estrellas
1,554
Forks
272
Issues abiertos
66
Último commit
hace 7 horas

¿Qué es?

openai-java es la biblioteca oficial de Java para llamar a la API de OpenAI desde aplicaciones Java. Expone los endpoints REST mediante builders tipados y clases de respuesta, para que los desarrolladores trabajen con objetos Java en lugar de escribir JSON manualmente. El principal punto de entrada es la Responses API, y también es compatible con la Chat Completions API.

El cliente está disponible en versiones síncrona y asíncrona, y los métodos de streaming devuelven flujos de fragmentos que se pueden procesar a medida que llegan los datos. Las clases auxiliares acumulan las respuestas parciales de chat y las respuestas transmitidas hasta reconstruir objetos completos. Es posible generar automáticamente salidas estructuradas a partir de clases Java simples, con anotaciones opcionales de Jackson y Swagger para definir el esquema JSON generado.

El SDK también permite configurar el cliente mediante propiedades del sistema o variables de entorno, autenticarse con workload identity en Kubernetes, Azure y GCP, y usar un artefacto opcional para llamar a API compatibles con OpenAI en Amazon Bedrock.

Funciones clave

  • 01Builders tipados de Java y clases de respuesta para las API Responses y Chat Completions.
  • 02Clientes síncronos y asíncronos; los métodos asíncronos devuelven CompletableFuture.
  • 03Streaming mediante SSE, con clases auxiliares que acumulan los fragmentos para formar respuestas completas.
  • 04Generación de salidas estructuradas a partir de clases Java, con validación local del esquema JSON.
  • 05Autenticación con workload identity para Kubernetes, Azure y GCP.

Casos de uso

  • Incorporar generación de texto con OpenAI a un servicio backend de Java o Kotlin.
  • Transmitir la salida del modelo a un cliente web o de escritorio a medida que se genera.
  • Extraer datos estructurados de las respuestas del modelo y convertirlos en objetos de dominio de Java.
  • Llamar desde una aplicación Java a modelos compatibles con OpenAI en Amazon Bedrock.

Inicio rápido

  1. 1

    Añade la dependencia de Gradle

    implementation("com.openai:openai-java:4.90.0")
  2. 2

    Crea un cliente a partir de variables de entorno

    OpenAIClient client = OpenAIOkHttpClient.fromEnv();

Antes de usarlo

  • Los ejemplos del README usan la variable de entorno OPENAI_API_KEY, por lo que necesitas una clave de API de OpenAI para realizar solicitudes.

Temas

#openai#java#sdk#llm#streaming#structured-outputs#kotlin

Preguntas frecuentes

¿Qué es openai-java?
SDK oficial de Java y Kotlin para la API REST de OpenAI, con clientes síncronos y asíncronos, streaming y clases tipadas para solicitudes y respuestas. openai-java es la biblioteca oficial de Java para llamar a la API de OpenAI desde aplicaciones Java. Expone los endpoints REST mediante builders tipados y clases de respuesta, para que los desarrolladores trabajen con objetos Java en lugar de escribir JSON manualmente. El principal punto de entrada es la Responses API, y también es compatible con la Chat Completions API.
¿openai-java es gratuito? ¿Qué licencia tiene?
openai-java es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿openai-java sigue mantenido?
Mantenimiento activo. El último commit de openai-java fue el 22 oct 2026.
¿Para qué puedo usar openai-java?
Incorporar generación de texto con OpenAI a un servicio backend de Java o Kotlin. Transmitir la salida del modelo a un cliente web o de escritorio a medida que se genera. Extraer datos estructurados de las respuestas del modelo y convertirlos en objetos de dominio de Java. Llamar desde una aplicación Java a modelos compatibles con OpenAI en Amazon Bedrock.
¿Cómo se instala openai-java?
Añade la dependencia de Gradle: implementation("com.openai:openai-java:4.90.0") Crea un cliente a partir de variables de entorno: OpenAIClient client = OpenAIOkHttpClient.fromEnv();
¿Dónde consigo openai-java?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/openai/openai-java

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados