Skip to main content
POST
BaseURL:デフォルトの BaseURL は https://direct.evolink.ai で、テキストモデルへの対応が優れており、長時間接続をサポートします。https://api.evolink.ai はマルチモーダルの主力エンドポイントで、テキストモデルに対しては代替アドレスとして使用されます。

承認

Authorization
string
header
必須

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

API Key の取得:

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

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

ボディ

application/json
model
enum<string>
デフォルト:deepseek-v4-flash
必須

会話モデル名

  • deepseek-v4.1-flash-1017: DeepSeek V4.1 Flash 1017(最新版)。テキストとネイティブ画像理解に対応し、1M コンテキスト、最大 384K 出力トークンをサポート。旧版より回答が簡潔で、応答時間も短縮
  • deepseek-v4.1-flash: DeepSeek V4.1 Flash の旧バージョン。上記と同じ機能に対応。最新版を利用するには deepseek-v4.1-flash-1017 を指定してください
  • deepseek-v4-flash:高速汎用モデル、1M コンテキスト
  • deepseek-v4-pro:深度推論モデル、数学、プログラミング、複雑なロジックが得意
  • deepseek-v4-flash-vision-exp: 旧モデル名。現在は DeepSeek V4.1 Flash に転送されます。新規連携では deepseek-v4.1-flash を使用してください

ヒント:すべてのモデルで thinking がデフォルトで有効 であり、レスポンスには reasoning_content が含まれます。thinking.type="disabled" で無効化すると出力 token コストを削減できます。

画像に対応するのは deepseek-v4.1-flash / deepseek-v4.1-flash-1017 / deepseek-v4-flash-vision-exp のみです:deepseek-v4-flash / deepseek-v4-pro に画像を送信すると、HTTP 400 This model does not support image が返されます。

利用可能なオプション:
deepseek-v4-flash,
deepseek-v4-pro,
deepseek-v4-flash-vision-exp,
deepseek-v4.1-flash,
deepseek-v4.1-flash-1017
例:

"deepseek-v4-flash"

messages
(System Message · object | User Message · object | Assistant Message · object | Tool Message · object)[]
必須

会話メッセージリスト、マルチターン会話をサポート

役割ごとにメッセージのフィールド構造が異なるため、該当する役割を選択して確認してください

Minimum array length: 1
thinking
object

思考モード制御(V4 新機能)

説明:

  • 深度思考(Chain of Thought)機能を制御するために使用
  • 両モデルともデフォルトで有効(type=enabled)
  • 有効時、推論過程は choices[].message.reasoning_content で返され、出力 token として課金されます

マルチターン会話 / ツール呼び出しの注意:本ターンのレスポンスに reasoning_content が含まれている場合、次のリクエストの messages 履歴の該当 assistant メッセージでこのフィールドをそのまま返送する必要があります。さもないと API は 400 The reasoning_content in the thinking mode must be passed back to the API を返します。処理したくない場合は、セッション全体で明示的に thinking.type="disabled" を指定できます。

temperature
number
デフォルト:1

サンプリング温度、出力のランダム性を制御

説明:

  • 低い値(例:0.2):より確定的で集中した出力
  • 高い値(例:1.5):よりランダムで創造的な出力
  • デフォルト値:1
必須範囲: 0 <= x <= 2
例:

1

top_p
number
デフォルト:1

核サンプリング(Nucleus Sampling)パラメータ

説明:

  • 累積確率の上位何%の token からサンプリングするかを制御
  • 例:0.9 は累積確率が 90% に達する token から選択
  • デフォルト値:1.0(すべての token を考慮)

推奨:temperature と top_p を同時に調整しないでください

必須範囲: 0 <= x <= 1
例:

1

max_tokens
integer

生成するコンテンツの最大 token 数を制限

説明:

  • V4 シリーズは最大 393,216 tokens まで可能
  • deepseek-v4.1-flash-1017 は 1 ~ 393,216 のみ受け付け、範囲外の値には HTTP 400 を返します
  • thinking 有効時、reasoning_tokens も max_tokens の上限に含まれます
  • 未設定の場合、モデル自身が生成長さを決定
必須範囲: 1 <= x <= 393216
例:

4096

response_format
object

レスポンスフォーマットを指定

説明:

  • {"type": "json_object"} に設定すると JSON モードを有効化
  • JSON モード下、モデルは有効な JSON 形式のコンテンツを出力します
  • 最適な効果を得るため、system または user メッセージで JSON 出力を明示的に要求することを推奨
stop

停止シーケンス、モデルがこれらの文字列に遭遇すると生成を停止

説明:

  • 単一文字列または文字列配列を指定可能
  • 最大 16 個の停止シーケンスをサポート
stream
boolean
デフォルト:false

ストリーミング方式でレスポンスを返すかどうか

  • true:ストリーミング返却、SSE(Server-Sent Events)を通じてチャンクごとにリアルタイムでコンテンツを返す
  • false:完全なレスポンスを待ってから一度に返す(デフォルト)
例:

false

stream_options
object

ストリーミングレスポンスオプション

stream=true の場合のみ有効

tools
object[]

ツール定義リスト、Function Calling に使用

説明:

  • 最大 128 個のツール定義をサポート
  • 各ツールには名前、説明、パラメータ schema を定義する必要があります
Maximum array length: 128
tool_choice

ツール呼び出し動作を制御

選択可能な値:

  • none:いかなるツールも呼び出さない
  • auto:モデルが自動的にツール呼び出しを決定(tools 提供時のデフォルト)
  • required:モデルに 1 つ以上のツールを強制的に呼び出させる
  • オブジェクト形式 {"type":"function","function":{"name":"xxx"}}:特定のツール呼び出しを指定

デフォルト値:tools を提供しない場合は none、提供する場合は auto

利用可能なオプション:
none,
auto,
required
logprobs
boolean
デフォルト:false

token の対数確率を返すかどうか

説明:

  • true に設定すると、レスポンスに各 token の対数確率情報が含まれます
top_logprobs
integer

確率の最も高い上位 N 個の token の対数確率を返す

説明:

  • logprobs を true に設定する必要があります
  • 値の範囲:[0, 20]
必須範囲: 0 <= x <= 20

レスポンス

会話生成成功

id
string

会話補完の一意識別子

例:

"53c548dc-ec02-4a2f-bbb6-eca4184630b8"

model
string

実際に使用されたモデル名

例:

"deepseek-v4-flash"

object
enum<string>

レスポンスタイプ

利用可能なオプション:
chat.completion
例:

"chat.completion"

created
integer

作成タイムスタンプ(Unix 秒)

例:

1777021417

choices
object[]

会話生成の選択肢リスト

usage
object

Token 使用統計情報(キャッシュと推論の分項を含む)

system_fingerprint
string

システム指紋識別子

例:

"fp_evolink_v4_20260402"