Crear una respuesta
Genera resultados de modelos con la API de respuestas compatible con OpenAI.
Utiliza la forma de la API de respuestas para la entrada de modelos de texto o estructurada y un objeto de salida unificado.
/openai/v1/responsesCuerpo de la solicitud
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
model | string | Sí | Identificador del modelo enrutado por AnyInt. |
input | string o array | Sí | Elementos de entrada de texto o estructurados. |
stream | boolean | No | Devuelve eventos enviados por el servidor cuando sea compatible. |
reasoning.effort | string | No | Esfuerzo dependiente del modelo, reenviado sin reducción silenciosa. |
tools | array | No | Declaraciones de herramientas, incluyendo herramientas personalizadas. |
Respuesta
Una solicitud completada devuelve un objeto de respuesta con un identificador, estado y salida generada.
Historial de herramientas y validación
Las llamadas a herramientas personalizadas y las salidas de herramientas de varias partes conservan su orden y texto Unicode. Se proporcionan matrices vacías annotations y logprobs para las partes output_text del asistente cuando se omiten o son nulas, de modo que un retransmisor no pueda reconstruirlas como metadatos nulos no válidos. Los mensajes de keep-alive del proveedor se excluyen del historial de conversación.
La compatibilidad con el esfuerzo de razonamiento depende del modelo seleccionado y del proveedor upstream. Un rechazo estructurado identifica el campo, por ejemplo error.code: "invalid_value" y error.param: "reasoning.effort". Los rechazos de formato no localizables o generados por retransmisión devuelven un error upstream en lugar de marcar el historial válido del cliente como incorrecto.
Transmisión y recuperación
Las transmisiones exitosas terminan con response.completed; los límites de salida pueden terminar con response.incomplete. Un fallo upstream, tiempo de espera agotado o EOF anticipado produce response.failed. Las transmisiones fallidas no reciben un terminal exitoso fabricado ni un marcador heredado [DONE]. Verifique el evento terminal incluso cuando el estado HTTP sea 200. Un fallo terminal de transmisión no autoriza la repetición automática del trabajo enviado.
Los latidos utilizan comentarios SSE. Los eventos response.metadata del proveedor y los elementos SSE-Keep-Alive se filtran. Los valores de sequence_number aumentan monótonamente.
Los encabezados opcionales x-client-message-id y x-resume-message-id habilitan la recuperación por desplazamiento de eventos. x-anyint-resume-offset-unit: sse-event describe ese desplazamiento; x-anyint-stream-replayed: true identifica una repetición. Los clientes que no habiliten esta función pueden ignorar estos encabezados de extensión.
Alias de compatibilidad
Los clientes existentes pueden continuar usando /v1/responses. Las nuevas integraciones deben usar /openai/v1/responses.