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 K3.1 Pro / Highspeed - Responses API

reasoning.effort で推論強度、prompt_cache_options でキャッシュを指定します。検索は web_search_call 出力項目で返されます。ストリーミングでは response.completed / response.incomplete / response.failed を処理してください。出力上限に達すると incomplete になります。複数ターンでは推論、ツール呼び出し、結果を含む完全な output 履歴を渡してください。

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: デフォルトの BaseURL は https://direct.evolink.ai で、テキストモデルと長時間接続をより適切にサポートします。https://api.evolink.ai はマルチモーダルサービスの主要エンドポイントで、テキストモデルの代替アドレスとして使用されます。

承認

Authorization

string

header

必須

##すべてのインターフェースは Bearer Token による認証が必要です##

API Key の取得：

API Key 管理ページにアクセスして API Key を取得してください

使用時はリクエストヘッダに追加：

Authorization: Bearer YOUR_API_KEY

ボディ

application/json

model

enum<string>

デフォルト:kimi-k3.1-pro

必須

kimi-k3.1-pro または kimi-k3.1-pro-highspeed を指定します。Highspeed は生成が速いモデルです。

利用可能なオプション:

kimi-k3.1-pro,

kimi-k3.1-pro-highspeed

input

必須

今回のリクエストの入力。文字列は 1 つの user メッセージに相当します。配列では型付き項目を順に並べ、会話履歴、ツール呼び出し、ツール結果を含められます。

instructions

string

ほかの指示より前に適用されるトップレベルのシステム指示。

stream

boolean

デフォルト:false

true の場合、SSE イベントストリームで応答を返します。

max_output_tokens

integer

デフォルト:131072

推論と最終回答を含む最大生成トークン数。デフォルトは 131072、最大は 1048576 で、残りのコンテキストにも制限されます。

必須範囲: 1 <= x <= 1048576

reasoning

object

推論に関する設定。

Show child attributes

text

object

出力テキストの設定。

Show child attributes

tools

(関数ツール · object | カスタムツール · object | 名前空間ツール · object | Web 検索ツール · object)[]

モデルが呼び出せるツール。

type で区別するツール定義。function、custom（apply_patch のみ）、namespace、web_search に対応します。ほかの種類は非対応です。

関数ツール
カスタムツール
名前空間ツール
Web 検索ツール

Show child attributes

tool_choice

enum<string>

ツール呼び出しを制御します。auto ではモデルが呼び出しの要否を判断します。

利用可能なオプション:

auto

include

enum<string>[]

追加で返すフィールド。web_search 使用時のみ有効です。web_search_call.action.sources は検索元の Web ページ、web_search_call.results は画像検索結果を返します。

利用可能なオプション:

web_search_call.results,

web_search_call.action.sources

prompt_cache_options

object

コンテキストキャッシュの書き込み設定。省略時は 5m キャッシュへ自動書き込みします。書き込みと読み取りは別々に課金されます。

Show child attributes

レスポンス

応答を正常に作成しました

モデルの 1 回の応答。

string

応答の一意な識別子。

例:

"resp_68f0c1c2d3e4f5a6b7c8d9e0"

object

enum<string>

利用可能なオプション:

response

created_at

integer

応答作成時の Unix タイムスタンプ。

completed_at

integer | null

応答終了時の Unix タイムスタンプ。status が completed または incomplete で設定され、in_progress または failed では null です。

status

enum<string>

応答の状態。ストリーミングの初期スナップショットは in_progress です。

利用可能なオプション:

in_progress,

completed,

incomplete,

failed

model

string

今回の応答を生成したモデル。

output

(推論 · object | メッセージ · object | Function Call · object | カスタムツール呼び出し · object | Web 検索呼び出し · object)[]

出力項目の配列。web_search_call（存在する場合）、reasoning、message、ツール呼び出しの順に並びます。

type で区別する output 配列の要素。

推論
メッセージ
Function Call
カスタムツール呼び出し
Web 検索呼び出し

Show child attributes

usage

object | null

input_tokens はキャッシュ読み取りと書き込みを含みます。通常入力は cached_tokens と cache_write_tokens を差し引いて求めます。output_tokens は推論を含みます。

Show child attributes

incomplete_details

object | null

status が incomplete の場合の理由。

Show child attributes

error

object | null

status が failed の場合のエラー情報。

Show child attributes

instructions

string | null

reasoning

object | null

text

object | null

tools

(関数ツール · object | カスタムツール · object | 名前空間ツール · object | Web 検索ツール · object)[] | null

type で区別するツール定義。function、custom（apply_patch のみ）、namespace、web_search に対応します。ほかの種類は非対応です。

関数ツール
カスタムツール
名前空間ツール
Web 検索ツール

Show child attributes

tool_choice

enum<string> | null

ツール呼び出しを制御します。auto ではモデルが呼び出しの要否を判断します。

利用可能なオプション:

auto

max_output_tokens

integer | null

temperature

number | null

top_p

number | null

parallel_tool_calls

boolean

service_tier

string | null

store

boolean

false 固定。

background

boolean | null

false 固定。

previous_response_id

string | null

null 固定。

conversation

object | null

null 固定。

prompt_cache_options

object

サーバーが実際に適用したコンテキストキャッシュの書き込み設定。prompt_cache_options を省略した場合は、ここで返される mode と ttl に従ってください。

Show child attributes

画像シリーズ

動画シリーズ

オーディオシリーズ

テキストシリーズ

アカウント管理

タスク管理

ファイル管理

Kimi K3.1 Pro / Highspeed - Responses API

承認

ボディ

レスポンス