メインコンテンツへスキップ
POST
/
v1
/
chat
/
completions
curl --request POST \
  --url https://api.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"
}

承認

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-reasonertemperaturetop_ptoolstool_choiceresponse_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トークンのログ確率を返す

詳細:

  • logprobstrueに設定する必要があります
  • 範囲: [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"