GPT Responses (todos los modelos, parámetros completos)

curl --request POST \
  --url https://direct.evolink.ai/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gpt-6.1-sol",
  "input": "Explica el entrelazamiento cuántico en una frase."
}
'

import requests

url = "https://direct.evolink.ai/v1/responses"

payload = {
    "model": "gpt-6.1-sol",
    "input": "Explica el entrelazamiento cuántico en una frase."
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'gpt-6.1-sol',
    input: 'Explica el entrelazamiento cuántico en una frase.'
  })
};

fetch('https://direct.evolink.ai/v1/responses', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://direct.evolink.ai/v1/responses",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'gpt-6.1-sol',
    'input' => 'Explica el entrelazamiento cuántico en una frase.'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://direct.evolink.ai/v1/responses"

	payload := strings.NewReader("{\n  \"model\": \"gpt-6.1-sol\",\n  \"input\": \"Explica el entrelazamiento cuántico en una frase.\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://direct.evolink.ai/v1/responses")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"gpt-6.1-sol\",\n  \"input\": \"Explica el entrelazamiento cuántico en una frase.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://direct.evolink.ai/v1/responses")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"gpt-6.1-sol\",\n  \"input\": \"Explica el entrelazamiento cuántico en una frase.\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "resp_0f5c2b2c20c39e8a006a7ef545443081979e478b10927984b5",
  "object": "response",
  "status": "completed",
  "model": "gpt-6.1-sol",
  "created_at": 1786705221,
  "output": [
    {
      "id": "<string>",
      "type": "web_search_call",
      "status": "completed",
      "content": [
        {}
      ],
      "encrypted_content": "<string>",
      "result": "<string>"
    }
  ],
  "incomplete_details": {},
  "usage": {
    "input_tokens": 18,
    "output_tokens": 42,
    "total_tokens": 60,
    "input_tokens_details": {
      "cached_tokens": 0,
      "cache_write_tokens": 0
    },
    "output_tokens_details": {
      "reasoning_tokens": 16
    }
  },
  "tool_usage": {
    "image_gen": {
      "input_tokens": 74,
      "input_tokens_details": {},
      "output_tokens": 196,
      "output_tokens_details": {},
      "total_tokens": 270
    }
  },
  "metadata": {}
}

{
  "error": {
    "code": 400,
    "message": "Invalid value: '__bogus__'. Supported values are: 'auto' and 'disabled'.",
    "type": "invalid_request_error",
    "param": "truncation"
  }
}

{
  "error": {
    "code": 401,
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient quota",
    "type": "insufficient_quota_error",
    "fallback_suggestion": "https://evolink.ai/dashboard/credits"
  }
}

{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "fallback_suggestion": "retry after 60 seconds"
  }
}

{
  "error": {
    "code": 500,
    "message": "Internal server error",
    "type": "internal_server_error",
    "fallback_suggestion": "try again later"
  }
}

{
  "error": {
    "code": 503,
    "message": "Service temporarily unavailable",
    "type": "service_unavailable_error",
    "fallback_suggestion": "retry after 30 seconds"
  }
}

Responses API

Interfaz de todos los modelos GPT - Referencia completa de Responses

API Responses compatible con OpenAI para los modelos de texto de la serie GPT; el modelo concreto se elige mediante model (todos los valores posibles están en la tabla comparativa del parámetro model)
Toda la serie está formada por modelos de razonamiento; la profundidad se controla con reasoning.effort y los tokens de razonamiento se facturan como tokens de salida
La caché de prompts se aplica automáticamente: los tokens de entrada servidos desde caché se facturan a la tarifa de caché, más baja
Admite los modos síncrono y en streaming (SSE)
Herramientas del lado del servidor: web_search (búsqueda web), file_search (búsqueda documental), facturadas por separado por llamada
Herramienta integrada de generación de imágenes: image_generation (solo gpt-6-astra / gpt-6.1-terra / gpt-6.1-sol / gpt-6-sol / gpt-6-luna), para generar o editar imágenes directamente en una conversación
También se admiten las herramientas function normales (llamadas a funciones del lado del cliente)
Las conversaciones de varios turnos pueden encadenarse con previous_response_id
Nota El alcance de compatibilidad de algunos parámetros varía según el modelo; consulta las notas de cada parámetro más abajo

POST

responses

GPT Responses (todos los modelos, parámetros completos)

curl --request POST \
  --url https://direct.evolink.ai/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gpt-6.1-sol",
  "input": "Explica el entrelazamiento cuántico en una frase."
}
'

import requests

url = "https://direct.evolink.ai/v1/responses"

payload = {
    "model": "gpt-6.1-sol",
    "input": "Explica el entrelazamiento cuántico en una frase."
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'gpt-6.1-sol',
    input: 'Explica el entrelazamiento cuántico en una frase.'
  })
};

fetch('https://direct.evolink.ai/v1/responses', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://direct.evolink.ai/v1/responses",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'gpt-6.1-sol',
    'input' => 'Explica el entrelazamiento cuántico en una frase.'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://direct.evolink.ai/v1/responses"

	payload := strings.NewReader("{\n  \"model\": \"gpt-6.1-sol\",\n  \"input\": \"Explica el entrelazamiento cuántico en una frase.\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://direct.evolink.ai/v1/responses")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"gpt-6.1-sol\",\n  \"input\": \"Explica el entrelazamiento cuántico en una frase.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://direct.evolink.ai/v1/responses")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"gpt-6.1-sol\",\n  \"input\": \"Explica el entrelazamiento cuántico en una frase.\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "resp_0f5c2b2c20c39e8a006a7ef545443081979e478b10927984b5",
  "object": "response",
  "status": "completed",
  "model": "gpt-6.1-sol",
  "created_at": 1786705221,
  "output": [
    {
      "id": "<string>",
      "type": "web_search_call",
      "status": "completed",
      "content": [
        {}
      ],
      "encrypted_content": "<string>",
      "result": "<string>"
    }
  ],
  "incomplete_details": {},
  "usage": {
    "input_tokens": 18,
    "output_tokens": 42,
    "total_tokens": 60,
    "input_tokens_details": {
      "cached_tokens": 0,
      "cache_write_tokens": 0
    },
    "output_tokens_details": {
      "reasoning_tokens": 16
    }
  },
  "tool_usage": {
    "image_gen": {
      "input_tokens": 74,
      "input_tokens_details": {},
      "output_tokens": 196,
      "output_tokens_details": {},
      "total_tokens": 270
    }
  },
  "metadata": {}
}

{
  "error": {
    "code": 400,
    "message": "Invalid value: '__bogus__'. Supported values are: 'auto' and 'disabled'.",
    "type": "invalid_request_error",
    "param": "truncation"
  }
}

{
  "error": {
    "code": 401,
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient quota",
    "type": "insufficient_quota_error",
    "fallback_suggestion": "https://evolink.ai/dashboard/credits"
  }
}

{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "fallback_suggestion": "retry after 60 seconds"
  }
}

{
  "error": {
    "code": 500,
    "message": "Internal server error",
    "type": "internal_server_error",
    "fallback_suggestion": "try again later"
  }
}

{
  "error": {
    "code": 503,
    "message": "Service temporarily unavailable",
    "type": "service_unavailable_error",
    "fallback_suggestion": "retry after 30 seconds"
  }
}

BaseURL: La BaseURL predeterminada es https://direct.evolink.ai, que ofrece mejor compatibilidad con modelos de texto y admite conexiones persistentes. https://api.evolink.ai es el endpoint principal para servicios multimodales y actúa como dirección de respaldo para los modelos de texto.

Las herramientas del lado del servidor (web_search, file_search, mcp) se ejecutan en el servidor, por lo que el cliente no necesita devolver sus resultados, y solo se ofrecen en esta API. El endpoint de Chat Completions solo admite llamadas a herramientas function normales.

Facturación: web_search y file_search se facturan por llamada, por separado de los cargos por tokens; las respuestas fallidas no generan cargos por texto ni por herramientas (las imágenes ya generadas y devueltas se facturan con normalidad)
Límite de llamadas: Si se declara web_search o file_search y se omite max_tool_calls, se permiten hasta 10 llamadas a herramientas por solicitud; configura el parámetro explícitamente si necesitas más.

Nota Esta API solo admite los modos síncrono y en streaming: no admite el modo asíncrono en segundo plano con background: true ni ofrece endpoints para consultar, cancelar o eliminar una respuesta por su ID. Para generaciones largas, usa stream: true para mantener la conexión abierta.La herramienta integrada image_generation solo está disponible actualmente en gpt-6-astra / gpt-6.1-terra / gpt-6.1-sol / gpt-6-sol / gpt-6-luna, y no en los demás modelos; para generar imágenes de forma independiente, también puedes usar las API de los modelos de la serie de imagen.

Genera imágenes directamente con gpt-6-astra / gpt-6.1-terra / gpt-6.1-sol / gpt-6-sol / gpt-6-luna: declara {"type": "image_generation"} en tools y el modelo generará imágenes según sea necesario en la conversación.

Elige un modelo de imagen: usa el campo model de la herramienta para seleccionar gpt-image-2 (predeterminado), gpt-image-2.5-sunburst o gpt-image-2.5-flare; quality, size, partial_images y los demás parámetros siguen los parámetros oficiales del modelo de imagen (xhigh / max solo están disponibles en la serie 2.5)
Obtén la imagen: las imágenes se devuelven en base64 en el campo result de un elemento de output cuyo type es image_generation_call; no es una URL, por lo que debes guardar la imagen por tu cuenta
Edición de imágenes: incluye un input_image en input (una URL pública o data:image/png;base64,...) y describe los cambios deseados en el texto
Edición en varios turnos: pasa el id del turno anterior como previous_response_id y describe los cambios que deseas
Streaming: configura partial_images (0–3) para recibir eventos de vista previa response.image_generation_call.partial_image durante la generación
Límite de imágenes: si se omite max_tool_calls, una solicitud puede generar hasta 4 imágenes; configúralo explícitamente si necesitas más
Facturación: el texto y la generación de imágenes se facturan por separado por token; el uso de tokens de la generación de imágenes aparece en tool_usage.image_gen en la respuesta

{
  "model": "gpt-6.1-sol",
  "input": "Pinta un gato naranja sentado junto a una ventana en estilo acuarela",
  "tools": [{"type": "image_generation", "model": "gpt-image-2", "quality": "low", "size": "1024x1024"}]
}

Conversaciones de varios turnos: envía el id devuelto en el turno anterior como previous_response_id del siguiente turno para continuar el contexto. 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. En escenarios con requisitos estrictos de exactitud del contexto, se recomienda mantener por tu cuenta el historial completo de input.

Autorizaciones

Authorization

string

header

requerido

##Todas las APIs requieren autenticación Bearer Token##

Obtener API Key:

Visita la Página de gestión de API Key para obtener tu API Key

Agregar al encabezado de la solicitud:

Authorization: Bearer YOUR_API_KEY

Cuerpo

application/json

model

enum<string>

requerido

Modelo a invocar:

ID del modelo	Ventana de contexto	Posicionamiento
`gpt-6.1-terra`	1,050,000	Variante rápida y eficiente de GPT-6.1 para razonamiento visual, uso del ordenador y escritura
`gpt-6.1-sol`	1,050,000	Nueva versión de Sol: rendimiento cercano a Astra a menor costo (recomendado)
`gpt-6-astra`	1.050.000	Razonamiento insignia para tareas integrales exigentes, con compatibilidad con la herramienta integrada `image_generation`
`gpt-6-sol`	1,050,000	Programación compleja y flujos de trabajo con agentes
`gpt-6-luna`	1,050,000	Clasificación y extracción de alto volumen con menor costo
`gpt-5.6-sol`	1.050.000	Familia GPT-5.6, razonamiento de vanguardia
`gpt-5.6-terra`	1.050.000	Familia GPT-5.6, producción equilibrada
`gpt-5.6-luna`	1.050.000	Familia GPT-5.6, alto rendimiento y control de costes
`gpt-5.5`	1.050.000	Modelo de razonamiento de propósito general
`gpt-5.4`	1.050.000	Modelo de razonamiento de propósito general
`gpt-5.2`	400.000	Modelo de razonamiento de propósito general
`gpt-5.1`	400.000	Modelo de razonamiento de propósito general

Opciones disponibles:

gpt-6.1-terra,

gpt-6.1-sol,

gpt-6-astra,

gpt-6-sol,

gpt-6-luna,

gpt-5.6-sol,

gpt-5.6-terra,

gpt-5.6-luna,

gpt-5.5,

gpt-5.4,

gpt-5.2,

gpt-5.1

Ejemplo:

"gpt-6.1-sol"

input

requerido

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.

Ejemplo:

"Search for AI news from the past week and summarize it in three sentences."

instructions

string

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.

Ejemplo:

"You are a concise assistant. Answer in no more than three sentences."

stream

boolean

predeterminado:false

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

Ejemplo:

false

max_output_tokens

integer

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, GPT-6.1 Sol y GPT-6.1 Terra permiten hasta 128.000 tokens de salida, incluidos los de razonamiento.

Ejemplo:

2048

reasoning

object

Control del razonamiento.

Los valores posibles de effort (profundidad de razonamiento) varían según el modelo:

Modelo	Valores posibles
`gpt-6-astra` / `gpt-6.1-sol`	`low`, `medium`, `high`, `xhigh`, `max`
`gpt-6-sol` / `gpt-6-luna` / `gpt-6.1-terra`	`none`, `low`, `medium`, `high`, `xhigh`, `max`
`gpt-5.6-sol` / `gpt-5.6-terra` / `gpt-5.6-luna`	`none`, `low`, `medium`, `high`, `xhigh`, `max`
`gpt-5.5` / `gpt-5.4` / `gpt-5.2`	`none`, `low`, `medium`, `high`, `xhigh`
`gpt-5.1`	`none`, `low`, `medium`, `high`

summary (resumen del razonamiento): auto / concise / detailed.

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

mode (modo de razonamiento): standard / pro, lo admiten gpt-6-astra / gpt-6-sol / gpt-6-luna y la familia gpt-5.6.

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

context (alcance del contexto de razonamiento): auto / current_turn / all_turns, lo admiten gpt-6-astra y la familia gpt-5.6.

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

Los tokens de razonamiento se facturan como tokens de salida y se contabilizan en usage.output_tokens_details.reasoning_tokens.

GPT-6 Sol / Luna disponibles: establezca model en gpt-6-sol o gpt-6-luna. Ambos tienen una ventana de 1.050.000 tokens y una salida máxima de 128.000 tokens, incluido el razonamiento. reasoning.effort admite none, low, medium (predeterminado), high, xhigh y max; Astra y 6.1 Sol no admiten none. Use este endpoint para razonar con herramientas.

GPT-6.1 Terra: ventana de contexto de 1.050.000 tokens y salida máxima de 128.000 tokens, incluido el razonamiento. reasoning.effort admite none, low, medium (predeterminado), high, xhigh y max, pero no minimal. Use este endpoint para llamadas a funciones y herramientas integradas.

Show child attributes

text

object

Control del texto de salida:

format: {"type": "text"} (predeterminado), {"type": "json_object"} o {"type": "json_schema", "name": "...", "schema": {...}, "strict": true} para obtener resultados estructurados
verbosity: low / medium / high, controla el nivel de detalle de la respuesta

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

Show child attributes

tools

object[]

Declaración de herramientas. Las herramientas del lado del servidor se ejecutan en el servidor, por lo que el cliente no necesita devolver sus resultados:

Tipo de herramienta	Capacidad
`web_search`	Busca en internet y navega por páginas web (alias `web_search_preview`)
`file_search`	Consulta un almacén vectorial ya creado; requiere `vector_store_ids`
`mcp`	Se conecta a un servicio MCP remoto; requiere `server_label` y `server_url`
`image_generation`	Genera o edita imágenes en una conversación y las devuelve en base64 (solo `gpt-6-astra` / `gpt-6.1-terra` / `gpt-6.1-sol` / `gpt-6-sol` / `gpt-6-luna`)

También se admiten las herramientas function normales (llamadas a funciones del lado del cliente).

Nota La herramienta integrada image_generation solo está disponible actualmente en gpt-6-astra / gpt-6.1-terra / gpt-6.1-sol / gpt-6-sol / gpt-6-luna, y no en los demás modelos; para generar imágenes de forma independiente, también puedes usar las API de los modelos de la serie de imagen.

Show child attributes

Ejemplo:

[{ "type": "web_search" }]

tool_choice

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

Opciones disponibles:

none,

auto,

required

max_tool_calls

integer

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-terra / 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.

Nota Si se declara web_search o file_search y se omite max_tool_calls, se permiten hasta 10 llamadas a herramientas por solicitud; configura el parámetro explícitamente si necesitas más.

Ejemplo:

5

parallel_tool_calls

boolean

predeterminado:true

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

GPT-6 Sol / Luna, GPT-6.1 Sol y GPT-6.1 Terra: 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, GPT-6.1 Sol y GPT-6.1 Terra:

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.

Ejemplo:

true

previous_response_id

string

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.

Ejemplo:

"resp_0f5c2b2c20c39e8a006a7ef545443081979e478b10927984b5"

store

boolean

predeterminado:true

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, GPT-6.1 Sol y GPT-6.1 Terra: 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, GPT-6.1 Sol y GPT-6.1 Terra:

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.

Ejemplo:

true

include

string[]

Contenido adicional que se solicita devolver en la respuesta. Valores posibles:

reasoning.encrypted_content
message.output_text.logprobs
web_search_call.results
web_search_call.action.sources
file_search_call.results
message.input_image.image_url
computer_call_output.output.image_url

Nota gpt-6-astra y gpt-6.1-sol no admiten message.output_text.logprobs.

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

Ejemplo:

["reasoning.encrypted_content"]

temperature

number

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 / gpt-6.1-terra, 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.

Rango requerido: 0 <= x <= 2

Ejemplo:

1

top_p

number

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

Rango requerido: 0 <= x <= 1

Ejemplo:

1

top_logprobs

integer

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"].

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

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

Rango requerido: 0 <= x <= 20

Ejemplo:

2

frequency_penalty

number

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

GPT-6 Sol / Luna, GPT-6.1 Sol y GPT-6.1 Terra: 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, GPT-6.1 Sol y GPT-6.1 Terra:

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.

Rango requerido: -2 <= x <= 2

Ejemplo:

0

presence_penalty

number

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

GPT-6 Sol / Luna, GPT-6.1 Sol y GPT-6.1 Terra: 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, GPT-6.1 Sol y GPT-6.1 Terra:

Rango requerido: -2 <= x <= 2

Ejemplo:

0

truncation

enum<string>

predeterminado:disabled

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

Opciones disponibles:

auto,

disabled

Ejemplo:

"auto"

context_management

object[]

Configuración de compactación automática para conversaciones largas, por ejemplo [{"type": "compaction", "compact_threshold": 100000}]: cuando el contexto supera el umbral, el historial se compacta automáticamente.

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

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

prompt_cache_key

string

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.

Ejemplo:

"app-agent-v1"

prompt_cache_retention

enum<string>

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.

Opciones disponibles:

in_memory,

24h

Ejemplo:

"in_memory"

prompt

object

Hace referencia a una plantilla de prompt ya creada, con la forma {"id": "pmpt_xxx", "version": "1", "variables": {...}}.

Show child attributes

metadata

object

Pares clave-valor personalizados que se devuelven tal cual con la respuesta, útiles para etiquetar del lado del negocio. Tanto las claves como los valores son cadenas.

Ejemplo:

{ "trace_id": "abc-123" }

safety_identifier

string

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

GPT-6 Sol / Luna, GPT-6.1 Sol y GPT-6.1 Terra: 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, GPT-6.1 Sol y GPT-6.1 Terra:

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

Ejemplo:

"user-1024"

user

string

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

Ejemplo:

"user-1024"

prompt_cache_options

object

Opciones de caché para GPT-6 y GPT-5.6. Los puntos implícitos son el valor predeterminado. mode: "explicit" usa solo puntos explícitos; sin ellos no hay caché.

Show child attributes

Ejemplo:

{ "ttl": "30m", "mode": "implicit" }

Respuesta

Respuesta generada con éxito (objeto JSON, o un flujo de eventos SSE que termina con response.completed cuando stream=true)

string

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

Ejemplo:

"resp_0f5c2b2c20c39e8a006a7ef545443081979e478b10927984b5"

object

enum<string>

Tipo de respuesta

Opciones disponibles:

response

Ejemplo:

"response"

status

enum<string>

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ó

Opciones disponibles:

completed,

incomplete,

failed

Ejemplo:

"completed"

model

string

Nombre del modelo real utilizado

Ejemplo:

"gpt-6.1-sol"

created_at

integer

Marca de tiempo de creación

Ejemplo:

1786705221

output

object[]

Elementos de salida ordenados según la generación: el elemento reasoning (resumen del razonamiento / contenido de razonamiento cifrado), los elementos de llamada a herramientas (como web_search_call, file_search_call e image_generation_call) y, por último, el elemento message con el contenido output_text.

Show child attributes

incomplete_details

object

Explica el motivo cuando status es incomplete

usage

object

Estadísticas de uso de tokens. La caché de prompts se aplica automáticamente y los tokens de entrada servidos desde caché se facturan a la tarifa de caché, más baja.

GPT-6 factura por separado entrada sin caché, lectura de caché, escritura de caché y salida. Si la entrada supera 272.000 tokens, toda la solicitud se factura a 2× las tarifas de entrada y caché y 1,5× la de salida. La generación de imágenes integrada se cobra aparte. Consulte los precios actuales.

Show child attributes

tool_usage

object

Uso de las herramientas integradas. Al usar image_generation, image_gen registra los tokens consumidos por la generación de imágenes, contabilizados por separado de usage y facturados por separado por token

Show child attributes

metadata

object

Pares clave-valor personalizados enviados en la solicitud, devueltos tal cual

Serie de imágenes

Serie de videos

Serie de audio

Serie de texto

Gestión de cuenta

Gestión de tareas

Gestión de archivos

Interfaz de todos los modelos GPT - Referencia completa de Responses

Autorizaciones

Cuerpo

Respuesta