Crear salidas estructuradas

POST

/v1/chat/completions

• Use response_format para especificar un JSON Schema que restrinja la estructura de salida
• Compatible con el modo json_schema y strict: true para seguir el schema estrictamente
• Respuesta sin streaming; reciba la finalización conforme al schema de una vez
• Documentación oficial: Structured Outputs

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

Modelo a utilizar. Consulte la tabla de compatibilidad de modelos con la API Chat.

object[]

Required

Lista de mensajes de la conversación hasta el momento.

Temperatura de muestreo entre 0 y 2. Valores altos (p. ej. 0,8) hacen la salida más aleatoria; bajos (p. ej. 0,2) más enfocada. Suele recomendarse cambiar esto o top_p, no ambos.

Nucleus sampling alternative to temperature. The model considers tokens with top_p probability mass (e.g. 0.1 = top 10%). We generally recommend changing this or temperature, but not both.

Por defecto 1. Cuántas opciones de finalización generar por mensaje de entrada.

Default false. For structured outputs, omit or set false to receive the full schema-compliant completion in one response.

Por defecto null. Hasta 4 secuencias donde la API deja de generar tokens.

Default inf. Maximum tokens to generate in the completion.

Total length of input + output tokens is limited by the model context length.

Número entre -2,0 y 2,0. Valores positivos penalizan tokens nuevos según si ya aparecieron, favoreciendo temas nuevos. Más información

Por defecto 0. Entre -2,0 y 2,0. Valores positivos penalizan según frecuencia en el texto, reduciendo repeticiones.

Modify the likelihood of specified tokens appearing in the completion.
Accepts a JSON object mapping token IDs to bias values from -100 to 100. Applied to logits before sampling; effect varies by model.

Identificador único del usuario final. Ayuda a OpenAI a detectar abusos. Más información

Objeto que especifica el formato de salida. { "type": "json_object" } activa el modo JSON. En modo JSON, también debe indicar al modelo que genere JSON en mensajes system/user. Con json_schema, proporcione un schema y strict: true opcional para Structured Outputs.

Beta. Si se define, el sistema intenta muestrear de forma determinista; supervise cambios con system_fingerprint en la respuesta.

Lista de herramientas que el modelo puede invocar. Actualmente solo funciones como herramientas.

Control de función: none = ninguna; auto = el modelo elige; forzar con {"type": "function", "function": {"name": "my_function"}}. Por defecto none sin funciones, si no auto.