Ling 3.1 Flash API

inclusionai/ling-3.1-flash/chat

Ling 3.1 Flash es un modelo de razonamiento híbrido de mezcla de expertos de inclusionAI, publicado el 29 de septiembre de 2026. El creador describe 560B de parámetros en total, con 25B activos por token. Aquí se ofrece como un único endpoint de chat compatible con OpenAI: hasta 262,144 tokens de texto de entrada, hasta 262,144 tokens de salida, herramientas y streaming en cada solicitud.

Entrada $0.075Salida $0.225por 1 millón de tokensEntrada en caché $0.075

Ejecutar modelo Ver API

Enviar una solicitud

Los ejemplos usan las definiciones públicas de parámetros del endpoint seleccionado. Sustituye la clave de API y los medios de ejemplo, y envía la solicitud desde tu servidor.

SDK e integraciones

POSThttps://api.spicyapi.ai/v1/chat/completions

Autenticación de API

Guarda la clave de API en la variable de entorno del servidor SPICY_API_KEY. Usa autenticación Bearer y Content-Type: application/json en las solicitudes JSON.

Authorization: Bearer $SPICY_API_KEY

curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "inclusionai/ling-3.1-flash/chat",
  "messages": [
    {
      "role": "user",
      "content": "Summarise the following release notes into three bullet points."
    }
  ],
  "stream": true
}' \
  | jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'

Generado a partir del esquema de entrada de este modelo: el mismo con el que la API valida cada solicitud.

Conserva un Idempotency-Key por cada solicitud lógica. Tras una interrupción de red, no reenvíes automáticamente con una clave nueva; guarda el request_id para investigar la solicitud aceptada. La idempotencia no vuelve a reproducir un flujo de chat anterior.

Parámetros de entrada

Los parámetros del modelo se incluyen junto a model en el cuerpo JSON. Este endpoint no utiliza un contenedor input.

messagesarray<object>Obligatorio

Envía a Ling 3.1 Flash la conversación en orden con las fuentes para extraer producto y fecha de entrega; vincula cada resultado de herramienta con su tool_call_id.

Valor predeterminado: Sin especificar
Restricciones: minItems:1
maxItems:256

messages[].rolestringObligatorio dentro del objeto

Role of the message author.

Valor predeterminado: Sin especificar
Valores permitidos: "system""developer""user""assistant""tool"

messages[].namestringOpcional

Optional name identifying the speaker within its role.

Valor predeterminado: Sin especificar

messages[].contentstring | array | nullOpcional

Message content, either plain text or a list of content parts.

Valor predeterminado: Sin especificar

{
  "type": [
    "string",
    "array",
    "null"
  ],
  "items": {
    "oneOf": [
      {
        "type": "object",
        "required": [
          "type",
          "text"
        ],
        "properties": {
          "text": {
            "type": "string"
          },
          "type": {
            "const": "text"
          }
        }
      }
    ]
  },
  "description": "Message content, either plain text or a list of content parts."
}

messages[].tool_callsarray<object>Opcional

Tool calls the assistant requested in this message.

Valor predeterminado: Sin especificar

messages[].tool_call_idstringOpcional

Identifier of the tool call this message answers. Required on tool messages.

Valor predeterminado: Sin especificar

messages[].reasoning_contentstringOpcional

Reasoning text from a previous assistant reply, preserved when continuing a tool conversation.

Valor predeterminado: Sin especificar

{
  "type": "array",
  "x-ui": {
    "order": 100,
    "widget": "chat-messages",
    "primary": true
  },
  "items": {
    "type": "object",
    "allOf": [
      {
        "if": {
          "required": [
            "reasoning_content"
          ]
        },
        "then": {
          "properties": {
            "role": {
              "const": "assistant"
            }
          }
        }
      }
    ],
    "required": [
      "role"
    ],
    "properties": {
      "name": {
        "type": "string",
        "description": "Optional name identifying the speaker within its role."
      },
      "role": {
        "enum": [
          "system",
          "developer",
          "user",
          "assistant",
          "tool"
        ],
        "type": "string",
        "description": "Role of the message author."
      },
      "content": {
        "type": [
          "string",
          "array",
          "null"
        ],
        "items": {
          "oneOf": [
            {
              "type": "object",
              "required": [
                "type",
                "text"
              ],
              "properties": {
                "text": {
                  "type": "string"
                },
                "type": {
                  "const": "text"
                }
              }
            }
          ]
        },
        "description": "Message content, either plain text or a list of content parts."
      },
      "tool_calls": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Tool calls the assistant requested in this message."
      },
      "tool_call_id": {
        "type": "string",
        "description": "Identifier of the tool call this message answers. Required on tool messages."
      },
      "reasoning_content": {
        "type": "string",
        "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
      }
    },
    "additionalProperties": false
  },
  "maxItems": 256,
  "minItems": 1,
  "description": "Conversation history in order, oldest message first."
}

response_formatobjectOpcional

Pide a Ling 3.1 Flash texto o JSON estructurado para extraer producto y fecha de entrega y valida los campos que tu aplicación espera recibir.

Valor predeterminado: Sin especificar

tool_choicestring | objectOpcional

En Ling 3.1 Flash, tool_choice acepta auto / none / required / function; devuelve cada resultado con el tool_call_id de la llamada original.

Valor predeterminado: Sin especificar

parallel_tool_callsbooleanOpcional

Permite que Ling 3.1 Flash proponga varias funciones independientes en un turno; tu aplicación sigue controlando su ejecución.

Valor predeterminado: true

toolsarray<object>Opcional

Define para Ling 3.1 Flash hasta 128 funciones en formato OpenAI para extraer producto y fecha de entrega; tu aplicación valida los argumentos y ejecuta las operaciones propuestas.

Valor predeterminado: Sin especificar
Restricciones: maxItems:128

top_pnumberOpcional

top_p controla el muestreo de núcleo en Ling 3.1 Flash; cambia este valor y temperature por separado al comparar extraer producto y fecha de entrega.

Valor predeterminado: Sin especificar
Restricciones: minimum:0.01
maximum:1

temperaturenumberOpcional

temperature ajusta el muestreo de Ling 3.1 Flash; conserva su valor predeterminado para extraer producto y fecha de entrega salvo que necesites otro estilo de respuesta.

Valor predeterminado: Sin especificar
Restricciones: minimum:0
maximum:2

stopstring | arrayOpcional

Detén la salida de Ling 3.1 Flash con una secuencia o una lista de hasta cuatro; la coincidencia no se incluye en el texto final.

Valor predeterminado: Sin especificar
Restricciones: minLength:1
minItems:1
maxItems:4

reasoning_effortstringOpcional

Ling 3.1 Flash acepta none, low, medium, high, con medium como valor predeterminado; compara ajustes para extraer producto y fecha de entrega y revisa el consumo de tokens de salida.

Valor predeterminado: "medium"
Valores permitidos: "none""low""medium""high"

max_tokensintegerOpcional

En Ling 3.1 Flash, max_tokens vale 4,096 por defecto y admite hasta 262,144 tokens de salida, incluido el razonamiento facturable; reserva espacio para extraer producto y fecha de entrega.

Valor predeterminado: 4096
Restricciones: minimum:1
maximum:262144

{
  "type": "object",
  "required": [
    "messages"
  ],
  "x-pricing": {
    "billingMode": "formula",
    "variantFields": []
  },
  "properties": {
    "stop": {
      "type": [
        "string",
        "array"
      ],
      "x-ui": {
        "order": 65,
        "widget": "text",
        "affects_price": false
      },
      "items": {
        "type": "string",
        "maxLength": 32,
        "minLength": 1
      },
      "maxItems": 4,
      "minItems": 1,
      "minLength": 1,
      "description": "Sequences that end the reply as soon as the model writes one; the matched text is not returned."
    },
    "tools": {
      "type": "array",
      "x-ui": {
        "order": 35,
        "widget": "json"
      },
      "items": {
        "type": "object"
      },
      "maxItems": 128,
      "description": "Tool definitions the model may call."
    },
    "top_p": {
      "type": "number",
      "x-ui": {
        "step": 0.01,
        "order": 40,
        "widget": "slider"
      },
      "maximum": 1,
      "minimum": 0.01,
      "description": "Nucleus sampling threshold. Lower values keep only the most likely tokens."
    },
    "messages": {
      "type": "array",
      "x-ui": {
        "order": 100,
        "widget": "chat-messages",
        "primary": true
      },
      "items": {
        "type": "object",
        "allOf": [
          {
            "if": {
              "required": [
                "reasoning_content"
              ]
            },
            "then": {
              "properties": {
                "role": {
                  "const": "assistant"
                }
              }
            }
          }
        ],
        "required": [
          "role"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Optional name identifying the speaker within its role."
          },
          "role": {
            "enum": [
              "system",
              "developer",
              "user",
              "assistant",
              "tool"
            ],
            "type": "string",
            "description": "Role of the message author."
          },
          "content": {
            "type": [
              "string",
              "array",
              "null"
            ],
            "items": {
              "oneOf": [
                {
                  "type": "object",
                  "required": [
                    "type",
                    "text"
                  ],
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "type": {
                      "const": "text"
                    }
                  }
                }
              ]
            },
            "description": "Message content, either plain text or a list of content parts."
          },
          "tool_calls": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Tool calls the assistant requested in this message."
          },
          "tool_call_id": {
            "type": "string",
            "description": "Identifier of the tool call this message answers. Required on tool messages."
          },
          "reasoning_content": {
            "type": "string",
            "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 256,
      "minItems": 1,
      "description": "Conversation history in order, oldest message first."
    },
    "max_tokens": {
      "type": "integer",
      "x-ui": {
        "unit": "tokens",
        "order": 80,
        "widget": "number",
        "advanced": false,
        "affects_price": false
      },
      "default": 4096,
      "maximum": 262144,
      "minimum": 1,
      "description": "Maximum number of tokens to generate in the reply."
    },
    "temperature": {
      "type": "number",
      "x-ui": {
        "order": 50,
        "widget": "slider"
      },
      "maximum": 2,
      "minimum": 0,
      "description": "Sampling temperature. Higher values make the output more varied."
    },
    "tool_choice": {
      "type": [
        "string",
        "object"
      ],
      "x-ui": {
        "order": 30,
        "widget": "json"
      },
      "description": "Controls whether and which tool the model may call."
    },
    "response_format": {
      "type": "object",
      "x-ui": {
        "order": 25,
        "widget": "json"
      },
      "description": "Requested reply format, such as plain text or a JSON object."
    },
    "reasoning_effort": {
      "enum": [
        "none",
        "low",
        "medium",
        "high"
      ],
      "type": "string",
      "x-ui": {
        "order": 70,
        "widget": "radio"
      },
      "default": "medium",
      "description": "How much reasoning the model spends before answering."
    },
    "parallel_tool_calls": {
      "type": "boolean",
      "x-ui": {
        "order": 33,
        "widget": "switch",
        "affects_price": false
      },
      "default": true,
      "description": "Whether the model may request more than one tool call in a single turn."
    }
  },
  "x-input-token-limit": 262144,
  "additionalProperties": false
}

Leer el resultado

Con stream en false, la solicitud devuelve directamente la respuesta completa: lee choices[].message, sin consultar ninguna tarea. Pon stream en true si tu cliente admite Server-Sent Events.

Ejemplo de respuesta completada

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "inclusionai/ling-3.1-flash/chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here is a concise summary of the release notes."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 14,
    "total_tokens": 46
  }
}

Esta respuesta solo ilustra la estructura. usage trae el número de tokens; el consumo y el costo reales dependen de tu solicitud.

SDK e integraciones

Usa SpicyAPI en tu app, terminal, asistente de IA o flujo visual. Elige una guía de configuración.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Comandos de terminal y scripts de automatización.

MCP

Claude Code · Cursor · Codex

Agent Skill

Instrucciones reutilizables para tu asistente de IA.

n8n

Nodos comunitarios para instalaciones propias y plantillas HTTP Request importables para n8n Cloud.

ComfyUI

Flujos de imagen, video y audio en un lienzo de nodos.

Más integraciones

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

Explorar flujos listos para usar

Es un modelo de chat, así que funciona donde se use la API de chat de OpenAI: mantén tu cliente, cambia la URL base y elige este modelo por su ID.

Conecta aquí cualquier cliente compatible con OpenAI

export OPENAI_BASE_URL="https://api.spicyapi.ai/v1"
export OPENAI_API_KEY="$SPICY_API_KEY"

aider --model openai/inclusionai/ling-3.1-flash/chat

Todo lo que use la API de chat de OpenAI funciona de la misma manera: SDKs, Vercel AI SDK, LangChain, aider, Cline. El servidor MCP y la CLI spicyapi cubren tareas de medios asíncronas. Encontrarás la configuración de cada herramienta en el centro de desarrolladores.

Úsalo en SillyTavern y apps de roleplay

En SillyTavern, RisuAI, Agnai o cualquier app con una opción compatible con OpenAI, pega la URL base de abajo y tu clave de API, y elige inclusionai/ling-3.1-flash/chat como modelo. Se aceptan llamadas desde el navegador, y los controles que este modelo no admite se ignoran en lugar de rechazarse.

Base URL: https://api.spicyapi.ai/v1
Model: inclusionai/ling-3.1-flash/chat

Guía de SillyTavern RisuAI, Agnai y más Extensión de SillyTavern

Úsalo en ComfyUI

Instala los nodos de SpicyAPI desde ComfyUI Manager o con el comando de abajo y elige inclusionai/ling-3.1-flash/chat en el nodo SpicyAPI Chat para usar este modelo dentro de un grafo de ComfyUI.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

Ejemplos de workflows Guía de configuración Código en GitHub

El panel incrustado lee el mismo esquema que esta página, así que no puede desincronizarse de la API. Si tu documentación necesita contenido indexable, toma el JSON de /api/embed/models/ y renderízalo tú mismo.

<iframe src="https://spicyapi.ai/embed/es/models/ling-3-1-flash/api?model=inclusionai%2Fling-3.1-flash%2Fchat" width="100%" height="560" loading="lazy" title="Ejemplo de solicitud" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Abrir el panel

Playground

Enviar una solicitud

Autenticación de API

Parámetros de entrada

Leer el resultado

SDK e integraciones

Úsalo en SillyTavern y apps de roleplay

Úsalo en ComfyUI