より直接的なコードへの移行ガイドについては、APIリファレンス移行ガイドをご覧ください。

私たちはAI機能の改善と拡張を続けており、レガシーのText Completions APIに比べていくつかの利点を提供する新しいMessages APIを導入できることを嬉しく思います。

このガイドでは、既存のアプリケーションをText Completions APIからMessages APIに移行する方法を説明し、スムーズな移行を確保し、最新の機能と改善へのアクセスを可能にします。


Messages APIにアップグレードする理由

Messages APIにはいくつかの重要な利点があります:

  1. 画像処理: Messages APIは、Claudeで画像を処理する唯一の方法であり、画像分類、物体検出などのタスクに高度なコンピュータビジョン機能を活用できます。
  2. Claude 3モデルの構築: 最新で最も強力なClaude 3モデル(Haiku、Sonnet、Opus)は、Messages APIを介してのみ呼び出すことができます。アップグレードすることで、それらの強化されたパフォーマンスと機能を活用できます。
  3. エラー処理の改善: Messages APIでは、より有益なエラーメッセージを返すことができるため、リクエストの問題を診断して解決するのが容易になります。
  4. リクエスト検証の改善: Messages APIを使用すると、APIリクエストをより効果的に検証できるため、最高品質の結果とモデルから最高のパフォーマンスを得られることが保証されます。

Messages APIへのアップグレード方法

Text Completions APIからMessages APIにアップグレードする最も簡単な方法は、ウェブConsoleを使用してプロンプトを変換することです。Consoleを使用すると、コードを手動で書き換えることなく、プロンプトとリクエストをMessages APIに迅速かつ簡単に移行できます。

以下の手順に従ってください:

1. Consoleに移動し、使用するモデルを選択します

Console内のメッセージエリアの右下にあるモデル設定パネルには、移行したプロンプトに適したモデルを選択するためのドロップダウンメニューがあります。

ここでは、temperatureやmaximum tokens to sampleなどの追加パラメータを必要に応じて調整することもできます。パラメータの詳細については、Messages APIドキュメントを参照してください。

2. プロンプトを適切なConsoleメッセージフィールドに転送します

Text Completions APIプロンプトは、システムプロンプトとユーザーターンの両方など、プロンプトのすべての部分を含む複数行の文字列です。Messages APIでは、システムプロンプトやユーザーターンなどのプロンプトのさまざまな部分を別々のフィールドに分割します。

たとえば、次のようなText Completions APIプロンプトを考えてみましょう:

Text
Today is March 4, 2024.

H: What are 3 ways to cook apples?

A:

Consoleを使用しない場合、このプロンプトの移行には、コード全体をMessages APIに書き換える必要があります。ただし、プロンプトの個別の部分(システムプロンプトとユーザープロンプト)を対応するConsoleフィールドにドロップすると、すぐに使える正しい事前フォーマットされたコードを抽出できます。

Consoleでは、上記のプロンプトは次のようになります:

Human:Assistant:のテキストはなく、システムプロンプトとユーザープロンプトが別々のメッセージフィールドに属していることに注意してください。

3. 事前フォーマットされたコードをコピーします

プロンプトのすべての部分が配置され、パラメータが調整されたら、右上の</> Get Codeボタンをクリックして、PythonとTypeScriptの両方に対応するMessages APIコードスニペットを表示してコピーします。

上記の例のプロンプトの場合、</> Get Codeメニューから自動生成されたPythonの出力は次のようになります:

Python
import anthropic

client = anthropic.Anthropic(
    # defaults to os.environ.get("ANTHROPIC_API_KEY")
    api_key="my_api_key",
)
message = client.messages.create(
    model="claude-3-opus-20240229",
    max_tokens=1000,
    temperature=0,
    system="Today is March 4, 2024.",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "What are 3 ways to cook apples?"
                }
            ]
        }
    ]
)
print(message.content)

注意: Consoleでは、まだClaudeの応答を事前入力すること(つまり、Assistantターンにテキストを事前入力すること)はできませんが、基盤となるMessages APIではできます。このテクニックを使用してMessages APIリクエストをフォーマットする方法の例については、Claudeの応答を事前入力する方法に関するガイドを参照してください。


他のモデルからの移行

現在、別のAIプラットフォームやモデルを使用していて、Messages APIを使用してClaudeに切り替えたい場合は、プロセスを支援するための包括的なガイドを作成しました。プロンプトとコードを当社のプラットフォームに適合させる方法の詳細な手順については、他のモデルからの移行を参照してください。


APIドキュメント

Messages APIとその機能の詳細については、APIドキュメントを参照してください:

Messages APIへのアップグレードについて質問や追加の支援が必要な場合は、サポートチームにお問い合わせください。私たちは、お客様がAI機能を最大限に活用し、Claudeへのスムーズな移行を確保するためにここにいます。