Interfaz de todos los modelos GPT - Referencia completa de Responses

Modelo a invocar:

Entrada del modelo: una cadena simple o un array de elementos de entrada.

El content de un elemento de entrada admite dos tipos de bloque: input_text (texto) e input_image (imagen):

"input": [
  {
    "role": "user",
    "content": [
      { "type": "input_text", "text": "¿Qué hay en esta imagen?" },
      {
        "type": "input_image",
        "image_url": "https://example.com/photo.png",
        "detail": "auto"
      }
    ]
  }
]

Imagen

• Envía en image_url la URL pública de la imagen
• image_url debe ser una cadena; escribirla como { "url": "..." } devuelve 400
• detail está al mismo nivel que image_url (no anidado dentro de él): auto (predeterminado) / low / high / original
• La imagen debe poder descargarse, de lo contrario se devuelve 400

Resultados de herramientas

• El array también puede incluir elementos de resultado de herramientas del turno anterior, como function_call_output

Nota Los tipos de bloque de esta API son distintos de los de la API Chat Completions (que usa text / image_url). No pueden mezclarse; usarlos mal devuelve 400.

Instrucciones de nivel de sistema, equivalentes a insertar un mensaje de sistema al principio de input. Al continuar la conversación con previous_response_id, este parámetro no se hereda del turno anterior y debe enviarse en cada turno.

Indica si se devuelve una respuesta en streaming (eventos SSE que terminan con response.completed). Predeterminado false.

Número máximo de tokens a generar (incluidos los tokens de razonamiento). Al alcanzar el límite, status es incomplete.

GPT-6 Astra / Sol / Luna y GPT-6.1 Sol permiten hasta 128.000 tokens de salida, incluidos los de razonamiento.

Controla la selección de la herramienta: "auto" (predeterminado) / "none" / "required", o un objeto que fija una herramienta concreta, p. ej. {"type": "web_search"}.

Límite máximo del número total de llamadas a herramientas permitidas en esta respuesta (sumando todas las herramientas integradas).

Nota Cuando gpt-6-astra / gpt-6.1-sol / gpt-6-sol / gpt-6-luna usa image_generation y se omite este parámetro, una solicitud puede generar hasta 4 imágenes; configúralo explícitamente si necesitas más.

Si el modelo puede llamar a varias herramientas en paralelo dentro de un mismo turno. El valor predeterminado es true.

GPT-6 Sol / Luna y GPT-6.1 Sol: aún no se ha confirmado la compatibilidad con este parámetro; omítalo en las solicitudes básicas.

Las siguientes reglas de modelos existentes excluyen GPT-6 Sol / Luna y GPT-6.1 Sol:

Nota gpt-6-astra, la familia gpt-5.6 y gpt-5.5 permiten establecer este parámetro en false; en gpt-5.4 / gpt-5.2 / gpt-5.1 no tiene efecto y siempre se comporta como true.

El id de la respuesta anterior, usado para encadenar conversaciones de varios turnos sin volver a enviar el historial.

Nota Debe usarse junto con store: true (el valor predeterminado). Las respuestas tienen un periodo de retención; una vez caducado, ese ID deja de ser válido y la solicitud se trata como una conversación nueva, sin heredar el contexto. En escenarios con requisitos estrictos de exactitud del contexto, se recomienda mantener por tu cuenta el historial completo de input.

Si esta respuesta se conserva en el servidor; solo las respuestas conservadas pueden referenciarse mediante previous_response_id. El valor predeterminado es true.

GPT-6 Sol / Luna y GPT-6.1 Sol: no se ha verificado en los canales disponibles la desactivación de la retención mediante store: false. Aceptar el campo no demuestra que la respuesta no se haya almacenado.

Las siguientes reglas de modelos existentes excluyen GPT-6 Sol / Luna y GPT-6.1 Sol:

Nota gpt-6-astra, la familia gpt-5.6 y gpt-5.5 permiten establecer este parámetro en false; en gpt-5.4 / gpt-5.2 / gpt-5.1 no tiene efecto y siempre se comporta como true. Si no quieres almacenar respuestas, elige un modelo que permita desactivar el almacenamiento.

Temperatura de muestreo, con valores de 0 a 2. Cuanto más bajo, más determinista es la salida.

GPT-6: omita este parámetro con gpt-6-astra y gpt-6.1-sol. Con gpt-6-sol / gpt-6-luna, solo puede ajustarse con esfuerzo de razonamiento none; omítalo en los demás niveles. Omitir el esfuerzo selecciona medium, no none.

Modelos existentes: gpt-5.4 / gpt-5.2 / gpt-5.1 tratan temperature: 0 como el valor predeterminado 1; use un valor positivo como 0.01 para una salida más determinista.

Parámetro de muestreo por núcleo, con valores de 0 a 1. No se recomienda ajustarlo junto con temperature.

GPT-6: omita este parámetro con gpt-6-astra y gpt-6.1-sol. Con gpt-6-sol / gpt-6-luna, solo puede ajustarse con esfuerzo de razonamiento none; omítalo en los demás niveles. Omitir el esfuerzo selecciona medium, no none.

Número de tokens candidatos devueltos en cada posición, con valores de 0 a 20; debe usarse junto con include: ["message.output_text.logprobs"].

GPT-6: Astra y 6.1 Sol no admiten logprobs de salida. Sol / Luna solo permiten usarlos con esfuerzo none. En otros niveles, elimine logprobs, top_logprobs y message.output_text.logprobs de include en Responses.

Las siguientes reglas de modelos existentes excluyen GPT-6 Sol / Luna y GPT-6.1 Sol:

Nota Solo lo admiten la familia gpt-5.6 y gpt-5.5; los demás modelos no admiten este parámetro.

Penalización por frecuencia, con valores de -2 a 2, que reduce la probabilidad de contenido repetido.

GPT-6 Sol / Luna y GPT-6.1 Sol: aún no se ha confirmado la compatibilidad con este parámetro; omítalo en las solicitudes básicas.

Las siguientes reglas de modelos existentes excluyen GPT-6 Sol / Luna y GPT-6.1 Sol:

Nota Puede ajustarse en la familia gpt-5.6; los demás modelos existentes no admiten este parámetro. GPT-6 Astra no permite ajustarlo y solo acepta el valor predeterminado 0; enviar cualquier otro valor devuelve 400.

Penalización por presencia, con valores de -2 a 2, que anima al modelo a tratar temas nuevos.

GPT-6 Sol / Luna y GPT-6.1 Sol: aún no se ha confirmado la compatibilidad con este parámetro; omítalo en las solicitudes básicas.

Las siguientes reglas de modelos existentes excluyen GPT-6 Sol / Luna y GPT-6.1 Sol:

Nota Puede ajustarse en la familia gpt-5.6; los demás modelos existentes no admiten este parámetro. GPT-6 Astra no permite ajustarlo y solo acepta el valor predeterminado 0; enviar cualquier otro valor devuelve 400.

Cómo tratar el contexto que excede la ventana: disabled (predeterminado, devuelve un error directamente) o auto (trunca automáticamente la parte central).

Clave de agrupación de caché. GPT-6 / GPT-5.6 gestionan el enrutamiento automáticamente; este campo no es necesario para optimizarlo. Las claves separadas distinguen la reutilización y la contabilidad por cliente o usuario. Mantenga la misma clave para solicitudes que deban reutilizar un prefijo. En modelos anteriores, una clave estable ayuda al enrutamiento.

Retención de caché de modelos anteriores. Para GPT-6 / GPT-5.6, use prompt_cache_options.ttl: "30m"; no use 24h en el campo nuevo.

Identificador estable del usuario final, usado para el seguimiento de abusos.

GPT-6 Sol / Luna y GPT-6.1 Sol: aún no se ha confirmado la compatibilidad con este parámetro; omítalo en las solicitudes básicas.

Las siguientes reglas de modelos existentes excluyen GPT-6 Sol / Luna y GPT-6.1 Sol:

Nota Solo lo admiten gpt-6-astra y la familia gpt-5.6; los demás modelos no admiten este parámetro.

Identificador del usuario final, usado para distinguir el origen de las llamadas.

Identificador único de esta respuesta, que puede usarse como previous_response_id en el siguiente turno

Tipo de respuesta

Estado de la respuesta: completed para un final normal, incomplete cuando la generación no se completó por motivos como alcanzar max_output_tokens, failed cuando la generación falló

Nombre del modelo real utilizado

Marca de tiempo de creación