Für eine direktere Anleitung zur Code-Migration, siehe unseren API-Referenz-Migrationsleitfaden.

Während wir unsere KI-Fähigkeiten weiter verbessern und erweitern, freuen wir uns, Ihnen unsere neue Messages API vorzustellen, die im Vergleich zu unserer älteren Text Completions API mehrere Vorteile bietet.

Dieser Leitfaden hilft Ihnen bei der Migration Ihrer bestehenden Anwendungen von der Text Completions API zur Messages API, um einen reibungslosen Übergang zu gewährleisten und den Zugriff auf unsere neuesten Funktionen und Verbesserungen freizuschalten.


Warum auf die Messages API upgraden?

Die Messages API bietet mehrere wichtige Vorteile:

  1. Bildverarbeitung: Die Messages API ist die einzige Möglichkeit, Bilder mit Claude zu verarbeiten, sodass Sie unsere fortschrittlichen Computer-Vision-Fähigkeiten für Aufgaben wie Bildklassifizierung, Objekterkennung und mehr nutzen können.
  2. Entwicklung mit Claude 3-Modellen: Unsere neuesten und leistungsstärksten Claude 3-Modelle (Haiku, Sonnet und Opus) können nur über die Messages API aufgerufen werden. Durch das Upgrade können Sie von ihrer verbesserten Leistung und ihren Fähigkeiten profitieren.
  3. Verbesserte Fehlerbehandlung: Die Messages API ermöglicht es uns, aussagekräftigere und hilfreichere Fehlermeldungen zurückzugeben, sodass Sie Probleme in Ihren Anfragen einfacher diagnostizieren und beheben können.
  4. Bessere Anfragenvalidierung: Mit der Messages API können wir Ihre API-Anfragen effektiver validieren und sicherstellen, dass Sie die hochwertigsten Ergebnisse und die bestmögliche Leistung von unseren Modellen erhalten.

Wie man auf die Messages API upgradet

Der einfachste Weg, von der Text Completions API auf die Messages API zu upgraden, ist die Verwendung unserer Web-Console, um Ihre Prompts zu konvertieren. Durch die Verwendung der Console können Sie Ihre Prompts und Anfragen schnell und einfach zur Messages API migrieren, ohne Ihren Code manuell umschreiben zu müssen.

Folgen Sie einfach diesen Schritten:

1. Gehen Sie zur Console und wählen Sie das Modell aus, das Sie verwenden möchten

In der Console befindet sich unten rechts im Nachrichtenbereich ein Modelleinstellungsbereich. Dieser Bereich enthält ein Dropdown-Menü, in dem Sie das richtige Modell für Ihren migrierten Prompt auswählen können.

Hier können Sie auch bei Bedarf zusätzliche Parameter anpassen, wie z. B. Temperatur und maximale Tokens zum Sampling. Weitere Informationen zu unseren Parametern finden Sie in der Messages API-Dokumentation.

2. Übertragen Sie Ihren Prompt in die entsprechenden Console-Nachrichtenfelder

Text Completions API-Prompts sind mehrzeilige Strings, die alle Teile eines Prompts umfassen, wie z. B. sowohl den System-Prompt als auch den User-Turn. Die Messages API teilt die verschiedenen Teile eines Prompts, wie z. B. den System-Prompt und den User-Turn, in separate Felder auf.

Nehmen wir zum Beispiel diesen Text Completions API-Prompt:

Text
Today is March 4, 2024.

H: What are 3 ways to cook apples?

A:

Ohne die Console zu verwenden, würde die Umstellung dieses Prompts erfordern, dass Sie Ihren Code vollständig in die Messages API umschreiben. Wenn Sie jedoch die einzelnen Teile Ihres Prompts (System-Prompt und User-Prompt) in die entsprechenden Console-Felder einfügen, können Sie sofort korrekten, vorformatierten Code extrahieren.

In der Console würde der obige Prompt so aussehen:

Beachten Sie, dass es keinen Human:- oder Assistant:-Text gibt und dass der System-Prompt und der User-Prompt in verschiedene Nachrichtenfelder gehören.

3. Kopieren Sie den vorformatierten Code

Sobald alle Teile Ihres Prompts an Ort und Stelle sind und die Parameter angepasst wurden, klicken Sie oben rechts auf die Schaltfläche </> Get Code, um den entsprechenden Messages API-Codeausschnitt sowohl für Python als auch für TypeScript anzuzeigen und zu kopieren.

Für unseren Beispiel-Prompt würde die automatisierte Python-Ausgabe aus dem </> Get Code-Menü wie folgt aussehen:

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)

Hinweis: Die Console erlaubt es noch nicht, Claudes Antwort vorzufüllen (d. h. Text im Assistant-Turn vorzufüllen), aber die zugrunde liegende Messages API tut dies. Beispiele für die Formatierung einer Messages API-Anfrage mit dieser Technik finden Sie in unserem Leitfaden zum Vorfüllen von Claudes Antwort.


Migration von anderen Modellen

Wenn Sie derzeit eine andere KI-Plattform oder ein anderes Modell verwenden und mit der Messages API zu Claude wechseln möchten, haben wir einen umfassenden Leitfaden erstellt, der Ihnen bei diesem Prozess hilft. Ausführliche Anweisungen zur Anpassung Ihrer Prompts und Ihres Codes an unsere Plattform finden Sie unter Migration von anderen Modellen.


API-Dokumentation

Weitere Informationen zur Messages API und ihren Funktionen finden Sie in unserer API-Dokumentation:

Wenn Sie Fragen haben oder weitere Unterstützung beim Upgrade auf die Messages API benötigen, zögern Sie bitte nicht, sich an unser Support-Team zu wenden. Wir sind hier, um Ihnen dabei zu helfen, das Beste aus unseren KI-Fähigkeiten herauszuholen und einen reibungslosen Übergang zu Claude zu gewährleisten.