Skip to main content
POST
Completado de chat GPT (todos los modelos, parámetros completos)
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 (búsqueda web, ejecución de código, búsqueda documental, MCP) solo se ofrecen en la API Responses. El endpoint de Chat Completions solo admite llamadas a herramientas function normales.
Nota Toda la serie está formada por modelos de razonamiento. stop (secuencias de parada) y web_search_options no se admiten en ningún modelo y devuelven 400 si se envían; logit_bias no es aplicable a esta serie de modelos.El alcance de compatibilidad de temperature, top_p, frequency_penalty, presence_penalty, logprobs y verbosity varía según el modelo: consulta las notas de cada parámetro más arriba.
GPT-6 Astra puede usar herramientas de función con Chat Completions, pero reasoning_effort debe establecerse en none. Para conservar el razonamiento al usar herramientas, utiliza la API Responses.

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:

Cuerpo

application/json
​
model
enum<string>
requerido

Modelo a invocar:

Opciones disponibles:
gpt-6-astra,
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-astra"

​
messages
object[]
requerido

Lista de mensajes de chat, admite contexto de varios turnos y entrada multimodal.

role puede ser system / developer / user / assistant / tool.

content puede ser una cadena o un array de bloques de contenido. Se admiten dos tipos de bloque: text (texto) e image_url (imagen):

Imagen

  • Envía en image_url.url la URL pública de la imagen
  • image_url también puede escribirse directamente como una cadena, equivalente a { "url": "..." }
  • detail controla la precisión del análisis de la imagen: auto (predeterminado) / low / high / original
  • La imagen debe poder descargarse, de lo contrario se devuelve 400

Nota Los tipos de bloque de esta API son distintos de los de la API Responses (que usa input_text / input_image). No pueden mezclarse; usarlos mal devuelve 400.

Ejemplo:
​
stream
boolean
predeterminado:false

Si la respuesta se devuelve en streaming (flujo de eventos SSE, que termina con data: [DONE]). El valor predeterminado es false.

Ejemplo:

false

​
max_completion_tokens
integer

Número máximo de tokens a generar (incluidos los tokens de razonamiento).

Nota Esta serie de modelos usa max_completion_tokens. Por compatibilidad con código antiguo, enviar solo max_tokens se interpreta automáticamente como max_completion_tokens; sin embargo, no envíes ambos campos a la vez — en gpt-5.1 / gpt-5.2 / gpt-5.4 enviarlos juntos devuelve 400.

Ejemplo:

2048

​
reasoning_effort
enum<string>

Control de la profundidad de razonamiento. Los valores posibles varían según el modelo:

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

Opciones disponibles:
none,
low,
medium,
high,
xhigh
Ejemplo:

"medium"

​
verbosity
enum<string>

Nivel de detalle de la respuesta: low / medium / high.

Nota Compatible con gpt-6-astra, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna y gpt-5.5; los demás modelos no admiten este parámetro.

Opciones disponibles:
low,
medium,
high
Ejemplo:

"low"

​
temperature
number

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

Nota Solo puede ajustarse en gpt-5.5 / gpt-5.4 / gpt-5.2 / gpt-5.1. La familia gpt-5.6 y GPT-6 Astra solo aceptan el valor predeterminado 1; enviar cualquier otro valor devuelve 400.

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.

Nota Solo puede ajustarse en gpt-5.5 / gpt-5.4 / gpt-5.2 / gpt-5.1. La familia gpt-5.6 y GPT-6 Astra solo aceptan el valor predeterminado 1; enviar cualquier otro valor devuelve 400.

Rango requerido: 0 <= x <= 1
Ejemplo:

1

​
frequency_penalty
number

Penalización por frecuencia, con valores de -2 a 2. Los valores positivos penalizan los tokens según su frecuencia de aparición y reducen el contenido repetido.

Nota Solo puede ajustarse en gpt-5.4 / gpt-5.2 / gpt-5.1; la familia gpt-5.6 y gpt-5.5 no permiten ajustarlo. GPT-6 Astra 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. Los valores positivos animan al modelo a tratar temas nuevos.

Nota Solo puede ajustarse en gpt-5.4 / gpt-5.2 / gpt-5.1; la familia gpt-5.6 y gpt-5.5 no permiten ajustarlo. GPT-6 Astra solo acepta el valor predeterminado 0; enviar cualquier otro valor devuelve 400.

Rango requerido: -2 <= x <= 2
Ejemplo:

0

​
logprobs
boolean
predeterminado:false

Si se devuelven las probabilidades logarítmicas de cada token de salida.

Nota Solo lo admiten gpt-5.4 / gpt-5.2 / gpt-5.1; la familia gpt-5.6 y gpt-5.5 no admiten este parámetro.

GPT-6 Astra no admite este parámetro.

Ejemplo:

true

​
top_logprobs
integer

Número de tokens candidatos devueltos en cada posición, con valores de 0 a 5; debe usarse junto con logprobs: true.

Nota El alcance de compatibilidad es el mismo que el de logprobs.

Rango requerido: 0 <= x <= 5
Ejemplo:

2

​
n
integer
predeterminado:1

Número de respuestas candidatas a generar, devueltas como varios elementos del array choices. Se facturan todos los tokens (incluida la salida de cada candidata).

Ejemplo:

1

​
seed
integer

Semilla aleatoria. Con la misma semilla y la misma combinación de parámetros, el modelo intenta devolver resultados coherentes (en la medida de lo posible; no se garantiza una reproducibilidad total).

Ejemplo:

42

​
response_format
object

Control del formato de salida:

  • {"type": "text"}: texto libre, el valor predeterminado
  • {"type": "json_object"}: devuelve JSON válido y exige que la palabra json aparezca en messages, de lo contrario devuelve 400
  • {"type": "json_schema", "json_schema": {...}}: devuelve resultados estructurados conforme al JSON Schema indicado; combínalo con "strict": true para forzar la conformidad con el esquema
​
tools
object[]

Lista de herramientas, usada para Function Calling (llamadas a funciones del lado del cliente, sin coste por llamada).

Las herramientas del lado del servidor (búsqueda web, ejecución de código, etc.) no se ofrecen en esta API; utiliza en su lugar la API Responses.

GPT-6 Astra puede usar herramientas de función en esta API, pero reasoning_effort debe establecerse en none. Para conservar el razonamiento al usar herramientas, utiliza la API Responses.

​
tool_choice

Control de la selección de herramientas: "auto" (predeterminado) / "none" / "required", o un objeto que indica una función concreta, como {"type": "function", "function": {"name": "get_weather"}}.

Opciones disponibles:
none,
auto,
required
​
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; con false se fuerza a llamarlas una a una.

Ejemplo:

true

​
prompt_cache_key
string

Clave de agrupación de caché. Enviar el mismo valor para solicitudes que comparten el mismo prefijo mejora la tasa de aciertos de la caché de prompts.

Ejemplo:

"app-chat-v1"

​
user
string

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

Ejemplo:

"user-1024"

Respuesta

Generación de la conversación correcta (objeto JSON; con stream=true, un flujo de eventos SSE que termina con data: [DONE])

​
id
string

Identificador único de esta conversación

Ejemplo:

"chatcmpl-CvJ2p8mQxK7nR4wS"

​
object
enum<string>

Tipo de respuesta

Opciones disponibles:
chat.completion
Ejemplo:

"chat.completion"

​
created
integer

Marca de tiempo de creación

Ejemplo:

1786705221

​
model
string

Nombre del modelo real utilizado

Ejemplo:

"gpt-6-astra"

​
choices
object[]

Lista de resultados generados (su longitud es igual a n en la solicitud)

​
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.