Dokumentation API-Referenz SDK-Referenz Agentic-Nutzung KI-Skills

Messages (Anthropic)

Nachricht erstellen

Fordert eine Modellantwort im nativen /v1/messages-Format von Anthropic an; BazaarLink routet sie zu jedem unterstützten Modell, nicht nur zu Anthropics eigenen. Richten Sie die base_url des offiziellen Anthropic SDK auf BazaarLink — bestehender Code funktioniert unverändert. Akzeptiert entweder Authorization: Bearer oder den beim Anthropic SDK üblichen x-api-key-Header. Ist das aufgelöste Modell kein natives Anthropic-Modell, übersetzt BazaarLink Anfrage/Antwort transparent und erhält dabei tool_use-Blöcke und die stop_reason-Semantik so weit wie möglich.

POST/api/v1/messages

Autorisierung

Authorizationerforderlich

string · header

API-Schlüssel als Bearer-Token im Authorization-Header.

Body

modelerforderlich

string

Das zu verwendende Modell, mit Provider-Präfix, z. B. "anthropic/claude-sonnet-4.6".

minLength: 1

Example: "anthropic/claude-sonnet-4.6"

messageserforderlich

Message[]

Array von Konversationsnachrichten, mindestens eine. Jede hat eine role (user/assistant) und content (ein String oder ein Array von Content-Blöcken wie text/image/tool_use/tool_result).

minLength: 1

max_tokenserforderlich

integer

Maximale Anzahl an Tokens, die die Antwort generieren darf. Anders als bei den OpenAI-kompatiblen Endpunkten ist dieses Feld im Anthropic-Format erforderlich.

positive integer

Example: 1024

system

string | ContentBlock[]

System-Prompt — ein separates Top-Level-Feld, keine Nachricht innerhalb des messages-Arrays (einer der Hauptunterschiede zum OpenAI-Format).

stream

boolean

true streamt die Antwort als SSE (message_start / content_block_delta / message_delta / message_stop Events); weggelassen oder false liefert eine einzelne JSON-Antwort.

temperature

number

Sampling-Temperatur — höher ist zufälliger, niedriger ist deterministischer. Wird von BazaarLink nicht validiert — unverändert an den Upstream weitergeleitet. Ist das aufgelöste Modell kein natives Anthropic-Modell, hängt die Behandlung dieses Felds von BazaarLinks Übersetzungsschicht ab.

0–1

top_p

number

Nucleus-Sampling-Schwellenwert. Wird von BazaarLink nicht validiert — unverändert an den Upstream weitergeleitet. Ist das aufgelöste Modell kein natives Anthropic-Modell, hängt die Behandlung dieses Felds von BazaarLinks Übersetzungsschicht ab.

0–1

top_k

integer

Begrenzt das Sampling auf die K wahrscheinlichsten Tokens. Wird von BazaarLink nicht validiert — unverändert an den Upstream weitergeleitet. Ist das aufgelöste Modell kein natives Anthropic-Modell, hängt die Behandlung dieses Felds von BazaarLinks Übersetzungsschicht ab.

stop_sequences

string[]

Array von Strings, bei denen die Generierung stoppt. Wird von BazaarLink nicht validiert — unverändert an den Upstream weitergeleitet. Ist das aufgelöste Modell kein natives Anthropic-Modell, hängt die Behandlung dieses Felds von BazaarLinks Übersetzungsschicht ab.

tools

Tool[]

Liste der Tool-Definitionen, die das Modell aufrufen kann, im Anthropic-Format (name, description, input_schema). Wird von BazaarLink nicht validiert — unverändert an den Upstream weitergeleitet. Ist das aufgelöste Modell kein natives Anthropic-Modell, hängt die Behandlung dieses Felds von BazaarLinks Übersetzungsschicht ab.

tool_choice

object

Steuert, ob/wie das Modell zum Aufrufen eines Tools gezwungen wird, z. B. {type:"auto"}, {type:"any"}, {type:"tool", name:"..."}. Wird von BazaarLink nicht validiert — unverändert an den Upstream weitergeleitet. Ist das aufgelöste Modell kein natives Anthropic-Modell, hängt die Behandlung dieses Felds von BazaarLinks Übersetzungsschicht ab.

thinking

object

Extended-Thinking-Steuerungsobjekt, z. B. {type:"enabled", budget_tokens:2048}. Nur bei Reasoning-Modellen sinnvoll. Wird von BazaarLink nicht validiert — unverändert an den Upstream weitergeleitet. Ist das aufgelöste Modell kein natives Anthropic-Modell, hängt die Behandlung dieses Felds von BazaarLinks Übersetzungsschicht ab.

metadata

object

Anfrage-Metadaten, z. B. {user_id:"..."}. Für Überwachung und Missbrauchserkennung; hat keine Auswirkung auf die Abrechnung. Wird von BazaarLink nicht validiert — unverändert an den Upstream weitergeleitet. Ist das aufgelöste Modell kein natives Anthropic-Modell, hängt die Behandlung dieses Felds von BazaarLinks Übersetzungsschicht ab.

POST /api/v1/messages

1
2
3
4
5
6
7
8
curl https://bazaarlink.ai/api/v1/messages \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4.6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Antwortbeispiele

Erfolg. Standardmäßig (oder mit stream: false) wird das untenstehende native Anthropic-Message-Objekt zurückgegeben; mit stream: true stattdessen ein SSE-Event-Stream (message_start / content_block_delta / message_delta / message_stop — Protokoll siehe Detailguide). model spiegelt immer den angeforderten Namen wider (nie das tatsächlich aufgelöste Upstream-Modell). usage behält die nativen Anthropic-Felder (input_tokens, output_tokens, cache_creation_input_tokens, cache_read_input_tokens) bei, zuzüglich cost/bz_cost — BazaarLinks eigener abgerechneter Betrag, niemals ein von Upstream weitergeleiteter Wert.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "model": "anthropic/claude-sonnet-4.6",
  "content": [
    {
      "type": "text",
      "text": "Hello! How can I help you today?"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 10,
    "output_tokens": 12,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "cost": 0.000186,
    "bz_cost": 0.000186
  }
}