Referenz

OpenAI SDK (TypeScript)

Nutze das offizielle OpenAI Node.js SDK mit anymize als Base-URL.

1npm install openai

OpenAI SDK (Python)

Nutze das offizielle OpenAI Python SDK mit anymize als Base-URL.

1pip install openai

Basis-URLs

Je nach Feature verwendest du eine andere Base-URL.

Unterstützte Formate

Die API akzeptiert JSON (application/json) und multipart/form-data für Datei-Uploads.

Anthropic SDK (TypeScript)

Offizielles @anthropic-ai/sdk. Base URL zeigt auf /api, der Client hängt /v1/messages an. apiKey wird als x-api-key geschickt, anymize akzeptiert das.

1npm install @anthropic-ai/sdk

Anthropic SDK (Python)

anthropic.Anthropic mit base_url auf /api. api_key sendet x-api-key (funktioniert). auth_token sendet Bearer, analog zu Claude Code.

1pip install anthropic

Vercel AI SDK (OpenAI-Provider)

createOpenAI mit baseURL .../api/v1/llm spricht Chat Completions. generateText, streamText, tools: alles wie gegen api.openai.com, plus Anonymisierung.

1import { createOpenAI } from "@ai-sdk/openai"
2import { generateText } from "ai"
3
4const openai = createOpenAI({
5  apiKey: "YOUR_API_KEY",
6  baseURL: "https://app.anymize.ai/api/v1/llm",
7})
8
9const { text } = await generateText({
10  model: openai.chat("fountain-1.0"),
11  prompt: "Hello",
12})

Standard-Limits

Jeder API-Key hat Standard-Limits pro Minute und pro Tag.

Rate-Limit-Header

Jede Antwort enthält Header mit den aktuellen Limits und dem Verbrauch.

Rate-Limit-Fehler

Bei Überschreitung erhältst du einen 429-Fehler mit Retry-After-Header.

{
  "error": {
    "message": "Rate limit exceeded. Please retry after 30 seconds.",
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded"
  }
}

Retry-Strategie

Warte die im Retry-After-Header angegebene Zeit ab, bevor du es erneut versuchst.

1# Check rate limit headers in the response
2curl -i -X POST https://app.anymize.ai/api/v1/llm/chat/completions \
3  -H "Authorization: Bearer YOUR_API_KEY" \
4  -H "Content-Type: application/json" \
5  -d '{
6    "model": "fountain-1.0",
7    "messages": [{"role": "user", "content": "Hello!"}]
8  }'
9
10# Response headers include:
11# X-RateLimit-Limit-Requests: 60
12# Retry-After: 30

Credit-basierte Limits

Zusätzlich zu Rate Limits gelten Credit-basierte Limits je nach Tarif.

Höhere Limits

Du benötigst höhere Limits? Kontaktiere uns für ein Enterprise-Angebot.

HTTP-Statuscodes

Alle API-Endpunkte verwenden Standard-HTTP-Statuscodes.

Fehlerformat

Fehler werden als JSON mit error-Objekt zurückgegeben.

{
  "error": {
    "message": "Missing required field: messages",
    "type": "invalid_request_error",
    "code": "missing_messages",
    "param": "messages"
  }
}

Fehlertypen

Jeder Fehler hat einen Typ, der die Kategorie beschreibt.

Fehlercodes

Spezifische Fehlercodes für häufige Probleme.

Fehler-Beispiele

{
  "error": {
    "message": "Invalid API key",
    "type": "auth_error",
    "code": "invalid_api_key"
  }
}

{
  "error": {
    "message": "Model 'gpt-nonexistent' not found",
    "type": "invalid_request_error",
    "code": "model_not_found",
    "param": "model"
  }
}

{
  "error": {
    "message": "Rate limit exceeded. Please retry after 30 seconds.",
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded"
  }
}

{
  "error": {
    "message": "The model is currently overloaded. Please try again later.",
    "type": "api_error",
    "code": "service_unavailable"
  }
}

Best Practices

Empfehlungen für robuste Fehlerbehandlung.

• •Prüfe immer den HTTP-Statuscode, bevor du die Antwort parst.
• •Logge Fehler mit error.code und error.message für Debugging.
• •Implementiere Retry-Logik mit exponentiellem Backoff für 429 und 5xx.
• •Zeige dem Endnutzer eine hilfreiche Fehlermeldung, nicht den rohen API-Fehler.

100 gepflegte Integrations-Operationen innerhalb von 431 Routen mit insgesamt 619 Endpunkten.