StarMagicStarMagic
日本語
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
統合ガイド
DeepSeek - 完整参数文档
StarMagicStarMagic
日本語
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
テキストDeepSeekDeepseek

DeepSeek - 完全なAPIリファレンス

  • OpenAI SDK形式でDeepSeekモデルを呼び出し
  • 同期処理モード、リアルタイムレスポンス
  • deepseek-chat(一般会話)とdeepseek-reasoner(深層推論)モデルに対応
  • テキストチャット:シングルまたはマルチターンのコンテキスト会話
  • システムプロンプト:AIの役割と動作をカスタマイズ
  • ストリーミング:SSEストリーミング出力対応
  • ツール呼び出し:Function Calling対応
<Note> **BaseURL**:デフォルトの BaseURL は `https://api.starmagic.ai` で、テキストモデルへの対応が優れており、長時間接続をサポートします。`https://api.starmagic.ai` はマルチモーダルの主力エンドポイントで、テキストモデルに対しては代替アドレスとして使用されます。 </Note>

認証

Authorizationstringheader必須

##すべてのAPIにBearer Token認証が必要です## **APIキーの取得:** [APIキー管理ページ](https://starmagic.ai/app/api-keys)にアクセスしてAPIキーを取得してください **リクエストヘッダーに追加:** ``` Authorization: Bearer YOUR_API_KEY ```

Authorization: Bearer YOUR_API_KEY

リクエストボディ

application/json
modelenum<deepseek-chat | deepseek-reasoner>必須

チャットモデル名 - `deepseek-chat`:一般会話モデル - `deepseek-reasoner`:深層推論モデル、数学、コーディング、複雑な論理推論に優れる **注意**:`deepseek-reasoner`は`temperature`、`top_p`、`tools`、`tool_choice`、`response_format`パラメータに対応していません。これらを渡すとアップストリームで拒否されます

"deepseek-chat"
messagesobject[]必須

会話メッセージリスト、マルチターン会話に対応 異なるロールには異なるフィールド構造があります、対応するロールを選択して確認してください

[
  null
]
thinkingobject

思考モード制御(ベータ) **詳細**: - `deepseek-reasoner` モデルの深い思考機能を制御します - 有効にすると、モデルは応答前に深い推論を行います

{
  "type": "enabled"
}
frequency_penaltynumber

繰り返しコンテンツを減らすための頻度ペナルティパラメータ **詳細**: - 正の値は生成テキスト内の頻度に基づいてトークンにペナルティを与えます - 値が高いほど既存のコンテンツを繰り返す可能性が低くなります - デフォルト:0(ペナルティなし)

0
max_tokensinteger

生成する最大トークン数 **詳細**: - この制限に達するとモデルは生成を停止します - 設定されていない場合、モデルが生成長を決定します

4096
presence_penaltynumber

新しいトピックを促すプレゼンスペナルティパラメータ **詳細**: - 正の値はテキストに出現したかどうかに基づいてトークンにペナルティを与えます - 高い値は新しいトピックの議論を促します - デフォルト:0(ペナルティなし)

0
response_formatobject

レスポンスフォーマットを指定 **詳細**: - `{"type": "json_object"}` に設定すると JSON モードが有効になります - JSON モードでは、モデルは有効な JSON コンテンツを出力します

{
  "type": "text"
}
stopobject

停止シーケンス。モデルはこれらの文字列に遭遇すると生成を停止します **詳細**: - 単一の文字列または文字列の配列が可能 - 最大16個の停止シーケンス

streamboolean

レスポンスをストリーミングするかどうか - `true`: SSE(Server-Sent Events)でストリーミング、リアルタイムでチャンク単位でコンテンツを返却 - `false`: 完全なレスポンスを待ってから返却

false
stream_optionsobject

ストリーミングレスポンスオプション `stream=true` の場合のみ有効

{
  "include_usage": true
}
temperaturenumber

サンプリング温度、出力のランダム性を制御 **詳細**: - 低い値(例: 0.2): より決定論的で集中した出力 - 高い値(例: 1.5): よりランダムで創造的な出力 - デフォルト: 1

1
top_pnumber

Nucleus Samplingパラメータ **詳細**: - 累積確率が閾値に達するトークンからのサンプリングを制御 - 例えば、0.9は累積確率が90%に達するトークンからサンプリングすることを意味します - デフォルト: 1.0(すべてのトークンを考慮) **ヒント**: temperatureとtop_pの両方を同時に調整しないでください

1
toolsobject[]

Function Calling 用のツール定義リスト **詳細**: - 最大128個のツール定義 - 各ツールには名前、説明、パラメータスキーマが必要です

[
  {
    "type": "function",
    "function": {
      "name": "string",
      "description": "string",
      "parameters": {},
      "strict": false
    }
  }
]
tool_choiceobject

ツール呼び出しの動作を制御 **オプション**: - `none`:ツールを呼び出さない - `auto`:モデルがツールを呼び出すかどうかを判断 - `required`:モデルに1つ以上のツールの呼び出しを強制 **デフォルト**:ツール未提供時は`none`、ツール提供時は`auto`

logprobsboolean

トークンのログ確率を返すかどうか **詳細**: - `true` に設定すると、レスポンスに各トークンのログ確率情報が含まれます

false
top_logprobsinteger

最も可能性の高い上位Nトークンのログ確率を返す **詳細**: - `logprobs`を`true`に設定する必要があります - 範囲: `[0, 20]`

0

レスポンス

application/json
成功

レスポンスボディ

idstring

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

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

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

"deepseek-chat"
objectenum<chat.completion>

レスポンスタイプ

"chat.completion"
createdinteger

作成タイムスタンプ

1770617860
choicesobject[]

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

[
  {
    "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": null,
          "type": null,
          "function": null
        }
      ]
    },
    "finish_reason": "stop"
  }
]
usageobject

トークン使用統計

{
  "prompt_tokens": 16,
  "completion_tokens": 10,
  "total_tokens": 26,
  "prompt_cache_hit_tokens": 0,
  "prompt_cache_miss_tokens": 16
}
system_fingerprintstring

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

"fp_eaab8d114b_prod0820_fp8_kvcache"
POST/v1/chat/completions
curl --request POST \
  --url https://api.starmagic.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": null,
        "content": null,
        "reasoning_content": null,
        "tool_calls": null
      },
      "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"
}