APIの使用方法
バージョン
APIリクエストを行う際は、anthropic-version
リクエストヘッダーを送信する必要があります。例えば、anthropic-version: 2023-06-01
のようになります。クライアントライブラリを使用している場合、これは自動的に処理されます。
特定のAPIバージョンについて、以下を維持します:
- 既存の入力パラメータ
- 既存の出力パラメータ
ただし、以下の変更を行う場合があります:
- 追加のオプション入力の追加
- 出力への追加値の追加
- 特定のエラータイプの条件変更
- 列挙型のような出力値への新しいバリアントの追加(例:ストリーミングイベントタイプ)
一般的に、このリファレンスに記載されている通りにAPIを使用している場合、使用方法が破壊されることはありません。
バージョン履歴
可能な限り最新のAPIバージョンを使用することを常に推奨します。以前のバージョンは非推奨とみなされ、新規ユーザーは利用できない場合があります。
2023-06-01
- ストリーミングのサーバー送信イベント(SSE)の新しい形式:
- 補完は増分的です。例えば、
" こんにちは"
、" 私の"
、" 名前は"
、" Claude"
、" です。"
のように、" こんにちは"
、" こんにちは私の"
、" こんにちは私の名前は"
、" こんにちは私の名前はClaude"
、" こんにちは私の名前はClaudeです。"
ではありません。 - すべてのイベントはデータのみのイベントではなく、名前付きイベントです。
- 不要な
data: [DONE]
イベントを削除。
- 補完は増分的です。例えば、
- レスポンスから従来の
exception
およびtruncated
値を削除。
- ストリーミングのサーバー送信イベント(SSE)の新しい形式:
2023-01-01
:初回リリース。