Claude Sonnet 5 API-Integration
Nutze Claude Sonnet 5 über Rivya Public API v1 mit Model-ID claude-sonnet-5-chat, unterstützten Eingaben, Parametern, Files-API-Regeln, Credits und Response-Beispielen.
claude-sonnet-5-chat
text
Für den Minimalrequest nicht erforderlich
Basistarif in Credits / 1 Mio. Tokens: Eingabe 170, Ausgabe 855 Die endgültigen Auftragskosten werden auf ganze Credits aufgerundet.
Chat
Chat API: nicht-streamend + SSE-streamend
TOKEN_BASED
20000 Zeichen
Request-Kontrakt
Chat-Requests senden jeweils eine Message. Rivya speichert den Verlauf in der Session; sende kein Raw-Messages-Array.
| Key | Typ | Erforderlich | Standard | Beschreibung |
|---|---|---|---|---|
| model | string | Ja | claude-sonnet-5-chat | Verwende claude-sonnet-5-chat als API-Modell-ID. |
| session_id | string | Nein | - | Optionale, von der API erstellte Chat-Session-ID. Weglassen, um eine neue Session zu starten. |
| message | string | Ja | - | Die nächste Nutzernachricht. Der Chat-API-Verlauf kommt aus der serverseitigen Session, nicht aus einem Raw-Messages-Array. |
| attachments | array | Nein | - | Optionale Bild-file_id-Werte aus der Files API. Externe Attachment-URLs werden nicht akzeptiert. |
| enable_web_search | boolean | Nein | false | Gilt nur, wenn das ausgewählte Chat-Modell Websuche unterstützt. |
| reasoning_effort | string | Nein | default | Optionaler Reasoning Effort: default, minimal, low, medium, high oder xhigh, sofern unterstützt. |
| client_request_id | string | Nein | - | Optionale Client-ID, um Requests in deinem System nachzuverfolgen. |
| thought_mode | string | Nein | default | Optionales thought_mode: default, on oder off. Bei Modellen mit Denkfunktion aktiviert on diese Option, off deaktiviert sie und default verwendet das Standardverhalten des Modells. Andere Modelle ignorieren dieses Feld. |
| tool_slug | string | Nein | - | Optionaler Slug eines vorhandenen Rivya-Chat-Tools. Rivya fügt die Anweisungen des Tools diesem Gesprächsschritt hinzu. Wenn der Sitzung bereits ein Tool zugewiesen ist, lasse dieses Feld weg oder verwende denselben Slug. |
Modellparameter
Dieses Chat-Modell nutzt die gemeinsamen Chat-API-Felder oben. Modellspezifische Unterstützung für Websuche, Bilddatei-Anhänge, Gedanken und Reasoning steht in den Readiness-Daten.
Minimalrequest
{
"model": "claude-sonnet-5-chat",
"message": "Beschreibe drei Schritte zum Start einer Kampagne mit Produktbildern."
}Create-Response
Der Chat-Endpunkt gibt die abgeschlossene Assistant-Message, Token-Nutzung und die finale Credit-Abrechnung für diesen Turn zurück.
{
"id": "chatcmpl_assistant_message_id",
"object": "chat.completion",
"session_id": "chat_session_claude_sonnet_5_chat",
"model": "claude-sonnet-5-chat",
"created_at": "2026-05-11T00:00:00.000Z",
"message": {
"id": "assistant_message_id",
"role": "assistant",
"content": "1. Produktbilder auswählen. 2. Beiträge zum Produktstart verfassen. 3. Die Veröffentlichung planen und die Ergebnisse prüfen.",
"created_at": "2026-05-11T00:00:00.000Z"
},
"usage": {
"input_tokens": 1200,
"output_tokens": 320,
"total_tokens": 1520
},
"credits": {
"reserved": 0,
"final": 0,
"settlement_status": "PENDING"
}
}Häufige Fehler
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API unterstützt nicht-streamende und SSE-streamende Turns in Public API v1. Bildanhänge werden für dieses Chat-Modell nicht unterstützt.