curl --request POST \
  --url https://direct.evolink.ai/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kimi-k3.1-pro",
  "input": "Reply with OK.",
  "reasoning": {
    "effort": "low"
  },
  "max_output_tokens": 1024
}
'

{
  "id": "resp_68f0c1c2d3e4f5a6b7c8d9e0",
  "object": "response",
  "created_at": 123,
  "completed_at": 123,
  "status": "in_progress",
  "model": "<string>",
  "output": [
    {
      "type": "reasoning",
      "id": "rs_68f0c1c2d3e4f5a6b7c8d9e0",
      "summary": [
        {
          "type": "summary_text",
          "text": "<string>"
        }
      ],
      "encrypted_content": "<string>",
      "status": "in_progress"
    }
  ],
  "usage": {
    "input_tokens": 123,
    "input_tokens_details": {
      "cached_tokens": 123,
      "cache_write_tokens": 123
    },
    "output_tokens": 123,
    "output_tokens_details": {
      "reasoning_tokens": 123
    },
    "total_tokens": 123
  },
  "incomplete_details": {
    "reason": "max_output_tokens"
  },
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "instructions": "<string>",
  "reasoning": {},
  "text": {},
  "tools": [
    {
      "type": "function",
      "name": "<string>",
      "description": "<string>",
      "parameters": {},
      "strict": true
    }
  ],
  "tool_choice": "auto",
  "max_output_tokens": 123,
  "temperature": 123,
  "top_p": 123,
  "parallel_tool_calls": true,
  "service_tier": "<string>",
  "store": true,
  "background": true,
  "previous_response_id": "<string>",
  "conversation": {},
  "prompt_cache_options": {
    "mode": "implicit",
    "ttl": "5m"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Responses API

Kimi API (alle Modelle) - Responses: Vollständige Referenz

Denkstufe über reasoning.effort, Cache über prompt_cache_options setzen. Suche erscheint als web_search_call-Ausgabeelement. Beim Streaming response.completed / response.incomplete / response.failed beachten; beim Ausgabelimit folgt incomplete. Für weitere Gesprächsrunden den vollständigen output-Verlauf einschließlich Schlussfolgerungen, Werkzeugaufrufen und Ergebnissen übergeben.

POST

responses

curl --request POST \
  --url https://direct.evolink.ai/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kimi-k3.1-pro",
  "input": "Reply with OK.",
  "reasoning": {
    "effort": "low"
  },
  "max_output_tokens": 1024
}
'

{
  "id": "resp_68f0c1c2d3e4f5a6b7c8d9e0",
  "object": "response",
  "created_at": 123,
  "completed_at": 123,
  "status": "in_progress",
  "model": "<string>",
  "output": [
    {
      "type": "reasoning",
      "id": "rs_68f0c1c2d3e4f5a6b7c8d9e0",
      "summary": [
        {
          "type": "summary_text",
          "text": "<string>"
        }
      ],
      "encrypted_content": "<string>",
      "status": "in_progress"
    }
  ],
  "usage": {
    "input_tokens": 123,
    "input_tokens_details": {
      "cached_tokens": 123,
      "cache_write_tokens": 123
    },
    "output_tokens": 123,
    "output_tokens_details": {
      "reasoning_tokens": 123
    },
    "total_tokens": 123
  },
  "incomplete_details": {
    "reason": "max_output_tokens"
  },
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "instructions": "<string>",
  "reasoning": {},
  "text": {},
  "tools": [
    {
      "type": "function",
      "name": "<string>",
      "description": "<string>",
      "parameters": {},
      "strict": true
    }
  ],
  "tool_choice": "auto",
  "max_output_tokens": 123,
  "temperature": 123,
  "top_p": 123,
  "parallel_tool_calls": true,
  "service_tier": "<string>",
  "store": true,
  "background": true,
  "previous_response_id": "<string>",
  "conversation": {},
  "prompt_cache_options": {
    "mode": "implicit",
    "ttl": "5m"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

BaseURL: Die Standard-BaseURL ist https://direct.evolink.ai, die Textmodelle und langlebige Verbindungen besser unterstützt. https://api.evolink.ai ist der primäre Endpunkt für multimodale Dienste und dient als Ausweichadresse für Textmodelle.

Autorisierungen

Authorization

string

header

erforderlich

##Alle APIs erfordern eine Bearer-Token-Authentifizierung##

API-Schlüssel abrufen:

Besuchen Sie die API-Schlüsselverwaltung, um Ihren API-Schlüssel abzurufen

Zum Anfrage-Header hinzufügen:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

Standard:kimi-k3.1-pro

erforderlich

Aufzurufendes Modell:

Modell-ID	Einordnung	Reasoning-Aufwand
`kimi-k3.1-pro`	Neueste Modellgeneration (empfohlen)	`low` / `high` / `max`, Standard `max`
`kimi-k3.1-pro-highspeed`	Gleiche Parameter wie Pro, schnellere Generierung	Wie `kimi-k3.1-pro`
`kimi-k3`	Vorherige Modellgeneration	Nur `max`

Alle drei Modelle haben ein Kontextfenster von 1.048.576 Tokens und immer aktives Reasoning.

Strukturierte Ausgabe (text.format) und Cache-Schreib-TTL (prompt_cache_options) werden nur von der K3.1-Serie unterstützt, nicht von kimi-k3.

Verfügbare Optionen:

kimi-k3.1-pro,

kimi-k3.1-pro-highspeed,

kimi-k3

input

erforderlich

Anfrageeingabe. Eine Zeichenfolge entspricht einer user-Nachricht. Ein Array enthält typisierte Elemente in Reihenfolge, etwa Gesprächsverlauf, Werkzeugaufrufe und Ergebnisse.

instructions

string

Systemanweisungen auf oberster Ebene, vor allen anderen Anweisungen angewendet.

stream

boolean

Standard:false

Bei true wird die Antwort als SSE-Stream zurückgegeben.

max_output_tokens

integer

Standard:131072

Maximale Anzahl generierter Token einschließlich Schlussfolgerungen und endgültiger Antwort. Standard: 131072; Maximum: 1048576, zusätzlich durch den verbleibenden Kontext begrenzt.

Erforderlicher Bereich: 1 <= x <= 1048576

reasoning

object

Konfiguration der Schlussfolgerungen.

Show child attributes

text

object

Konfiguration des Ausgabetexts.

Show child attributes

tools

(Funktionswerkzeug · object | Eigenes Werkzeug · object | Namensraum-Werkzeug · object | Websuchwerkzeug · object)[]

Werkzeuge, die das Modell aufrufen kann.

Werkzeugdefinition nach type. Unterstützt function, custom (nur apply_patch), namespace und web_search; andere Typen werden nicht unterstützt.

Funktionswerkzeug
Eigenes Werkzeug
Namensraum-Werkzeug
Websuchwerkzeug

Show child attributes

tool_choice

enum<string>

Steuert Werkzeugaufrufe. Bei auto entscheidet das Modell über den Aufruf.

Verfügbare Optionen:

auto

include

enum<string>[]

Zusätzliche Rückgabefelder, nur für web_search. web_search_call.action.sources liefert gefundene Webseitenquellen, web_search_call.results Bildsuchergebnisse.

Verfügbare Optionen:

web_search_call.results,

web_search_call.action.sources

prompt_cache_options

object

Optionen für das Schreiben in den Kontext-Cache, nur von kimi-k3.1-pro / kimi-k3.1-pro-highspeed unterstützt; kimi-k3 unterstützt diesen Parameter nicht. Ohne Angabe wird standardmäßig automatisch ein 5m-Cache geschrieben. Lesen und Schreiben werden getrennt berechnet.

Show child attributes

temperature

number

Standard:1

Sampling-Temperatur, vom Modell fest auf 1 gesetzt; das Feld muss nicht angegeben werden. kimi-k3.1-pro / kimi-k3.1-pro-highspeed ignorieren es automatisch; kimi-k3 gibt bei nicht unterstützten Werten einen Fehler zurück.

top_p

number

Standard:0.95

Nucleus-Sampling-Schwelle, vom Modell fest auf 0.95 gesetzt; das Feld muss nicht angegeben werden. kimi-k3.1-pro / kimi-k3.1-pro-highspeed ignorieren es automatisch; kimi-k3 gibt bei nicht unterstützten Werten einen Fehler zurück.

Antwort

Antwort erfolgreich erstellt

Eine Modellantwort.

string

Eindeutige Antwortkennung.

Beispiel:

"resp_68f0c1c2d3e4f5a6b7c8d9e0"

object

enum<string>

Verfügbare Optionen:

response

created_at

integer

Unix-Zeitstempel der Antworterstellung.

completed_at

integer | null

Unix-Zeitstempel des Antwortendes. Bei status gleich completed oder incomplete gesetzt, bei in_progress oder failed gleich null.

status

enum<string>

Antwortstatus. Der erste Streaming-Snapshot hat den Status in_progress.

Verfügbare Optionen:

in_progress,

completed,

incomplete,

failed

model

string

Modell, das diese Antwort erzeugt hat.

output

(Schlussfolgerungen · object | Nachricht · object | Function Call · object | Aufruf eines eigenen Werkzeugs · object | Websuchaufruf · object)[]

Array der Ausgabeelemente in der Reihenfolge web_search_call (falls vorhanden), reasoning, message und Werkzeugaufrufe.

Element des output-Arrays, unterschieden nach type.

Schlussfolgerungen
Nachricht
Function Call
Aufruf eines eigenen Werkzeugs
Websuchaufruf

Show child attributes

usage

object | null

input_tokens umfasst Cache-Lese- und Schreibvorgänge. Für reguläre Eingabe-Tokens der K3.1-Serie cached_tokens und cache_write_tokens abziehen; bei kimi-k3 nur cached_tokens. output_tokens enthält bereits Reasoning.

Show child attributes

incomplete_details

object | null

Grund bei status gleich incomplete.

Show child attributes

error

object | null

Fehlerdetails bei status gleich failed.

Show child attributes

instructions

string | null

reasoning

object | null

text

object | null

tools

(Funktionswerkzeug · object | Eigenes Werkzeug · object | Namensraum-Werkzeug · object | Websuchwerkzeug · object)[] | null

Werkzeugdefinition nach type. Unterstützt function, custom (nur apply_patch), namespace und web_search; andere Typen werden nicht unterstützt.

Funktionswerkzeug
Eigenes Werkzeug
Namensraum-Werkzeug
Websuchwerkzeug

Show child attributes

tool_choice

enum<string> | null

Steuert Werkzeugaufrufe. Bei auto entscheidet das Modell über den Aufruf.

Verfügbare Optionen:

auto

max_output_tokens

integer | null

temperature

number | null

top_p

number | null

parallel_tool_calls

boolean

service_tier

string | null

store

boolean

Immer false.

background

boolean | null

Immer false.

previous_response_id

string | null

Immer null.

conversation

object | null

Immer null.

prompt_cache_options

object

Vom Server tatsächlich angewendete Kontext-Cache-Schreiboptionen. Wenn prompt_cache_options fehlt, sind die hier zurückgegebenen Werte mode und ttl maßgeblich.

Show child attributes

Bildserie

Videoserie

Audioserie

Textserie

Kontoverwaltung

Aufgabenverwaltung

Dateiverwaltung

Kimi API (alle Modelle) - Responses: Vollständige Referenz

Autorisierungen

Body

Antwort