DeepSeek V4 API ユーザーガイド

1. 登録と認証

DeepSeek V4 APIはOpenAI SDKと互換性があり、移行コストを大幅に削減し、開発者が既存のAIエコシステムツールとシームレスに統合できるようにします。

APIキーの取得

1. DeepSeekプラットフォームにアクセスします。
2. 右上の「API Keys」->「Create new secret key」をクリックします。
3. 注意: キーは作成時に一度だけ表示されるため、安全に保存してください。

2. クイックスタート（Pythonの例）

まず、公式のOpenAI SDKをインストールします（はい、その通りです。単にOpenAI SDKを使用してください）：

pip install openai

次に、base_urlとapi_keyの2つのパラメータを変更するだけです。

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxx",  # あなたのDeepSeek APIキー
    base_url="https://api.deepseek.com"  # 重要なポイント！
)

response = client.chat.completions.create(
    model="deepseek-v4",  # モデル名、V4リリース後に異なる場合があります
    messages=[
        {"role": "system", "content": "あなたは役に立つAIアシスタントです。"},
        {"role": "user", "content": "こんにちは、DeepSeek V4を紹介してください。"},
    ],
    stream=False
)

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

3. 高度な機能

3.1 ストリーミング出力

ユーザーエクスペリエンスを向上させるために、ストリーミング出力を有効にすることをお勧めします。これにより、ユーザーはタイプライターのような生成効果を見ることができます。

stream = client.chat.completions.create(
    model="deepseek-v4",
    messages=[{"role": "user", "content": "クジラについての長い詩を書いて"}],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content is not None:
        print(chunk.choices[0].delta.content, end="")

3.2 関数呼び出し（Function Calling）

DeepSeek V4は強力なFunction Callingをサポートしており、JSONパラメータを正確に解析できるため、エージェントの構築に最適です。

3.3 JSONモード

モデルに有効なJSON形式を出力させる必要がある場合は、response_formatでjson_objectを指定し、プロンプトでJSON出力を明示的に要求してください。

4. 価格設定とコスト最適化

DeepSeek V4の価格設定は非常に手頃です（具体的な価格は公式発表待ち、参考V3は$0.14/Mトークン）。 さらにお金を節約するために：

• プロンプトキャッシュ: V4ではコンテキストキャッシュメカニズムが導入されています。システムプロンプトが長い場合（例：ナレッジベース）、キャッシュヒットにより、後続のリクエストのコストが大幅に削減されます。
• コンテキストの合理化: 無関係なチャット履歴を詰め込まないでください。

5. ベストプラクティス

• エラー処理: 特にrate_limit_exceeded (429) エラーの場合、指数バックオフ再試行戦略を使用して、必ずtry-exceptを実装してください。
• タイムアウト設定: 複雑な推論タスクは生成時間が長くなる可能性があるため、タイムアウトを60秒以上に設定してください。
• システムプロンプト: V4に明確な「ペルソナ」を与えると、パフォーマンスが向上します。

問題がありますか？APIドキュメントを確認するか、Discordコミュニティに参加して助けを求めてください。