Übersicht

​

Zugriff auf die API

Die API wird über unsere Web-Konsole zur Verfügung gestellt. Sie können die Workbench verwenden, um die API im Browser auszuprobieren und dann API-Schlüssel in den Kontoeinstellungen zu generieren. Verwenden Sie Arbeitsbereiche, um Ihre API-Schlüssel zu segmentieren und Ausgaben zu kontrollieren nach Anwendungsfall.

​

Authentifizierung

Alle Anfragen an die Anthropic API müssen einen x-api-key Header mit Ihrem API-Schlüssel enthalten. Wenn Sie die Client SDKs verwenden, setzen Sie die API beim Erstellen eines Clients, und dann sendet das SDK den Header in Ihrem Namen mit jeder Anfrage. Wenn Sie direkt mit der API integrieren, müssen Sie diesen Header selbst senden.

​

Inhaltstypen

Die Anthropic API akzeptiert immer JSON in Anfragekörpern und gibt JSON in Antwortkörpern zurück. Sie müssen den content-type: application/json Header in Anfragen senden. Wenn Sie die Client SDKs verwenden, wird dies automatisch erledigt.

​

Anfragegrößenbeschränkungen

Die API hat eine maximale Anfragegröße von 32 MB für Standard-Endpunkte, einschließlich der Messages API und Token Counting API. Wenn Sie diese Grenze überschreiten, erhalten Sie einen 413 request_too_large Fehler von Cloudflare. Spezifische Endpunkte haben unterschiedliche Grenzen:

• Standard-Endpunkte (Messages, Token Counting): 32 MB
• Batch API: 256 MB
• Files API: 500 MB

​

Antwort-Header

Die Anthropic API enthält die folgenden Header in jeder Antwort:

• request-id: Ein global eindeutiger Identifikator für die Anfrage.

• anthropic-organization-id: Die Organisations-ID, die mit dem in der Anfrage verwendeten API-Schlüssel verknüpft ist.

​

Beispiele

curl https://api.anthropic.com/v1/messages \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "Hello, world"}
    ]
}'

curl https://api.anthropic.com/v1/messages \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "Hello, world"}
    ]
}'

pip install anthropic

import anthropic

client = anthropic.Anthropic(
    # defaults to os.environ.get("ANTHROPIC_API_KEY")
    api_key="my_api_key",
)
message = client.messages.create(
    model="claude-opus-4-20250514",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude"}
    ]
)
print(message.content)

npm install @anthropic-ai/sdk

import Anthropic from '@anthropic-ai/sdk';

const anthropic = new Anthropic({
  apiKey: 'my_api_key', // defaults to process.env["ANTHROPIC_API_KEY"]
});

const msg = await anthropic.messages.create({
  model: "claude-opus-4-20250514",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Hello, Claude" }],
});
console.log(msg);