API-Referenz Überblick

Basis-URL, Authentifizierung, Oberflächen und die vollständige Endpunkt-Karte der Ablatic-API

Diese Seite ist die Karte der Ablatic-API: die Basis-URL, die Authentifizierung, die beiden kompatiblen Oberflächen und jeder öffentliche Endpunkt.

Basis-URL

https://api.ablatic.ai/v1

Der Host api.ablatic.ai leitet ausschließlich /v1/* und /health weiter. Jeder andere Pfad liefert 404.

Jede Anfrage außer den unten genannten unauthentifizierten Probes benötigt einen API-Schlüssel. Schlüssel haben die Form sk-ablatic-... und werden in der Console erstellt. Ein Schlüssel wird bei der Erstellung einmalig angezeigt und nur als SHA-256-Hash gespeichert, daher lässt er sich nicht wiederherstellen.

Zwei Header tragen den Schlüssel, einer pro Oberfläche. Beide durchlaufen dieselbe Validierung.

Authorization: Bearer sk-ablatic-...

x-api-key: sk-ablatic-...

Verwenden Sie Authorization: Bearer auf den Endpunkten im OpenAI-Stil. Verwenden Sie x-api-key auf den Endpunkten im Anthropic-Stil.

Die beiden Oberflächen

Die API stellt dasselbe Modell über zwei Anfrage- und Antwortformen bereit.

OpenAI-Stil. Drop-in für das openai SDK. Basis-URL https://api.ablatic.ai/v1, Modell talos, Authorization: Bearer.
Anthropic-Stil. Drop-in für das anthropic SDK und Claude Code. Basis-URL https://api.ablatic.ai, Endpunkt /v1/messages, Schlüssel über x-api-key.

Das Standardmodell ist talos. Den Reasoning-Modus wählen Sie über reasoning_effort. Siehe Models.

Endpunkte

OpenAI-Stil

Methode	Pfad	Zweck
POST	`/v1/chat/completions`	Chat-Completion, Streaming SSE
GET	`/v1/models`	Listet das Modell (keine Auth)
GET	`/v1/audit`	Listet Glassbox-Audit-Datensätze
GET	`/v1/audit/stats`	Audit-Zusammenfassungsstatistik
GET	`/v1/audit/{request_id}`	Ruft einen Audit-Datensatz ab
DELETE	`/v1/audit/{request_id}`	DSGVO-Löschung eines Datensatzes
POST	`/v1/files`	Lädt eine Datei zur Kontext-Injektion hoch
GET	`/v1/files`	Listet hochgeladene Dateien
GET	`/v1/files/{file_id}`	Ruft eine Datei ab
DELETE	`/v1/files/{file_id}`	Löscht eine Datei
POST	`/v1/agent/run`	Serverseitige autonome Agent-Schleife
POST	`/v1/agent/run/{run_id}/cancel`	Bricht einen laufenden Agenten ab
POST	`/v1/simulation/analyze`	Analysiert HDF5-, NumPy- oder Videodaten

Anthropic-Stil

Methode	Pfad	Zweck
POST	`/v1/messages`	Anthropic-Messages-Completion
POST	`/v1/messages/count_tokens`	Schätzt Input-Token (heuristisch)
GET	`/v1/messages/_health`	Health-Probe (keine Auth)
POST	`/v1/messages/batches`	Erstellt einen Message-Batch
GET	`/v1/messages/batches`	Listet Batches
GET	`/v1/messages/batches/{id}`	Ruft einen Batch ab
POST	`/v1/messages/batches/{id}/cancel`	Bricht einen Batch ab
DELETE	`/v1/messages/batches/{id}`	Löscht einen Batch
GET	`/v1/messages/batches/{id}/results`	Streamt Batch-Ergebnisse (NDJSON)

Message Batches laufen auf der Anthropic-kompatiblen Schnittstelle. Den OpenAI-Endpunkt /v1/batches gibt es nicht. Siehe Batch.

Keine Authentifizierung

Drei Endpunkte benötigen keinen Schlüssel: GET /v1/models, GET /v1/messages/_health und GET /health.

Gemeinsame Header

Diese Header begleiten die meisten Anfragen und Antworten über beide Oberflächen hinweg.

Richtung	Header	Bedeutung
Request	`X-Timezone`	Zeitzone für Nutzungs- und Abrechnungsfenster. Standard UTC
Request	`Idempotency-Key`	Schlüssel für sicheres erneutes Senden bei der Batch-Erstellung
Response	`X-Request-Id`	Eindeutige id der Anfrage, geben Sie sie in Support-Tickets an
Response	`X-RateLimit-Limit`	Limit gleichzeitiger Anfragen (siehe Hinweis unten)
Response	`X-RateLimit-Remaining`	Verbleibende Kapazität
Response	`X-RateLimit-Reset`	Wann das Fenster zurückgesetzt wird
Response	`Retry-After`	Wartezeit in Sekunden, gesendet bei 429 und 503

X-RateLimit-Limit gibt derzeit das Limit gleichzeitiger Anfragen wieder, nicht Anfragen pro Minute. Lesen Sie es nicht als RPM. Siehe Rate Limits.