DeepSeek API：高パフォーマンスなAIモデルの統合ガイド

API利用の開始方法

APIアクセスのセットアップは、DeepSeekプラットフォームで開発者アカウントを作成し、認証セクションで最初のAPI Keyを発行することから始まります。クイックスタートのプロセスは、認証設定、SDKのインストール、そして最初のリクエスト実行という3つの主要なステップで構成されます。提供されているテンプレートを活用することで、多くの開発者が15分以内に最初のリクエストテストを完了しています。

認証には「sk-」で始まるベアラートークン形式が使用されます。すべてのAPIエンドポイントのベースURLは https://api.deepseek.com/v1 であり、RESTfulな規則に従っています。リクエストヘッダーには、API Keyを含むAuthorizationと、application/jsonに設定されたContent-Typeが必要です。制限はアカウント単位ではなくキー単位で適用されるため、チーム内でプロジェクトごとにクォータを分配できます。

Python SDKをインストールするには、pipを使用して公式クライアントライブラリを追加します。以下のコード例は、DeepSeek V3を使用したチャット補完エンドポイントへの基本的なリクエストワークフローを示しています。

pip install deepseek-sdk

from deepseek import DeepSeek

client = DeepSeek(api_key="sk-your-api-key-here")

response = client.chat.completions.create(
    model="deepseek-chat-v3",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "量子コンピュータについて簡単に説明してください。"}
    ],
    max_tokens=500,
    temperature=0.7
)

print(response.choices[0].message.content)

SDKに依存せずにテストを行いたい開発者の場合は、curlコマンドを使用して直接HTTPコールを実行することもできます。この方法では、以下のようにヘッダーを明示的に設定してリクエストを送信します。

curl https://api.deepseek.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat-v3",
    "messages": [{"role": "user", "content": "Hello, API!"}],
    "max_tokens": 100
  }'

APIは、生成されたテキスト、トークン使用統計、およびリクエストメタデータを含むJSONレスポンスを返します。成功時にはchoices配列にモデルの出力が含まれ、エラー時にはデバッグ用の標準化されたエラーコードが返されます。usageオブジェクトには、prompt_tokens、completion_tokens、total_tokensが表示され、正確な請求金額の確認に利用できます。

• セキュリティタブからAPI Keyを取得してセットアップを完了する。
• Python SDKのインストールまたは直接のHTTPリクエストを選択する。
• 本番環境への統合前にシンプルなチャット補完で接続をテストする。
• レスポンスヘッダーを確認してレート制限の状態を監視する。