Ling 3.1 Flash API

inclusionai/ling-3.1-flash/chat

Ling 3.1 Flash to hybrydowy model rozumowania w architekturze mixture-of-experts od inclusionAI, opublikowany 29 września 2026 roku. Wydawca podaje 560B parametrów łącznie, z czego na każdy token przypada 25B aktywnych. Tutaj model jest dostępny jako jeden endpoint czatu zgodny z OpenAI: do 262,144 tokenów tekstu na wejściu, do 262,144 tokenów na wyjściu, narzędzia i strumieniowanie w każdym żądaniu.

Wejście $0.075Wyjście $0.225za 1 mln tokenówWejście z pamięci podręcznej $0.075

Uruchom model Zobacz API

Wyślij żądanie

Przykłady korzystają z publicznych definicji parametrów wybranego endpointu. Podmień klucz API i przykładowe media, a potem wyślij żądanie ze swojego serwera.

SDK i integracje

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

Uwierzytelnianie API

Klucz API trzymaj w zmiennej środowiskowej serwera SPICY_API_KEY. Dla żądań JSON używaj uwierzytelniania Bearer i Content-Type: application/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'

Wygenerowane ze schematu wejścia tego modelu – tego samego, względem którego API waliduje każde żądanie.

Dla każdego logicznego żądania zachowaj jeden Idempotency-Key. Po przerwaniu połączenia nie wysyłaj automatycznie ponownie z nowym kluczem; zachowaj request_id, żeby sprawdzić przyjęte żądanie. Idempotentność nie odtwarza wcześniejszego strumienia czatu.

Parametry wejściowe

Parametry modelu umieść bezpośrednio w ciele żądania JSON, obok model. Ten endpoint nie używa opakowania input.

messagesarray<object>Wymagane

Prześlij do Ling 3.1 Flash rozmowę w kolejności wraz ze źródłami do zadania „odczyt produktu i terminu dostawy”; powiąż wyniki narzędzi z ich tool_call_id.

Domyślnie: Nie określono
Ograniczenia: minItems:1
maxItems:256

messages[].rolestringWymagane wewnątrz obiektu

Role of the message author.

Domyślnie: Nie określono
Dozwolone wartości: "system""developer""user""assistant""tool"

messages[].namestringOpcjonalne

Optional name identifying the speaker within its role.

Domyślnie: Nie określono

messages[].contentstring | array | nullOpcjonalne

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

Domyślnie: Nie określono

{
  "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>Opcjonalne

Tool calls the assistant requested in this message.

Domyślnie: Nie określono

messages[].tool_call_idstringOpcjonalne

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

Domyślnie: Nie określono

messages[].reasoning_contentstringOpcjonalne

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

Domyślnie: Nie określono

{
  "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_formatobjectOpcjonalne

Poproś Ling 3.1 Flash o tekst lub uporządkowany JSON do zadania „odczyt produktu i terminu dostawy” i sprawdź pola oczekiwane przez aplikację.

Domyślnie: Nie określono

tool_choicestring | objectOpcjonalne

W Ling 3.1 Flash tool_choice przyjmuje auto / none / required / function; odeślij każdy wynik z tool_call_id pierwotnego wywołania.

Domyślnie: Nie określono

parallel_tool_callsbooleanOpcjonalne

Pozwala się tu Ling 3.1 Flash proponować kilka niezależnych funkcji w jednej turze; ich wykonaniem nadal steruje aplikacja.

Domyślnie: true

toolsarray<object>Opcjonalne

Zdefiniuj dla Ling 3.1 Flash do 128 funkcji w formacie OpenAI do zadania „odczyt produktu i terminu dostawy”; argumenty sprawdza i operacje wykonuje aplikacja.

Domyślnie: Nie określono
Ograniczenia: maxItems:128

top_pnumberOpcjonalne

top_p steruje próbkowaniem nucleus w Ling 3.1 Flash; zmieniaj ten parametr i temperature osobno, porównując zadanie „odczyt produktu i terminu dostawy”.

Domyślnie: Nie określono
Ograniczenia: minimum:0.01
maximum:1

temperaturenumberOpcjonalne

temperature steruje próbkowaniem w Ling 3.1 Flash; przy zadaniu „odczyt produktu i terminu dostawy” zachowaj wartość domyślną, chyba że potrzebujesz innego stylu odpowiedzi.

Domyślnie: Nie określono
Ograniczenia: minimum:0
maximum:2

stopstring | arrayOpcjonalne

Zatrzymaj odpowiedź Ling 3.1 Flash jedną sekwencją lub listą do czterech; dopasowany znacznik pomija się w końcowym tekście.

Domyślnie: Nie określono
Ograniczenia: minLength:1
minItems:1
maxItems:4

reasoning_effortstringOpcjonalne

W Ling 3.1 Flash dostępne są none, low, medium, high, domyślnie medium; porównaj ustawienia dla zadania „odczyt produktu i terminu dostawy” według zużycia tokenów wyjściowych.

Domyślnie: "medium"
Dozwolone wartości: "none""low""medium""high"

max_tokensintegerOpcjonalne

Dla Ling 3.1 Flash domyślne max_tokens wynosi 4,096, a limit to 262,144 tokenów wyjściowych, w tym płatne rozumowanie; zostaw miejsce na zadanie „odczyt produktu i terminu dostawy”.

Domyślnie: 4096
Ograniczenia: 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
}

Odczytaj wynik

Przy stream ustawionym na false żądanie zwraca gotową odpowiedź czatu od razu. Czytaj choices[].message; odpytywanie zadania nie jest potrzebne. Ustaw stream na true, jeśli twój klient obsługuje Server-Sent Events.

Przykład odpowiedzi po zakończeniu

{
  "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
  }
}

Przykładowa odpowiedź jest poglądowa. usage podaje liczbę tokenów; liczba tokenów i opłata zależą od twojego rzeczywistego żądania.

SDK i integracje

Korzystaj ze SpicyAPI w aplikacji, terminalu, asystencie AI lub wizualnym przepływie pracy. Wybierz instrukcję konfiguracji.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Polecenia terminala i skrypty automatyzacji.

MCP

Claude Code · Cursor · Codex

Agent Skill

Instrukcje wielokrotnego użytku dla asystenta AI.

n8n

Węzły społecznościowe dla instalacji self-hosted i szablony HTTP Request do importu w n8n Cloud.

ComfyUI

Przepływy obrazów, wideo i dźwięku na płótnie węzłów.

Więcej integracji

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

Przeglądaj gotowe przepływy pracy

To model czatowy, więc działa wszędzie tam, gdzie działa czatowe API OpenAI: zostaw swojego klienta, zmień adres bazowy i wskaż ten model po jego identyfikatorze.

Podłącz dowolnego klienta zgodnego z 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

Narzędzia obsługujące API czatu OpenAI działają w ten sam sposób: SDK, Vercel AI SDK, LangChain, aider i Cline. Serwer MCP i CLI spicyapi obsługują asynchroniczne zadania multimedialne. Konfiguracje poszczególnych narzędzi znajdziesz w centrum dla deweloperów.

Używaj w SillyTavern i aplikacjach do roleplayu

W SillyTavern, RisuAI, Agnai lub dowolnej aplikacji z ustawieniem zgodnym z OpenAI wklej poniższy bazowy URL i swój klucz API, a jako model wybierz inclusionai/ling-3.1-flash/chat. Wywołania prosto z przeglądarki są dozwolone, a suwaki, których ten model nie obsługuje, są pomijane zamiast odrzucane.

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

Przewodnik po SillyTavern RisuAI, Agnai i inne Rozszerzenie SillyTavern

Użyj w ComfyUI

Zainstaluj węzły SpicyAPI przez ComfyUI Manager albo poleceniem poniżej, a potem wybierz inclusionai/ling-3.1-flash/chat w węźle SpicyAPI Chat, aby używać tego modelu w schemacie ComfyUI.

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

Przykładowe workflowy Poradnik konfiguracji Kod źródłowy na GitHubie

Osadzony panel czyta ten sam schemat co ta strona, więc nie może się od API rozjechać. Jeśli twoja dokumentacja potrzebuje treści przeszukiwalnej, pobierz JSON spod /api/embed/models/ i wyrenderuj go samodzielnie.

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

Otwórz panel

Obszar roboczy

Wyślij żądanie

Uwierzytelnianie API

Parametry wejściowe

Odczytaj wynik

SDK i integracje

Używaj w SillyTavern i aplikacjach do roleplayu

Użyj w ComfyUI