Skip to main content
POST
BaseURL: La BaseURL predeterminada es https://direct.evolink.ai, que ofrece mejor compatibilidad con los modelos de texto y las conexiones de larga duración. https://api.evolink.ai es el endpoint principal para los servicios multimodales y sirve como dirección de respaldo para los modelos de texto.

Autorizaciones

Authorization
string
header
requerido

Todas las API requieren autenticación con Bearer Token

Obtener la API Key:

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

Añadir al encabezado de la solicitud:

Cuerpo

application/json
model
enum<string>
requerido

ID del modelo

Opciones disponibles:
MiniMax-M3.1-Flash
Ejemplo:

"MiniMax-M3.1-Flash"

input
requerido

Entrada del modelo

  • Cadena: el texto completo se trata como un único mensaje user
  • Arreglo: lista de elementos de entrada; admite message, function_call, function_call_output y reasoning

Multimodal: combina bloques input_text, input_image e input_video en el arreglo content de un elemento message.

Conversaciones de varios turnos: la API no mantiene estado; incluye el historial completo en el arreglo para continuar la conversación.

Ejemplo:

"Explain recursion in one sentence."

instructions
string

Instrucciones a nivel de sistema, equivalentes a un mensaje system insertado al principio; sirven para fijar el rol, el tono y las restricciones de salida.

Ejemplo:

"You are a technical documentation assistant. Keep your answers concise."

stream
boolean
predeterminado:false

Indica si la respuesta se devuelve en streaming

  • false (predeterminado): devuelve el objeto de respuesta completo de una vez
  • true: transmite eventos SSE semánticos y termina con response.completed; no envía [DONE]
Ejemplo:

false

max_output_tokens
integer

Máximo de tokens de salida de esta generación, incluidos el razonamiento y la respuesta

  • Recomendado: 131,072 (128K); máximo: 524,288 (512K)
  • Un valor demasiado bajo puede agotar el límite durante el razonamiento y devolver status: "incomplete" sin elementos de salida message
Rango requerido: 1 <= x <= 524288
Ejemplo:

131072

reasoning
object

Configuración de razonamiento. MiniMax-M3.1-Flash siempre realiza razonamiento, que se devuelve como elementos de salida reasoning. Sus tokens se incluyen en la salida y se facturan a la tarifa de salida.

temperature
enum<number>
predeterminado:1

Temperatura de muestreo, fija en 1.

Opciones disponibles:
1
Ejemplo:

1

top_p
number
predeterminado:0.95

Umbral de muestreo de núcleo; valor predeterminado: 0.95.

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

0.95

tools
Definición de herramienta · object[]

Lista de herramientas disponibles para el modelo. Actualmente solo admite el tipo function. El cliente ejecuta las funciones y devuelve sus resultados como elementos de entrada function_call_output.

tool_choice
enum<string>
predeterminado:auto

Estrategia de selección de herramientas. Solo admite auto: el modelo decide si debe invocar una herramienta.

Opciones disponibles:
auto
Ejemplo:

"auto"

text
object

Configuración del formato de salida de texto. format.type solo admite text.

metadata
object

Metadatos de la solicitud. Tanto las claves como los valores deben ser cadenas.

Respuesta

Generado correctamente

Objeto de respuesta de la API Responses. Además de los campos siguientes, incluye la configuración de la solicitud, como tools, tool_choice, temperature, top_p, text, reasoning y max_output_tokens.

id
string

Identificador único de esta respuesta

Ejemplo:

"072514d63605b7a0c83f1672230c398c"

object
string

Tipo de objeto, siempre response

Ejemplo:

"response"

created_at
integer

Fecha de creación como marca de tiempo Unix (segundos)

Ejemplo:

1792401878

status
enum<string>

Estado de la respuesta

  • completed: finalización normal
  • incomplete: salida truncada; consulta el motivo en incomplete_details
  • failed: generación fallida; consulta el motivo en error
Opciones disponibles:
completed,
incomplete,
failed
Ejemplo:

"completed"

model
string

ID del modelo que realmente generó esta respuesta

Ejemplo:

"MiniMax-M3.1-Flash"

output
object[]

Lista de elementos de salida en orden de generación:

  • reasoning: razonamiento; ID con formato <id>_rs. Contiene content (lista de bloques reasoning_text), summary (arreglo vacío) y encrypted_content
  • message: respuesta final; ID con formato <id>_msg. Contiene content (lista de bloques output_text)
  • function_call: llamada a función iniciada por el modelo; ID con formato <id>_fc_<index>. Contiene call_id, name y arguments. El cliente debe ejecutarla y devolver el resultado mediante function_call_output
output_text
string | null

Campo de acceso directo con todo el texto de output_text concatenado. Es null si no hay salida de texto.

error
object | null

Motivo del fallo; null si tuvo éxito

incomplete_details
object | null

Motivo del truncamiento; null si la salida no se ha truncado. reason puede ser max_output_tokens (límite de salida alcanzado) o content_filter (seguridad del contenido).

usage
object

Estadísticas de uso de tokens, con desglose de caché y razonamiento.