Datenspeicherort

Mit Datenspeicherort-Kontrollen können Sie verwalten, wo Ihre Daten verarbeitet und gespeichert werden. Zwei unabhängige Einstellungen regeln dies:

• Inference Geo: Steuert, wo die Modellableitung ausgeführt wird, auf Basis pro Anfrage. Wird über den inference_geo API-Parameter oder als Workspace-Standard festgelegt.
• Workspace Geo: Steuert, wo Daten im Ruhezustand gespeichert werden und wo die Endpunktverarbeitung (Bildtranskodierung, Code-Ausführung usw.) stattfindet. Wird auf Workspace-Ebene in der Console konfiguriert.

Inference Geo

Der inference_geo-Parameter steuert, wo die Modellableitung für eine bestimmte API-Anfrage ausgeführt wird. Fügen Sie ihn zu jedem POST /v1/messages-Aufruf hinzu.

API-Verwendung

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-6",
        "max_tokens": 1024,
        "inference_geo": "us",
        "messages": [{
            "role": "user",
            "content": "Summarize the key points of this document."
        }]
    }'

Antwort

Das Antwort-usage-Objekt enthält ein inference_geo-Feld, das angibt, wo die Ableitung ausgeführt wurde:

{
  "usage": {
    "input_tokens": 25,
    "output_tokens": 150,
    "inference_geo": "us"
  }
}

Modellverfügbarkeit

Der inference_geo-Parameter wird auf Claude Opus 4.6 und allen nachfolgenden Modellen unterstützt. Ältere Modelle, die vor Opus 4.6 veröffentlicht wurden, unterstützen den Parameter nicht. Anfragen mit inference_geo auf Legacy-Modellen geben einen 400-Fehler zurück.

Einschränkungen auf Workspace-Ebene

Workspace-Einstellungen unterstützen auch die Einschränkung, welche Inference-Geos verfügbar sind:

• allowed_inference_geos: Schränkt ein, welche Geos ein Workspace verwenden kann. Wenn eine Anfrage ein inference_geo angibt, das nicht in dieser Liste enthalten ist, gibt die API einen Fehler zurück.
• default_inference_geo: Legt die Fallback-Geo fest, wenn inference_geo in einer Anfrage weggelassen wird. Einzelne Anfragen können dies überschreiben, indem sie inference_geo explizit festlegen.

Diese Einstellungen können über die Console oder die Admin API unter dem Feld data_residency konfiguriert werden.

Workspace Geo

Workspace Geo wird beim Erstellen eines Workspace festgelegt und kann danach nicht mehr geändert werden. Derzeit ist "us" die einzige verfügbare Workspace-Geo.

Um Workspace Geo festzulegen, erstellen Sie einen neuen Workspace in der Console:

1. Gehen Sie zu Settings > Workspaces.
2. Erstellen Sie einen neuen Workspace.
3. Wählen Sie die Workspace-Geo aus.

Preisgestaltung

Die Preisgestaltung für Datenspeicherort variiert je nach Modellgeneration:

• Claude Opus 4.6 und neuer: Nur US-Ableitung (inference_geo: "us") wird mit dem 1,1-fachen des Standardsatzes über alle Token-Preiskategorien hinweg berechnet (Input-Token, Output-Token, Cache-Schreibvorgänge und Cache-Lesevorgänge).
• Globales Routing (inference_geo: "global" oder weggelassen): Standardpreisgestaltung gilt.
• Ältere Modelle: Die vorhandene Preisgestaltung bleibt unverändert, unabhängig von inference_geo-Einstellungen.

Diese Preisgestaltung gilt nur für die Claude API (1P). Plattformen von Drittanbietern (AWS Bedrock, Google Vertex AI, Microsoft Foundry) haben ihre eigene regionale Preisgestaltung. Weitere Informationen finden Sie auf der Preisseite.

Batch API-Unterstützung

Der inference_geo-Parameter wird auf der Batch API unterstützt. Jede Anfrage in einem Batch kann ihren eigenen inference_geo-Wert angeben.

Migration von Legacy-Opt-outs

Wenn Ihre Organisation zuvor aus dem globalen Routing ausgestiegen ist, um die Ableitung in den USA zu halten, wurde Ihr Workspace automatisch mit allowed_inference_geos: ["us"] und default_inference_geo: "us" konfiguriert. Es sind keine Code-Änderungen erforderlich. Ihre bestehenden Datenspeicherort-Anforderungen werden weiterhin durch die neuen Geo-Kontrollen durchgesetzt.

Was sich geändert hat

Das Legacy-Opt-out war eine Einstellung auf Organisationsebene, die alle Anfragen auf US-basierte Infrastruktur beschränkte. Die neuen Datenspeicherort-Kontrollen ersetzen dies durch zwei Mechanismen:

• Pro-Anfrage-Kontrolle: Der inference_geo-Parameter ermöglicht es Ihnen, "us" oder "global" bei jedem API-Aufruf anzugeben, was Ihnen Flexibilität auf Anfrage-Ebene gibt.
• Workspace-Kontrollen: Die Einstellungen default_inference_geo und allowed_inference_geos in der Console ermöglichen es Ihnen, Geo-Richtlinien über alle Schlüssel in einem Workspace durchzusetzen.

Was mit Ihrem Workspace geschah

Ihr Workspace wurde automatisch migriert:

Alle API-Anfragen mit Schlüsseln aus Ihrem Workspace werden weiterhin auf US-basierter Infrastruktur ausgeführt. Es ist keine Aktion erforderlich, um Ihr aktuelles Verhalten beizubehalten.

Wenn Sie globales Routing verwenden möchten

Wenn sich Ihre Datenspeicherort-Anforderungen geändert haben und Sie die Vorteile des globalen Routings für bessere Leistung und Verfügbarkeit nutzen möchten, aktualisieren Sie die Inference-Geo-Einstellungen Ihres Workspace, um "global" in die zulässigen Geos einzubeziehen und default_inference_geo auf "global" zu setzen. Weitere Informationen finden Sie unter Einschränkungen auf Workspace-Ebene.

Auswirkungen auf die Preisgestaltung

Legacy-Modelle sind von dieser Migration nicht betroffen. Aktuelle Preisgestaltung für neuere Modelle finden Sie unter Preisgestaltung.

Aktuelle Einschränkungen

• Gemeinsame Ratenlimits: Ratenlimits werden über alle Geos hinweg gemeinsam genutzt.
• Inference Geo: Nur "us" und "global" sind beim Start verfügbar. Weitere Regionen werden im Laufe der Zeit hinzugefügt.
• Workspace Geo: Derzeit ist nur "us" verfügbar. Workspace Geo kann nach der Workspace-Erstellung nicht geändert werden.

Nächste Schritte