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

curl --request POST \
  --url https://direct.evolink.ai/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kimi-k3.1-pro",
  "max_tokens": 1024,
  "output_config": {
    "effort": "low"
  },
  "messages": [
    {
      "role": "user",
      "content": "Reply with OK."
    }
  ]
}
'

{
  "id": "<string>",
  "type": "message",
  "role": "assistant",
  "model": "kimi-k3.1-pro",
  "content": [
    {
      "type": "text",
      "text": "<string>"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": "<string>",
  "usage": {
    "input_tokens": 123,
    "cache_creation_input_tokens": 123,
    "cache_read_input_tokens": 123,
    "output_tokens": 123,
    "output_tokens_details": {
      "thinking_tokens": 123
    },
    "cache_creation": {
      "ephemeral_5m_input_tokens": 1,
      "ephemeral_1h_input_tokens": 1
    },
    "server_tool_use": {
      "web_search_requests": 1
    }
  }
}

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

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

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

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

POST

messages

curl --request POST \
  --url https://direct.evolink.ai/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kimi-k3.1-pro",
  "max_tokens": 1024,
  "output_config": {
    "effort": "low"
  },
  "messages": [
    {
      "role": "user",
      "content": "Reply with OK."
    }
  ]
}
'

{
  "id": "<string>",
  "type": "message",
  "role": "assistant",
  "model": "kimi-k3.1-pro",
  "content": [
    {
      "type": "text",
      "text": "<string>"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": "<string>",
  "usage": {
    "input_tokens": 123,
    "cache_creation_input_tokens": 123,
    "cache_read_input_tokens": 123,
    "output_tokens": 123,
    "output_tokens_details": {
      "thinking_tokens": 123
    },
    "cache_creation": {
      "ephemeral_5m_input_tokens": 1,
      "ephemeral_1h_input_tokens": 1
    },
    "server_tool_use": {
      "web_search_requests": 1
    }
  }
}

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

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

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

{
  "type": "error",
  "error": {
    "type": "<string>",
    "message": "<string>"
  },
  "request_id": "<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 (output_config.format), Stoppsequenzen (stop_sequences) und Cache-Schreib-TTL (cache_control) werden nur von der K3.1-Serie unterstützt, nicht von kimi-k3. Antworten von kimi-k3 können nur text-Blöcke ohne thinking-Blöcke enthalten.

Verfügbare Optionen:

kimi-k3.1-pro,

kimi-k3.1-pro-highspeed,

kimi-k3

max_tokens

integer

erforderlich

Maximale Anzahl der Token für diese Generierung einschließlich thinking und finalem Text.

Erforderlicher Bereich: 1 <= x <= 1048576

messages

object[]

erforderlich

Anthropic-Messages-Nachrichtenliste. Bei mehrstufigen Gesprächen müssen vollständige Assistant-Inhaltsblöcke unverändert zurückgesendet werden.

Minimum array length: 1

Show child attributes

system

System-Prompt als Zeichenfolge oder Array von text-Blöcken.

stream

boolean

Standard:false

Ob ein Anthropic-SSE-Ereignisstrom zurückgegeben wird.

tools

object[]

Eigene Funktionen oder serverseitige Websuche. Integrierte Suche nutzt type=web_search_20250305 und name=web_search; Abrechnung pro tatsächlichem Aufruf.

Option 1
Option 2

Show child attributes

tool_choice

object

Show child attributes

stop_sequences

string[]

Stoppsequenzen. Bei exakter Übereinstimmung endet die Ausgabe; die gefundene Sequenz selbst wird nicht ausgegeben. Höchstens 5 Sequenzen mit jeweils maximal 32 Bytes. Bei einem Treffer ist stop_reason gleich end_turn und stop_sequence gleich null.

Nur von kimi-k3.1-pro / kimi-k3.1-pro-highspeed unterstützt; kimi-k3 unterstützt diesen Parameter nicht.

Maximum array length: 5

cache_control

object

Cache-Schreiboptionen auf oberster Ebene, nur von kimi-k3.1-pro / kimi-k3.1-pro-highspeed unterstützt; kimi-k3 unterstützt diesen Parameter nicht. Nur cache_control auf oberster Ebene steuert die Schreib-TTL; Cache-Markierungen in Nachrichtenblöcken ersetzen dieses Feld nicht. Standard bei Auslassung: 5m.

Show child attributes

output_config

object

Ausgabekonfiguration: Denkaufwand und strukturierte Ausgabe.

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

Message-Antwort; Streaming-Anfragen liefern einen Anthropic-SSE-Ereignisstrom

string

type

enum<string>

Verfügbare Optionen:

message

role

enum<string>

Verfügbare Optionen:

assistant

model

string

Beispiel:

"kimi-k3.1-pro"

content

object[]

Anthropic-Inhaltsblock für Text, Bilder, Schlussfolgerungen, Werkzeugaufrufe oder Werkzeugergebnisse.

Show child attributes

stop_reason

enum<string> | null

Verfügbare Optionen:

end_turn,

max_tokens,

tool_use,

refusal,

null

stop_sequence

string | null

usage

object

Show child attributes

Bildserie

Videoserie

Audioserie

Textserie

Kontoverwaltung

Aufgabenverwaltung

Dateiverwaltung

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

Autorisierungen

Body

Antwort