メインコンテンツへスキップ
POST
/
v1
/
chat
/
completions
curl --request POST \
  --url https://direct.evolink.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "deepseek-chat",
  "messages": [
    {
      "role": "user",
      "content": "Tell me about yourself"
    }
  ]
}
'
{
  "id": "930c60df-bf64-41c9-a88e-3ec75f81e00e",
  "model": "deepseek-chat",
  "object": "chat.completion",
  "created": 1770617860,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! I'm DeepSeek, a powerful AI assistant. I excel at general conversation, code generation, mathematical reasoning and many other tasks.",
        "reasoning_content": "Let me analyze this problem...",
        "tool_calls": [
          {
            "id": "<string>",
            "type": "function",
            "function": {
              "name": "<string>",
              "arguments": "<string>"
            }
          }
        ]
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 16,
    "completion_tokens": 10,
    "total_tokens": 26,
    "prompt_cache_hit_tokens": 0,
    "prompt_cache_miss_tokens": 16
  },
  "system_fingerprint": "fp_eaab8d114b_prod0820_fp8_kvcache"
}
BaseURL：デフォルトの BaseURL は https://direct.evolink.ai で、テキストモデルへの対応が優れており、長時間接続をサポートします。https://api.evolink.ai はマルチモーダルの主力エンドポイントで、テキストモデルに対しては代替アドレスとして使用されます。

承認

​
Authorization
string
header
必須

##すべてのAPIにBearer Token認証が必要です##

APIキーの取得：

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

リクエストヘッダーに追加：

Authorization: Bearer YOUR_API_KEY

ボディ

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

チャットモデル名

  • deepseek-chat：一般会話モデル
  • deepseek-reasoner：深層推論モデル、数学、コーディング、複雑な論理推論に優れる

注意：deepseek-reasonerはtemperature、top_p、tools、tool_choice、response_formatパラメータに対応していません。これらを渡すとアップストリームで拒否されます

利用可能なオプション:
deepseek-chat,
deepseek-reasoner
例:

"deepseek-chat"

​
messages
(システムメッセージ · object | ユーザーメッセージ · object | アシスタントメッセージ · object | ツールメッセージ · object)[]
必須

会話メッセージリスト、マルチターン会話に対応

異なるロールには異なるフィールド構造があります、対応するロールを選択して確認してください

Minimum array length: 1
​
thinking
object

思考モード制御（ベータ）

詳細:

  • deepseek-reasoner モデルの深い思考機能を制御します
  • 有効にすると、モデルは応答前に深い推論を行います
​
frequency_penalty
number
デフォルト:0

繰り返しコンテンツを減らすための頻度ペナルティパラメータ

詳細：

  • 正の値は生成テキスト内の頻度に基づいてトークンにペナルティを与えます
  • 値が高いほど既存のコンテンツを繰り返す可能性が低くなります
  • デフォルト：0（ペナルティなし）
必須範囲: -2 <= x <= 2
例:

0

​
max_tokens
integer

生成する最大トークン数

詳細:

  • この制限に達するとモデルは生成を停止します
  • 設定されていない場合、モデルが生成長を決定します
必須範囲: x >= 1
例:

4096

​
presence_penalty
number
デフォルト:0

新しいトピックを促すプレゼンスペナルティパラメータ

詳細:

  • 正の値はテキストに出現したかどうかに基づいてトークンにペナルティを与えます
  • 高い値は新しいトピックの議論を促します
  • デフォルト:0(ペナルティなし)
必須範囲: -2 <= x <= 2
例:

0

​
response_format
object

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

詳細:

  • {"type": "json_object"} に設定すると JSON モードが有効になります
  • JSON モードでは、モデルは有効な JSON コンテンツを出力します
​
stop

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

詳細:

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

レスポンスをストリーミングするかどうか

  • true: SSE（Server-Sent Events）でストリーミング、リアルタイムでチャンク単位でコンテンツを返却
  • false: 完全なレスポンスを待ってから返却
例:

false

​
stream_options
object

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

stream=true の場合のみ有効

​
temperature
number
デフォルト:1

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

詳細:

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

1

​
top_p
number
デフォルト:1

Nucleus Samplingパラメータ

詳細:

  • 累積確率が閾値に達するトークンからのサンプリングを制御
  • 例えば、0.9は累積確率が90%に達するトークンからサンプリングすることを意味します
  • デフォルト: 1.0（すべてのトークンを考慮）

ヒント: temperatureとtop_pの両方を同時に調整しないでください

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

1

​
tools
object[]

Function Calling 用のツール定義リスト

詳細:

  • 最大128個のツール定義
  • 各ツールには名前、説明、パラメータスキーマが必要です
Maximum array length: 128
​
tool_choice

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

オプション：

  • none：ツールを呼び出さない
  • auto：モデルがツールを呼び出すかどうかを判断
  • required：モデルに1つ以上のツールの呼び出しを強制

デフォルト：ツール未提供時はnone、ツール提供時はauto

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

トークンのログ確率を返すかどうか

詳細:

  • true に設定すると、レスポンスに各トークンのログ確率情報が含まれます
​
top_logprobs
integer

最も可能性の高い上位Nトークンのログ確率を返す

詳細:

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

レスポンス

チャット補完が正常に生成されました

​
id
string

チャット補完の一意の識別子

例:

"930c60df-bf64-41c9-a88e-3ec75f81e00e"

​
model
string

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

例:

"deepseek-chat"

​
object
enum<string>

レスポンスタイプ

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

"chat.completion"

​
created
integer

作成タイムスタンプ

例:

1770617860

​
choices
object[]

チャット補完選択肢のリスト

​
usage
object

トークン使用統計

​
system_fingerprint
string

システムフィンガープリント識別子

例:

"fp_eaab8d114b_prod0820_fp8_kvcache"