> ## Documentation Index > Fetch the complete documentation index at: https://docs.mka1.com/llms.txt > Use this file to discover all available pages before exploring further. # Recuperar un elemento de conversación > Obtén un único elemento de una conversación con los IDs proporcionados. ## OpenAPI ````yaml https://apigw.mka1.com/speakeasy.json?language=es get /api/v1/llm/conversations/{conversation_id}/items/{item_id} openapi: 3.1.1 info: title: MKA1 API version: 1.1.0 description: >- La API MKA1 es una API RESTful que proporciona acceso a la plataforma MKA1. Aprende cómo comenzar con la API y el SDK de TypeScript [aquí](https://mka1.apidocumentation.com/guides/getting-started). license: name: Propietario servers: - url: https://apigw.mka1.com description: MKA1 API Gateway - url: / description: Relative server URL (configurable via SDK constructor) security: [] tags: - name: Resource Authorization description: >- Gestiona permisos para recursos LLM. Crea recursos, otorga/revoca permisos y elimina recursos. Solo los propietarios de recursos pueden otorgar, revocar o eliminar permisos. x-displayName: Autorización de Recursos - name: Embeddings description: >- Puntos finales de la API de incrustación de texto para generar representaciones vectoriales del texto. Crea incrustaciones semánticas para búsqueda, agrupamiento y coincidencia de similitudes utilizando varios modelos de incrustación. x-displayName: Incrustaciones - name: Feedback description: >- API de retroalimentación del usuario para calificar y comentar sobre las completaciones de chat. Recopila calificaciones de pulgares arriba/abajo y comentarios detallados para mejorar las respuestas del modelo y rastrear la satisfacción del usuario. x-displayName: Retroalimentación - name: Images description: >- Puntos finales de la API de generación de imágenes para crear imágenes a partir de descripciones de texto. Genera imágenes con control sobre el tamaño, la calidad y el estilo. x-displayName: Imágenes - name: MCP Vault description: >- API de bóveda MCP para almacenar configuraciones de servidor MCP propiedad del usuario y credenciales encriptadas. Los agentes hacen referencia a los ID de la bóveda para que los secretos se resuelvan solo en el momento de la ejecución de la herramienta. x-displayName: Bóveda MCP - name: Speech description: >- Puntos finales de la API de voz para el procesamiento de audio. Convierte texto en habla natural (TTS) o transcribe el habla a texto (STT) en diferentes idiomas. x-displayName: Discurso - name: Usage description: >- API de seguimiento de uso y análisis para monitorear el consumo de tokens, la cantidad de solicitudes y el análisis de costos. Visualiza estadísticas detalladas por usuario, modelo y período de tiempo. x-displayName: Uso - name: Extract description: >- API de extracción de datos estructurados para extraer información de archivos. Define esquemas JSON para extraer datos estructurados de imágenes, PDFs y documentos. Soporta plantillas de esquemas reutilizables. x-displayName: Extracción - name: Text Classification description: >- API de clasificación de texto para categorizar texto en etiquetas predefinidas. Utilice modelos de IA para clasificar el contenido del texto para análisis de sentimientos, categorización de temas y moderación de contenido. x-displayName: Clasificación de Texto - name: Responses description: >- API de respuestas impulsadas por agentes para crear agentes de IA con uso autónomo de herramientas. Crea asistentes conversacionales que pueden utilizar búsqueda en la web, operaciones con archivos, generación de imágenes, ejecución de código, simulación de uso de computadoras e integraciones de MCP. Soporta procesamiento en segundo plano, transmisión y seguimiento de estado en tiempo real. x-displayName: Respuestas - name: Files description: >- API de gestión de archivos para cargar, almacenar y gestionar archivos con expiración automática e integración con S3. Carga archivos que se pueden usar con Asistentes, Almacenes Vectoriales y otras funciones. Los archivos se almacenan en S3 con metadatos rastreados en PostgreSQL. Soporta la limpieza automática de archivos expirados. x-displayName: Archivos - name: Vector Stores description: >- API de almacenamiento de vectores para almacenar y buscar documentos utilizando incrustaciones. Crea almacenes de vectores, sube archivos con fragmentación automática y generación de incrustaciones, y realiza búsquedas semánticas. Los archivos se procesan de forma asincrónica utilizando flujos de trabajo de Temporal para durabilidad. Soporta limpieza automática de almacenes caducados y LanceDB para almacenamiento eficiente de vectores. x-displayName: Almacenes de Vectores - name: Conversations description: >- API de gestión de conversaciones para almacenar y recuperar el estado de la conversación a través de llamadas a la API de respuesta. Crea conversaciones, añade elementos (mensajes de usuario, mensajes del asistente, mensajes del sistema) y mantiene el historial de la conversación. Soporta seguimiento de metadatos y gestión del estado del diálogo en múltiples turnos. x-displayName: Conversaciones - name: Guardrails description: >- API de salvaguardias de seguridad de IA para configurar la moderación de contenido y las políticas de seguridad. Configura listas de palabras prohibidas, detección de inyección de mensajes y prevención de filtración de mensajes del sistema. Las salvaguardias se aplican a todas las solicitudes de una cuenta y se pueden probar antes del despliegue. x-displayName: Barandillas - name: Models description: >- API de listado de modelos para descubrir modelos disponibles. Devuelve IDs de modelos, propiedad y metadatos para todos los modelos registrados en la puerta de enlace. x-displayName: Modelos - name: Skills description: >- API de habilidades para gestionar paquetes de instrucciones y archivos versionados siguiendo el estándar de Habilidades del Agente. Crea, versiona y descarga paquetes de habilidades reutilizables que incluyen manifiestos SKILL.md para entornos de agentes. x-displayName: Habilidades - name: Chat Completions description: >- **Obsoleto: Usa la API de Respuestas (`/api/v1/llm/responses`) en su lugar.** Puntos finales de completación de chat con soporte para transmisión, llamadas a herramientas y múltiples proveedores. x-deprecated: true x-displayName: Completaciones de Chat - name: Batches x-displayName: Lotes - name: Evals x-displayName: Evaluaciones - name: Fine-Tuning x-displayName: Ajuste fino - name: Memory Stores x-displayName: Almacenes de memoria - name: Prompts x-displayName: Sugerencias - name: API Key x-displayName: Clave de API - name: Organization x-displayName: Organización - name: Cluster Admin x-displayName: Administrador de clúster - name: Sessions description: Crear, inspeccionar, acceder y terminar sesiones de sandbox. x-displayName: Sesiones - name: Browser description: >- Conéctate a las sesiones del navegador a través del proxy del puerto de la puerta de enlace. Las sesiones del navegador exponen un punto final del Protocolo de DevTools de Chrome en el puerto 9222. x-displayName: Navegador - name: Execution description: >- Ejecutar comandos de shell y código dentro de una sesión de sandbox existente. x-displayName: Ejecución - name: Workspace description: >- Inspeccionar el manifiesto del espacio de trabajo, transferir archivos o archivos comprimidos, y descargar artefactos generados. x-displayName: Espacio de trabajo - name: Sandbox Usage description: >- Agrega estadísticas de uso de sandbox entre sesiones, ejecución y operaciones del espacio de trabajo. x-displayName: Uso de Sandbox - name: Sandbox Pricing description: >- Gestión de administrador de clúster de la tarjeta de tarifas de cómputo del entorno aislado utilizada para el gasto presupuestado. x-displayName: Precios de Sandbox - name: Agents description: Crea y gestiona definiciones de agentes reutilizables. x-displayName: Agentes - name: Agent Versions description: >- Inspeccionar el historial de configuración de un agente y revertir a una versión anterior. x-displayName: Versiones de Agente - name: Agent Runs description: >- Ejecutar agentes guardados e inspeccionar los resultados de ejecución persistidos. x-displayName: Ejecuta Agentes - name: Agent Schedules description: >- Crea y gestiona ejecuciones de agentes programadas o recurrentes guardadas. x-displayName: Horarios de Agentes - name: schema-4_other x-displayName: otro - name: Budgets x-displayName: Presupuestos - name: Settings x-displayName: Configuración - name: Deployments description: Servidores de inferencia de larga duración. x-displayName: Implementaciones - name: Fine-Tune Jobs description: Enviar, monitorear y cancelar trabajos de ajuste fino. x-displayName: Trabajos de ajuste fino - name: Container Images description: Imágenes de contenedor personalizadas para implementaciones y trabajos. x-displayName: Imágenes de contenedores - name: Serving Models description: Modelos registrados para implementación y ajuste fino. x-displayName: Sirviendo modelos - name: Volumes description: Almacenamiento persistente para pesos y puntos de control. x-displayName: Volúmenes - name: Secrets description: Credenciales inyectadas en tus cargas de trabajo. x-displayName: Secretos - name: Accelerators description: Tipos de aceleradores disponibles (GPU, NPU, TPU). x-displayName: Aceleradores paths: /api/v1/llm/conversations/{conversation_id}/items/{item_id}: get: tags: - Conversations summary: Recuperar un elemento de conversación description: Obtén un único elemento de una conversación con los IDs proporcionados. operationId: conversations.items.retrieve parameters: - name: conversation_id in: path required: true schema: type: string description: La ID de la conversación example: conv_abc123 - name: item_id in: path required: true schema: type: string description: El ID del artículo example: item_abc123 - name: X-On-Behalf-Of in: header required: false schema: type: string description: Optional external end-user identifier forwarded by the API gateway. responses: '200': description: Está bien content: application/json: schema: anyOf: - allOf: - $ref: '#/components/schemas/InputMessage' - type: object properties: id: type: string description: The unique ID of the message. response_id: anyOf: - type: string - type: 'null' description: >- The ID of the response that created this item, if any. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: >- Metadata from the response that created this item, if any. required: - id - $ref: '#/components/schemas/OutputMessageWithId' - $ref: '#/components/schemas/OutputAudioItemWithId' - $ref: '#/components/schemas/FileSearchToolCallWithId' - $ref: '#/components/schemas/ComputerToolCallWithId' - $ref: '#/components/schemas/ComputerToolCallOutputWithId' - $ref: '#/components/schemas/WebSearchToolCallWithId' - $ref: '#/components/schemas/FunctionToolCallWithId' - $ref: '#/components/schemas/FunctionToolCallOutputWithId' - $ref: '#/components/schemas/ReasoningWithId' - $ref: '#/components/schemas/ImageGenerationCallWithId' - $ref: '#/components/schemas/CodeInterpreterToolCallWithId' - $ref: '#/components/schemas/LocalShellCallWithId' - $ref: '#/components/schemas/LocalShellCallOutputWithId' - $ref: '#/components/schemas/ShellCallWithId' - $ref: '#/components/schemas/ShellCallOutputWithId' - $ref: '#/components/schemas/MCPListToolsWithId' - $ref: '#/components/schemas/MCPApprovalRequestWithId' - $ref: '#/components/schemas/MCPApprovalResponseWithId' - $ref: '#/components/schemas/MCPToolCallWithId' - $ref: '#/components/schemas/CustomToolCallWithId' - $ref: '#/components/schemas/CustomToolCallOutputWithId' - $ref: '#/components/schemas/ItemReferenceWithId' - $ref: '#/components/schemas/ResponseCompactionItemWithId' example: id: item_abc123 response_id: resp_abc123 type: message role: user content: What is the weather today? security: - bearerAuth: [] x-codeSamples: - lang: python label: Python (SDK) source: |- from meetkai_mka1 import SDK with SDK( bearer_auth="", ) as sdk: res = sdk.llm.conversations.get_item(conversation_id="conv_abc123", item_id="item_abc123") # Handle response print(res) - lang: typescript label: Typescript (SDK) source: |- import { SDK } from "@meetkai/mka1"; const sdk = new SDK({ bearerAuth: "", }); async function run() { const result = await sdk.llm.conversations.getItem({ conversationId: "conv_abc123", itemId: "item_abc123", }); console.log(result); } run(); - lang: csharp label: CSharp (SDK) source: |- using MeetKai.MKA1; using MeetKai.MKA1.Types.Components; var sdk = new SDK(bearerAuth: ""); var res = await sdk.Llm.Conversations.GetItemAsync( conversationId: "conv_abc123", itemId: "item_abc123" ); // handle response components: schemas: InputMessage: type: object properties: type: const: message description: >- El identificador del tipo de artículo. Siempre 'mensaje' para los artículos de mensaje. role: enum: - user - assistant - system - developer type: string description: >- El papel del remitente del mensaje (usuario, asistente, sistema o desarrollador). content: anyOf: - type: string - $ref: '#/components/schemas/InputMessageContent' description: >- El contenido del mensaje. Puede ser una cadena de texto simple o un array de elementos de contenido multimodal (texto, imágenes, archivos, audio). status: $ref: '#/components/schemas/Status' description: >- El estado de procesamiento de este mensaje. Opcional - indica si el mensaje está en progreso, completado o incompleto. id: type: string default: msg_aa87e2b1112a455b8deabed784372198 required: - role - content title: Input message item description: >- Elemento del mensaje de entrada: Un mensaje con rol y contenido. Utiliza esto para turnos de usuario, asistente, sistema o desarrollador en entradas estructuradas. OutputMessageWithId: allOf: - $ref: '#/components/schemas/OutputMessage' - type: object properties: id: type: string description: El ID único del mensaje. response_id: anyOf: - type: string - type: 'null' description: El ID de la respuesta que creó este elemento, si lo hay. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: Metadatos de la respuesta que creó este elemento, si los hay. required: - id OutputAudioItemWithId: allOf: - $ref: '#/components/schemas/OutputAudioItem' - type: object properties: id: type: string description: El ID único del mensaje. response_id: anyOf: - type: string - type: 'null' description: El ID de la respuesta que creó este elemento, si lo hay. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: Metadatos de la respuesta que creó este elemento, si los hay. required: - id FileSearchToolCallWithId: allOf: - $ref: '#/components/schemas/FileSearchToolCall' - type: object properties: id: type: string description: El ID único del mensaje. response_id: anyOf: - type: string - type: 'null' description: El ID de la respuesta que creó este elemento, si lo hay. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: Metadatos de la respuesta que creó este elemento, si los hay. required: - id ComputerToolCallWithId: allOf: - $ref: '#/components/schemas/ComputerToolCall' - type: object properties: id: type: string description: El ID único del mensaje. response_id: anyOf: - type: string - type: 'null' description: El ID de la respuesta que creó este elemento, si lo hay. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: Metadatos de la respuesta que creó este elemento, si los hay. required: - id ComputerToolCallOutputWithId: allOf: - $ref: '#/components/schemas/ComputerToolCallOutput' - type: object properties: id: type: string description: El ID único del mensaje. response_id: anyOf: - type: string - type: 'null' description: El ID de la respuesta que creó este elemento, si lo hay. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: Metadatos de la respuesta que creó este elemento, si los hay. required: - id WebSearchToolCallWithId: allOf: - $ref: '#/components/schemas/WebSearchToolCall' - type: object properties: id: type: string description: El ID único del mensaje. response_id: anyOf: - type: string - type: 'null' description: El ID de la respuesta que creó este elemento, si lo hay. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: Metadatos de la respuesta que creó este elemento, si los hay. required: - id FunctionToolCallWithId: allOf: - $ref: '#/components/schemas/FunctionToolCall' - type: object properties: id: type: string description: El ID único del mensaje. response_id: anyOf: - type: string - type: 'null' description: El ID de la respuesta que creó este elemento, si lo hay. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: Metadatos de la respuesta que creó este elemento, si los hay. required: - id FunctionToolCallOutputWithId: allOf: - $ref: '#/components/schemas/FunctionToolCallOutput' - type: object properties: id: type: string description: El ID único del mensaje. response_id: anyOf: - type: string - type: 'null' description: El ID de la respuesta que creó este elemento, si lo hay. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: Metadatos de la respuesta que creó este elemento, si los hay. required: - id ReasoningWithId: allOf: - $ref: '#/components/schemas/Reasoning' - type: object properties: id: type: string description: El ID único del mensaje. response_id: anyOf: - type: string - type: 'null' description: El ID de la respuesta que creó este elemento, si lo hay. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: Metadatos de la respuesta que creó este elemento, si los hay. required: - id ImageGenerationCallWithId: allOf: - $ref: '#/components/schemas/ImageGenerationCall' - type: object properties: id: type: string description: El ID único del mensaje. response_id: anyOf: - type: string - type: 'null' description: El ID de la respuesta que creó este elemento, si lo hay. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: Metadatos de la respuesta que creó este elemento, si los hay. required: - id CodeInterpreterToolCallWithId: allOf: - $ref: '#/components/schemas/CodeInterpreterToolCall' - type: object properties: id: type: string description: El ID único del mensaje. response_id: anyOf: - type: string - type: 'null' description: El ID de la respuesta que creó este elemento, si lo hay. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: Metadatos de la respuesta que creó este elemento, si los hay. required: - id LocalShellCallWithId: allOf: - $ref: '#/components/schemas/LocalShellCall' - type: object properties: id: type: string description: El ID único del mensaje. response_id: anyOf: - type: string - type: 'null' description: El ID de la respuesta que creó este elemento, si lo hay. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: Metadatos de la respuesta que creó este elemento, si los hay. required: - id LocalShellCallOutputWithId: allOf: - $ref: '#/components/schemas/LocalShellCallOutput' - type: object properties: id: type: string description: El ID único del mensaje. response_id: anyOf: - type: string - type: 'null' description: El ID de la respuesta que creó este elemento, si lo hay. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: Metadatos de la respuesta que creó este elemento, si los hay. required: - id ShellCallWithId: allOf: - $ref: '#/components/schemas/ShellCall' - type: object properties: id: type: string description: El ID único del mensaje. response_id: anyOf: - type: string - type: 'null' description: El ID de la respuesta que creó este elemento, si lo hay. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: Metadatos de la respuesta que creó este elemento, si los hay. required: - id ShellCallOutputWithId: allOf: - $ref: '#/components/schemas/ShellCallOutput' - type: object properties: id: type: string description: El ID único del mensaje. response_id: anyOf: - type: string - type: 'null' description: El ID de la respuesta que creó este elemento, si lo hay. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: Metadatos de la respuesta que creó este elemento, si los hay. required: - id MCPListToolsWithId: allOf: - $ref: '#/components/schemas/MCPListTools' - type: object properties: id: type: string description: El ID único del mensaje. response_id: anyOf: - type: string - type: 'null' description: El ID de la respuesta que creó este elemento, si lo hay. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: Metadatos de la respuesta que creó este elemento, si los hay. required: - id MCPApprovalRequestWithId: allOf: - $ref: '#/components/schemas/MCPApprovalRequest' - type: object properties: id: type: string description: El ID único del mensaje. response_id: anyOf: - type: string - type: 'null' description: El ID de la respuesta que creó este elemento, si lo hay. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: Metadatos de la respuesta que creó este elemento, si los hay. required: - id MCPApprovalResponseWithId: allOf: - $ref: '#/components/schemas/MCPApprovalResponse' - type: object properties: id: type: string description: El ID único del mensaje. response_id: anyOf: - type: string - type: 'null' description: El ID de la respuesta que creó este elemento, si lo hay. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: Metadatos de la respuesta que creó este elemento, si los hay. required: - id MCPToolCallWithId: allOf: - $ref: '#/components/schemas/MCPToolCall' - type: object properties: id: type: string description: El ID único del mensaje. response_id: anyOf: - type: string - type: 'null' description: El ID de la respuesta que creó este elemento, si lo hay. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: Metadatos de la respuesta que creó este elemento, si los hay. required: - id CustomToolCallWithId: allOf: - $ref: '#/components/schemas/CustomToolCall' - type: object properties: id: type: string description: El ID único del mensaje. response_id: anyOf: - type: string - type: 'null' description: El ID de la respuesta que creó este elemento, si lo hay. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: Metadatos de la respuesta que creó este elemento, si los hay. required: - id CustomToolCallOutputWithId: allOf: - $ref: '#/components/schemas/CustomToolCallOutput' - type: object properties: id: type: string description: El ID único del mensaje. response_id: anyOf: - type: string - type: 'null' description: El ID de la respuesta que creó este elemento, si lo hay. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: Metadatos de la respuesta que creó este elemento, si los hay. required: - id ItemReferenceWithId: allOf: - $ref: '#/components/schemas/ItemReference' - type: object properties: id: type: string description: El ID único del mensaje. response_id: anyOf: - type: string - type: 'null' description: El ID de la respuesta que creó este elemento, si lo hay. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: Metadatos de la respuesta que creó este elemento, si los hay. required: - id ResponseCompactionItemWithId: allOf: - $ref: '#/components/schemas/ResponseCompactionItem' - type: object properties: id: type: string description: El ID único del mensaje. response_id: anyOf: - type: string - type: 'null' description: El ID de la respuesta que creó este elemento, si lo hay. metadata: anyOf: - type: object propertyNames: type: string additionalProperties: type: string - type: 'null' description: Metadatos de la respuesta que creó este elemento, si los hay. required: - id InputMessageContent: type: array items: anyOf: - type: string - $ref: '#/components/schemas/InputText' - $ref: '#/components/schemas/InputImage' - $ref: '#/components/schemas/InputFile' - $ref: '#/components/schemas/InputAudio' - $ref: '#/components/schemas/OutputText' - $ref: '#/components/schemas/Refusal' description: >- Array de elementos de contenido para un mensaje multimodal. Puede contener cadenas de texto, objetos de texto, imágenes, archivos, audio o bloques de texto de salida de turnos anteriores del asistente. Status: enum: - in_progress - completed - incomplete type: string description: >- El estado de procesamiento de un artículo individual. 'en_progreso' significa que se está procesando actualmente, 'completado' significa que se completó exitosamente, 'incompleto' significa que el procesamiento se detuvo antes de completarse. OutputMessage: type: object properties: type: const: message description: El identificador de tipo de elemento para las salidas de mensajes. id: type: string description: El identificador único para este mensaje de salida. role: const: assistant description: >- El papel del remitente del mensaje. Siempre 'asistente' para mensajes generados por el modelo. content: type: array items: anyOf: - $ref: '#/components/schemas/OutputText' - $ref: '#/components/schemas/Refusal' description: >- Array de elementos de contenido en la respuesta del asistente. Puede contener salidas de texto o mensajes de rechazo. status: enum: - in_progress - completed - incomplete type: string description: >- El estado de procesamiento de este mensaje (en_proceso, completado o incompleto). phase: enum: - commentary - final_answer type: string description: >- Etiqueta un mensaje del asistente como comentario intermedio o la respuesta final. required: - type - id - role - content - status title: Output message item description: >- Elemento de mensaje de salida: Un mensaje de asistente que contiene contenido de texto generado o contenido de rechazo. OutputAudioItem: type: object properties: type: const: output_audio description: El identificador de tipo de contenido para la salida de audio. data: type: string description: Datos de audio codificados en Base64. transcript: type: string description: La transcripción del texto que se sintetizó en audio. id: type: string description: El identificador único para este elemento de audio de salida. status: enum: - in_progress - completed - incomplete type: string description: El estado de procesamiento de este elemento de audio. required: - type - data - transcript - id - status title: Output audio item description: >- Elemento de audio de salida: Contenido de audio sintetizado a partir de la respuesta de texto del modelo mediante TTS. FileSearchToolCall: type: object properties: type: const: file_search_call id: type: string queries: type: array items: type: string status: enum: - in_progress - searching - completed - incomplete - failed type: string results: type: array items: $ref: '#/components/schemas/FileSearchResult' required: - type - id - queries - status title: File search call item description: >- Elemento de llamada de búsqueda de archivos: Un registro de llamada de herramienta para búsqueda semántica de archivos, que incluye términos de consulta, estado y resultados opcionales. ComputerToolCall: type: object properties: type: const: computer_call id: type: string call_id: type: string action: $ref: '#/components/schemas/ComputerAction' pending_safety_checks: type: array items: $ref: '#/components/schemas/PendingSafetyCheck' status: $ref: '#/components/schemas/Status' required: - type - id - call_id - action - pending_safety_checks - status title: Computer call item description: >- Elemento de llamada de computadora: Un paso de llamada de herramienta de uso de computadora con la acción de interfaz de usuario seleccionada y el estado de verificación de seguridad. ComputerToolCallOutput: type: object properties: type: const: computer_call_output call_id: type: string output: $ref: '#/components/schemas/ComputerScreenshot' acknowledged_safety_checks: type: array items: $ref: '#/components/schemas/AcknowledgedSafetyCheck' id: type: string status: $ref: '#/components/schemas/Status' required: - type - call_id - output title: Computer call output item description: >- Elemento de salida de llamada de computadora: Salida emitida por una llamada de herramienta de uso informático, que típicamente incluye datos de captura de pantalla. WebSearchToolCall: type: object properties: type: const: web_search_call id: type: string action: $ref: '#/components/schemas/WebSearchAction' status: type: string required: - type - id - action - status title: Web search call item description: >- Elemento de llamada de búsqueda web: Un registro de llamada de herramienta de búsqueda web que contiene la acción ejecutada y el estado. FunctionToolCall: type: object properties: type: const: function_call arguments: type: string call_id: type: string name: type: string id: type: string status: $ref: '#/components/schemas/Status' required: - type - arguments - call_id - name title: Function call item description: >- Elemento de llamada a función: Una llamada a una herramienta de función, incluyendo el nombre de la función y los argumentos en formato JSON. FunctionToolCallOutput: type: object properties: type: const: function_call_output call_id: type: string output: type: string id: type: string status: $ref: '#/components/schemas/Status' required: - type - call_id - output title: Function call output item description: >- Elemento de salida de llamada a función: La carga útil de salida devuelta de una llamada a herramienta de función. Reasoning: type: object properties: type: const: reasoning id: type: string summary: type: array items: $ref: '#/components/schemas/SummaryText' content: type: array items: $ref: '#/components/schemas/ReasoningText' encrypted_content: anyOf: - type: string - type: 'null' status: anyOf: - $ref: '#/components/schemas/Status' - type: 'null' required: - type - id - summary title: Reasoning item description: >- Elemento de razonamiento: Metadatos de razonamiento del modelo, incluyendo texto resumido y contenido de razonamiento detallado opcional. ImageGenerationCall: type: object properties: type: const: image_generation_call id: type: string status: type: string result: type: string background: type: string output_format: type: string quality: type: string size: type: string revised_prompt: type: string required: - type - id - status - result title: Image generation call item description: >- Elemento de llamada para generación de imágenes: Un registro de llamada de herramienta para generación de imágenes, incluyendo estado y URL de resultado. CodeInterpreterToolCall: type: object properties: type: const: code_interpreter_call id: type: string code: anyOf: - type: string - type: 'null' container_id: type: string outputs: anyOf: - type: array items: $ref: '#/components/schemas/CodeInterpreterOutput' - type: 'null' status: enum: - in_progress - completed - incomplete - interpreting - failed type: string required: - type - id - code - container_id - outputs - status title: Code interpreter call item description: >- Elemento de llamada del intérprete de código: un registro de llamada de herramienta para la ejecución de código, que incluye código, contenedor, salidas y estado. LocalShellCall: type: object properties: type: const: local_shell_call id: type: string call_id: type: string action: $ref: '#/components/schemas/LocalShellAction' status: type: string required: - type - id - call_id - action - status title: Local shell call item description: >- Elemento de llamada de shell local: Una solicitud de ejecución de shell local con detalles del comando y estado de ejecución. LocalShellCallOutput: type: object properties: type: const: local_shell_call_output id: type: string output: type: string status: $ref: '#/components/schemas/Status' required: - type - id - output title: Local shell call output item description: >- Elemento de salida de llamada a shell local: La carga útil de salida capturada devuelta por una llamada a herramienta de shell local. ShellCall: type: object properties: type: const: shell_call id: type: string call_id: type: string action: $ref: '#/components/schemas/ShellCallAction' status: enum: - in_progress - completed - incomplete type: string required: - type - id - call_id - action - status title: Shell call item description: >- Elemento de llamada de shell: Una solicitud de ejecución de shell de contenedor hospedado con un comando y estado. ShellCallOutput: type: object properties: type: const: shell_call_output id: type: string call_id: type: string output: type: object properties: stdout: type: string description: Salida estándar del comando. stderr: type: string description: Error estándar del comando. outcome: type: object properties: type: enum: - exit - timeout type: string description: Si el comando salió normalmente o se agotó el tiempo. exit_code: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Código de salida del comando, o nulo si se agota el tiempo. required: - type - exit_code required: - stdout - stderr - outcome description: Resultado del comando ejecutado. status: $ref: '#/components/schemas/Status' required: - type - id - call_id - output title: Shell call output item description: >- Elemento de salida de llamada de shell: La salida capturada de una llamada a la herramienta de shell de contenedor alojado. MCPListTools: type: object properties: type: const: mcp_list_tools id: type: string server_label: type: string tools: type: array items: $ref: '#/components/schemas/MCPTool' error: type: string required: - type - id - server_label - tools title: MCP list tools item description: >- Elemento de herramientas de la lista MCP: Resultado de descubrir herramientas disponibles desde un servidor MCP. MCPApprovalRequest: type: object properties: type: const: mcp_approval_request id: type: string arguments: type: string name: type: string server_label: type: string required: - type - id - arguments - name - server_label title: MCP approval request item description: >- Solicitud de aprobación de MCP: Una solicitud para aprobar o denegar la ejecución de una llamada a la herramienta MCP. MCPApprovalResponse: type: object properties: type: const: mcp_approval_response approval_request_id: type: string approve: type: boolean id: type: string reason: type: string required: - type - approval_request_id - approve title: MCP approval response item description: >- Artículo de respuesta de aprobación de MCP: La carga útil de decisión para una solicitud de aprobación de MCP anterior. MCPToolCall: type: object properties: type: const: mcp_call id: type: string arguments: type: string name: type: string server_label: type: string error: type: string output: type: string required: - type - id - arguments - name - server_label title: MCP call item description: >- Elemento de llamada MCP: Un registro de llamada directa para una herramienta MCP, incluyendo argumentos de solicitud y salida/error opcionales. CustomToolCall: type: object properties: type: const: custom_tool_call call_id: type: string input: type: string name: type: string id: type: string required: - type - call_id - input - name title: Custom tool call item description: >- Elemento de llamada de herramienta personalizada: Un registro de llamada para una herramienta personalizada con carga útil de entrada y nombre de herramienta. CustomToolCallOutput: type: object properties: type: const: custom_tool_call_output call_id: type: string output: type: string id: type: string required: - type - call_id - output title: Custom tool call output item description: >- Elemento de salida de la llamada a la herramienta personalizada: La carga útil de salida devuelta por una llamada a la herramienta personalizada. ItemReference: type: object properties: type: const: item_reference default: item_reference id: type: string required: - id title: Item reference item description: 'Referencia de ítem: Un puntero a otro ítem de respuesta por ID.' ResponseCompactionItem: type: object properties: type: const: compaction id: type: string content: type: string description: El contenido de la conversación compactada/resumida. encrypted_content: type: string description: >- Contenido encriptado opcional para compatibilidad con la API de OpenAI. created_by: type: string description: El modelo que creó esta compactación. required: - type - id - content title: Compaction item description: >- Elemento de compactación: Un resumen condensado del historial de conversaciones previas para reducir el tamaño del contexto. InputText: type: object properties: type: const: input_text description: El identificador de tipo de contenido para la entrada de texto. text: type: string description: El contenido del texto para enviar al modelo. required: - type - text title: Input text content item description: >- Elemento de contenido de texto de entrada: Texto plano para enviar al modelo. InputImage: type: object properties: type: const: input_image description: El identificador de tipo de contenido para la entrada de imagen. detail: enum: - high - low - auto type: string default: auto description: >- El nivel de detalle para el procesamiento de imágenes. 'alto' para un análisis detallado (costo más alto), 'bajo' para un análisis básico (costo más bajo), 'automático' permite que el modelo elija según el tamaño de la imagen. Por defecto, es 'automático'. file_id: type: string description: >- La ID de un archivo previamente cargado que contiene la imagen. Mutuamente excluyente con image_url. image_url: type: string description: >- Una URL o URI de datos que apunta a la imagen. Mutuamente excluyente con file_id. required: - type title: Input image content item description: >- Elemento de contenido de imagen de entrada: Entrada de imagen para análisis multimodal. Proporcione ya sea file_id o image_url. InputFile: type: object properties: type: const: input_file description: El identificador de tipo de contenido para la entrada de archivos. file_data: type: string description: >- Datos de archivo codificados en Base64 para cargas de archivos en línea. Excluyente entre sí con file_id y file_url. file_id: type: string description: >- El ID de un archivo previamente cargado. Mutuamente exclusivo con file_data y file_url. file_url: type: string description: >- Una URL que apunta al archivo a procesar. Mutual exclusive con file_data y file_id. filename: type: string description: >- El nombre de archivo original para fines de visualización y referencia. required: - type title: Input file content item description: >- Elemento de contenido del archivo de entrada: Entrada de archivo para el procesamiento de documentos. Proporcione uno de file_data, file_id o file_url. InputAudio: type: object properties: type: const: input_audio description: El identificador de tipo de contenido para la entrada de audio. input_audio: type: object properties: data: type: string description: Datos de audio codificados en Base64 para enviar al modelo. format: enum: - mp3 - wav type: string description: >- El formato/código de audio. Los formatos admitidos son 'mp3' y 'wav'. required: - data - format description: Los datos de audio y su formato. required: - type - input_audio title: Input audio content item description: >- Elemento de contenido de audio de entrada: Entrada de audio para procesamiento de voz y transcripción. OutputText: type: object properties: type: const: output_text description: El identificador de tipo de contenido para la salida de texto. text: type: string description: El contenido de texto generado por el modelo. annotations: type: array items: anyOf: - $ref: '#/components/schemas/FileCitation' - $ref: '#/components/schemas/URLCitation' - $ref: '#/components/schemas/ContainerFileCitation' - $ref: '#/components/schemas/FilePath' default: [] description: >- Array de anotaciones que proporcionan citas y referencias para el texto. Se utiliza para atribuir fuentes y referenciar archivos mencionados en la salida. logprobs: type: array items: $ref: '#/components/schemas/LogProb' required: - type - text description: >- Contenido del texto generado por el modelo con anotaciones opcionales para citas y referencias de archivos. Refusal: type: object properties: type: const: refusal description: >- El identificador de tipo de contenido para las respuestas de rechazo. refusal: type: string description: >- El mensaje de rechazo que explica por qué el modelo se negó a responder a la solicitud. required: - type - refusal description: >- Respuesta de rechazo cuando el modelo se niega a responder debido a políticas de seguridad, moderación de contenido o limitaciones de capacidad. FileSearchResult: type: object properties: attributes: type: object propertyNames: type: string additionalProperties: anyOf: - type: string - type: boolean - type: number file_id: type: string filename: type: string score: type: number text: type: string ComputerAction: anyOf: - $ref: '#/components/schemas/ClickAction' - $ref: '#/components/schemas/DoubleClickAction' - $ref: '#/components/schemas/DragAction' - $ref: '#/components/schemas/KeyPressAction' - $ref: '#/components/schemas/MoveAction' - $ref: '#/components/schemas/ScreenshotAction' - $ref: '#/components/schemas/ScrollAction' - $ref: '#/components/schemas/TypeAction' - $ref: '#/components/schemas/WaitAction' PendingSafetyCheck: type: object properties: code: type: string id: type: string message: type: string required: - code - id - message ComputerScreenshot: type: object properties: type: const: computer_screenshot file_id: type: string image_url: type: string required: - type AcknowledgedSafetyCheck: type: object properties: id: type: string code: type: string message: type: string required: - id WebSearchAction: anyOf: - $ref: '#/components/schemas/SearchAction' - $ref: '#/components/schemas/OpenPageAction' - $ref: '#/components/schemas/FindAction' SummaryText: type: object properties: type: const: summary_text text: type: string required: - type - text ReasoningText: type: object properties: type: const: reasoning_text text: type: string required: - type - text CodeInterpreterOutput: anyOf: - $ref: '#/components/schemas/CodeInterpreterOutputLogs' - $ref: '#/components/schemas/CodeInterpreterOutputImage' LocalShellAction: type: object properties: type: const: exec command: type: array items: type: string env: type: object propertyNames: type: string additionalProperties: type: string timeout_ms: type: integer minimum: -9007199254740991 maximum: 9007199254740991 user: type: string working_directory: type: string required: - type - command - env ShellCallAction: type: object properties: type: const: exec command: type: string description: Comando de shell para ejecutar. timeout_ms: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Tiempo de espera del comando en milisegundos. max_output_length: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Caracteres máximos de salida. required: - type MCPTool: type: object properties: name: type: string input_schema: type: object propertyNames: type: string additionalProperties: {} annotations: type: object propertyNames: type: string additionalProperties: {} description: type: string required: - name - input_schema FileCitation: type: object properties: type: const: file_citation description: El identificador de tipo de anotación para citas de archivos. file_id: type: string description: La ID del archivo que se cita. filename: type: string description: El nombre del archivo que se cita. index: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- El índice de carácter en el texto de salida donde se aplica esta cita. required: - type - file_id - filename - index description: >- Anotación para citar un archivo específico en la salida del modelo. Se utiliza cuando el modelo hace referencia a información de un archivo. URLCitation: type: object properties: type: const: url_citation description: El identificador de tipo de anotación para citas de URL. end_index: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: El índice de carácter donde termina el texto citado en la salida. start_index: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: El índice de carácter donde comienza el texto citado en la salida. title: type: string description: El título de la página web o recurso que se está citando. url: type: string description: La URL del recurso web que se está citando. required: - type - end_index - start_index - title - url description: >- Anotación para citar una URL web en la salida del modelo. Se utiliza cuando el modelo hace referencia a información de fuentes web. ContainerFileCitation: type: object properties: type: const: container_file_citation description: >- El identificador de tipo de anotación para citaciones de archivos contenedores. container_id: type: string description: >- La ID del contenedor (por ejemplo, contenedor de intérprete de código) donde reside el archivo. end_index: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: El índice de carácter donde termina el texto citado en la salida. file_id: type: string description: El ID del archivo dentro del contenedor que se está citando. filename: type: string description: El nombre del archivo que se cita. start_index: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: El índice de carácter donde comienza el texto citado en la salida. required: - type - container_id - end_index - file_id - filename - start_index description: >- Anotación para citar un archivo dentro de un contenedor específico (como un espacio de trabajo de intérprete de código). Se utiliza cuando el modelo menciona archivos generados durante ejecuciones de herramientas. FilePath: type: object properties: type: const: file_path description: >- El identificador de tipo de anotación para las referencias de ruta de archivo. file_id: type: string description: El ID del archivo al que se hace referencia. index: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- El índice de carácter en el texto de salida donde se aplica esta referencia de ruta de archivo. required: - type - file_id - index description: >- Anotación para hacer referencia a una ruta de archivo en la salida del modelo. Se utiliza cuando el modelo menciona archivos específicos. LogProb: type: object properties: token: type: string logprob: type: number bytes: type: array items: type: number top_logprobs: type: array items: $ref: '#/components/schemas/TopLogProb' required: - token - logprob - bytes - top_logprobs ClickAction: type: object properties: type: const: click button: enum: - left - right - wheel - back - forward type: string x: type: integer minimum: -9007199254740991 maximum: 9007199254740991 'y': type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - type - button - x - 'y' DoubleClickAction: type: object properties: type: const: double_click x: type: integer minimum: -9007199254740991 maximum: 9007199254740991 'y': type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - type - x - 'y' DragAction: type: object properties: type: const: drag path: type: array items: type: object properties: x: type: integer minimum: -9007199254740991 maximum: 9007199254740991 'y': type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - x - 'y' required: - type - path KeyPressAction: type: object properties: type: const: keypress keys: type: array items: type: string required: - type - keys MoveAction: type: object properties: type: const: move x: type: integer minimum: -9007199254740991 maximum: 9007199254740991 'y': type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - type - x - 'y' ScreenshotAction: type: object properties: type: const: screenshot required: - type ScrollAction: type: object properties: type: const: scroll scroll_x: type: integer minimum: -9007199254740991 maximum: 9007199254740991 scroll_y: type: integer minimum: -9007199254740991 maximum: 9007199254740991 x: type: integer minimum: -9007199254740991 maximum: 9007199254740991 'y': type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - type - scroll_x - scroll_y - x - 'y' TypeAction: type: object properties: type: const: type text: type: string required: - type - text WaitAction: type: object properties: type: const: wait required: - type SearchAction: type: object properties: type: const: search query: type: string sources: type: array items: $ref: '#/components/schemas/SearchActionSource' required: - type - query OpenPageAction: type: object properties: type: const: open_page url: type: string required: - type - url FindAction: type: object properties: type: const: find pattern: type: string url: type: string required: - type - pattern - url CodeInterpreterOutputLogs: type: object properties: type: const: logs logs: type: string required: - type - logs CodeInterpreterOutputImage: type: object properties: type: const: image url: type: string required: - type - url TopLogProb: type: object properties: token: type: string logprob: type: number bytes: type: array items: type: number required: - token - logprob - bytes SearchActionSource: type: object properties: type: const: url url: type: string required: - type - url securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- Gateway auth: send `Authorization: Bearer `. For multi-user server-side integrations, you can also send `X-On-Behalf-Of: `. ````