Especificación de la API

Envía una primera solicitud, selecciona un modelo del catálogo y conserva un identificador de solicitud para el diagnóstico.

Envía una clave API en una cabecera Bearer y mantén separadas las credenciales de producción y desarrollo.

Usa URL base distintas para clientes de estilo OpenAI y Messages: apuntan a la misma especificación, pero componen las rutas de forma diferente.

Configura un cliente con clave, modelo y URL base que coincida con su protocolo; guarda el secreto en el entorno.

Respuestas prácticas breves sobre claves, URL base, modelos, coste y diagnóstico de integraciones.

Crea la selección de modelos a partir de datos del catálogo, no de una lista fija en tu aplicación.

Separa claves, propietarios, presupuestos y trazas de uso entre aplicaciones y espacios de trabajo.

Trata los límites de clave, organización, modelo y enrutamiento como parte del flujo del usuario.

Relaciona los metadatos de respuesta y tus propios registros de solicitudes con acciones reales del usuario.

Minimiza los datos transmitidos, separa el identificador del usuario final del contenido y controla la retención en tu producto.

Crea conversaciones de varios turnos con el formato messages habitual y selecciona un modelo en cada solicitud.

Usa el formato Messages para conversaciones con una instrucción system de nivel superior y un límite de salida explícito.

Usa un único objeto de entrada cuando tu aplicación se beneficie de gestionar elementos de salida y acciones en un solo modelo de datos.

Recibe tokens y deltas estructurados por SSE sin esperar la respuesta completa.

Describe funciones con JSON Schema, ejecuta la llamada en tu aplicación y devuelve el resultado a la conversación.

Solicita un objeto JSON o un JSON Schema cuando la respuesta vaya a ser consumida por software y no por una persona.

Establece el esfuerzo de razonamiento por solicitud solo para modelos que declaren esta capacidad.

Expresa los requisitos de ejecución en las preferencias de proveedor y conserva el resultado real para fines de observabilidad.

Separa el contexto recurrente para que el cliente pueda usar caché compatible cuando el modelo elegido lo admita.

Recupera fuentes recientes mediante una función `web_search` ejecutada por el cliente y mantén los enlaces separados del texto generado.

Carga un archivo mediante una operación específica, conserva su ID y pasa una referencia en una solicitud compatible posterior.

Crea imágenes mediante una sola ruta y selecciona parámetros según las capacidades del modelo elegido.

Inicia el vídeo como trabajo asíncrono, conserva su ID y separa la creación de la lectura del resultado.

Usa operaciones separadas para síntesis de voz, transcripción y entrada de audio a un modelo.

Transforma texto o entradas compatibles en vectores para búsqueda, agrupación y recomendaciones.

Reordena un conjunto pequeño de candidatos frente a una consulta para mejorar la precisión de la recuperación final.

Procesa operaciones independientes en grupos controlados cuando el flujo permita la entrega asíncrona.

Conecta un cliente de IA a herramientas, recursos e indicaciones permitidos mediante una URL de conexión emitida en la configuración de la cuenta.

Basa la gestión en el estado HTTP, un cuerpo de error estructurado y el ID de solicitud, no en el texto del mensaje.