チャット補完APIパラメータ説明

本ドキュメントはチャット補完APIのリクエストパラメータを説明します。対話モデルのレスポンス生成に使用されます。

API情報

• リクエスト方式: POST
• リクエストパス: /v1/chat/completions
• Base URL: https://api.uk72.cn

認証方式

Authorization: Bearer <APIKey>

基本パラメータ

パラメータ	型	必須	説明
model	string	はい	モデル名、例：deepseek-v3
messages	array	はい	メッセージリスト
stream	boolean	いいえ	ストリーミングレスポンスを有効にするか、デフォルトfalse

メッセージ形式

フィールド	型	説明
role	string	ロール：system、user、assistant、tool
content	string	メッセージ内容
name	string	オプション、送信者名
tool_calls	array	ツール呼び出しリスト（assistantロール）
tool_call_id	string	ツール呼び出しID（toolロール）

生成制御パラメータ

パラメータ	型	デフォルト	説明
max_tokens	integer	-	最大生成トークン数
temperature	number	1.0	サンプリング温度（0~2）
top_p	number	1.0	核サンプリングパラメータ
top_k	integer	-	Top-Kサンプリング
presence_penalty	number	0	存在ペナルティ（-2~2）
frequency_penalty	number	0	頻度ペナルティ（-2~2）
repetition_penalty	number	1.0	繰り返しペナルティ

ツール呼び出しパラメータ

パラメータ	型	説明
tools	array	ツール定義リスト
tool_choice	string/object	ツール選択戦略：none、auto、required

思考連鎖パラメータ

パラメータ	型	説明
thinking	boolean	思考連鎖を有効にするか
reasoning_effort	string	推論深度制御

リクエスト例

基本対話

curl -X POST "https://api.uk72.cn/v1/chat/completions" \
  -H "Authorization: Bearer sk-xx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v3",
    "messages": [
      {"role": "user", "content": "こんにちは"}
    ]
  }'

ストリーミングレスポンス

curl -X POST "https://api.uk72.cn/v1/chat/completions" \
  -H "Authorization: Bearer sk-xx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v3",
    "messages": [
      {"role": "user", "content": "こんにちは"}
    ],
    "stream": true
  }'

パラメータのベストプラクティス

• 創造的タスク: temperature 0.7-0.9
• 事実的回答: temperature 0.1-0.3
• コード生成: temperature 0.1-0.3
• 繰り返し軽減: repetition_penalty 1.1-1.2
• 対話シナリオ: max_tokens 500-1000

エラーハンドリング

ステータスコード	説明
400	パラメータ検証失敗
401	認証失敗
429	レート制限
500	サーバー内部エラー