Zum Hauptinhalt springen

Übersicht

Die LemonData API ist für Drop-in-Kompatibilität mit allen gängigen KI-Entwicklungstools konzipiert. Dieser Leitfaden dokumentiert unterstützte Parameter und verifizierte Integrationen.
Alle Parameter werden validiert, aber an die Upstream-Provider weitergereicht. Nicht unterstützte Parameter für spezifische Modelle werden stillschweigend ignoriert, um maximale Kompatibilität zu gewährleisten.

Unterstützte API-Formate

EndpointFormatAnwendungsfall
/v1/chat/completionsOpenAI ChatUniverselle Kompatibilität
/v1/responsesOpenAI ResponsesStateful Konversationen
/v1/messagesAnthropic MessagesClaude-native Funktionen
/v1beta/models/:model:generateContentGoogle GeminiGemini-native Funktionen

IDE- & CLI-Kompatibilität

Verifizierte Tools

ToolStatusFormatAnmerkungen
Cursor✅ VollständigOpenAIAnthropic-Tool-Format unterstützt
Claude Code CLI✅ VollständigAnthropicExtended Thinking, tool_choice
Windsurf✅ VollständigOpenAIStandard-OpenAI-Format
Aider✅ VollständigOpenAIAlle Modelle unterstützt
Continue.dev✅ VollständigOpenAI/AnthropicUnterstützung für duale Formate
OpenCode✅ VollständigOpenAIMulti-Provider-Unterstützung
Cline/Roo Code✅ VollständigOpenAIÜber OpenRouter-Format
GitHub Copilot✅ VollständigOpenAIStandardformat
Codex CLI✅ VollständigOpenAIOpenAI Responses API
Gemini CLI✅ VollständigGeminiNatives Gemini-Format

Konfigurationsbeispiele

Base URL: https://api.lemondata.cc/v1
API Key: sk-your-lemondata-key
Cursor verwendet intern das Tool-Format im Anthropic-Stil. LemonData unterstützt beide:
  • OpenAI-Format: { type: "function", function: { name, parameters } }
  • Anthropic-Format: { name, input_schema } (kein type-Feld)

SDK-Kompatibilität

Verifizierte SDKs

SDKSpracheStatusAnmerkungen
OpenAI SDKPython/JS/Go✅ VollständigAlle Parameter unterstützt
Anthropic SDKPython/JS✅ VollständigExtended Thinking, Tools
Vercel AI SDKTypeScript✅ VollständigstreamText, generateObject
LangChainPython/JS✅ VollständigChatOpenAI, bind_tools
LlamaIndexPython✅ VollständigOpenAI-kompatibel
Dify-✅ VollständigOpenAI-Format

Chat Completions Parameter

Kernparameter

ParameterTypBeschreibung
modelstringModell-Identifikator (erforderlich)
messagesarrayKonversationsnachrichten (erforderlich)
max_tokensintegerMaximale Output-Tokens
temperaturenumberSampling-Temperatur (0-2)
top_pnumberNucleus-Sampling (0-1)
streambooleanStreaming aktivieren

Tool-Aufrufe

{
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get weather for a location",
        "parameters": {
          "type": "object",
          "properties": {
            "location": { "type": "string" }
          }
        },
        "strict": true
      }
    }
  ],
  "tool_choice": "auto",
  "parallel_tool_calls": true
}

Optionen für Tool Choice

FormatBeispielBeschreibung
String"auto", "none", "required"Einfache Auswahl
OpenAI Object{ "type": "function", "function": { "name": "fn" } }Spezifische Funktion erzwingen
Anthropic Object{ "type": "tool", "name": "fn", "disable_parallel_tool_use": true }Natives Anthropic-Format

Erweiterte Parameter

ParameterTypBeschreibung
stream_optionsobject{ include_usage: true } für Token-Zählung
reasoning_effortstring"low", "medium", "high" für o1/o3-Modelle
service_tierstring"auto" oder "default"
seedintegerDeterministische Ausgaben
logprobsbooleanLog-Wahrscheinlichkeiten zurückgeben
top_logprobsintegerAnzahl der Top-Logprobs (0-20)
logit_biasobjectToken-Bias-Map (-100 bis 100)
frequency_penaltynumberWiederholungs-Penalty (-2 bis 2)
presence_penaltynumberThemen-Penalty (-2 bis 2)
stopstring/arrayStop-Sequenzen
nintegerAnzahl der Vervollständigungen (1-128)
userstringBenutzer-Identifikator für Tracking

Erweiterte OpenAI-Funktionen

ParameterTypBeschreibung
modalitiesarray["text", "audio"] für Multimodalität
audioobjectAudio-Output-Konfiguration (Stimme, Format)
predictionobjectVorhergesagter Output für schnellere Vervollständigung
metadataobjectKey-Value-Paare für Tracking
storebooleanFür späteren Abruf speichern

Provider-spezifische Optionen

{
  "anthropic_options": {
    "thinking": {
      "type": "enabled",
      "budget_tokens": 10000
    },
    "prompt_caching": true
  },
  "google_options": {
    "safety_settings": [...],
    "google_search": true,
    "code_execution": true
  }
}

Anthropic Messages Parameter

Kernparameter

ParameterTypBeschreibung
modelstringModell-Identifikator
messagesarrayKonversationsnachrichten
max_tokensintegerMaximaler Output (bis zu 128000)
systemstring/arraySystem-Prompt
streambooleanStreaming aktivieren

Tool-Aufrufe

{
  "tools": [
    {
      "name": "get_weather",
      "description": "Get weather",
      "input_schema": {
        "type": "object",
        "properties": {
          "location": { "type": "string" }
        }
      }
    }
  ],
  "tool_choice": {
    "type": "auto",
    "disable_parallel_tool_use": false
  }
}

Extended Thinking

{
  "model": "claude-opus-4-5",
  "thinking": {
    "type": "enabled",
    "budget_tokens": 10000
  }
}

Responses API Parameter

Kernparameter

ParameterTypBeschreibung
modelstringModell-Identifikator
inputstring/arrayInput-Inhalt
instructionsstringSystem-Anweisungen
max_output_tokensintegerMaximale Output-Tokens
previous_response_idstringKonversation fortsetzen

Erweiterte Parameter

ParameterTypBeschreibung
truncation_strategystring"auto" oder "disabled"
includearray["reasoning.encrypted_content"]
reasoning_effortstringFür Reasoning-Modelle
service_tierstringPrioritätsstufe

Tool-Format

Unterstützt sowohl OpenAI- als auch Anthropic-Tool-Formate:
// OpenAI format
{ "type": "function", "name": "fn", "parameters": {...} }

// Anthropic format (Cursor compatibility)
{ "name": "fn", "input_schema": {...} }

Gemini API Parameter

Kernparameter

ParameterTypBeschreibung
contentsarrayKonversationsinhalt
systemInstructionobjectSystem-Prompt
generationConfigobjectGenerierungseinstellungen

Tools

{
  "tools": [{
    "functionDeclarations": [{
      "name": "search",
      "description": "Search the web",
      "parameters": {...}
    }],
    "codeExecution": {},
    "googleSearch": {}
  }],
  "toolConfig": {
    "functionCallingConfig": {
      "mode": "AUTO"
    }
  }
}

Sicherheitseinstellungen

{
  "safetySettings": [
    {
      "category": "HARM_CATEGORY_HARASSMENT",
      "threshold": "BLOCK_MEDIUM_AND_ABOVE"
    }
  ]
}

Zusätzliche Parameter

ParameterTypBeschreibung
cachedContentstringReferenz auf gecachten Inhalt
responseMimeTypestring"text/plain" oder "application/json"
responseSchemaobjectJSON-Schema für strukturierten Output

Streaming

Alle Endpunkte unterstützen Server-Sent Events (SSE) Streaming:
# Chat Completions
curl https://api.lemondata.cc/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -d '{"model": "gpt-4o", "messages": [...], "stream": true}'

# With usage tracking
-d '{"...", "stream_options": {"include_usage": true}}'

Fehlerbehandlung

LemonData gibt OpenAI-kompatible Fehlermeldungen zurück:
{
  "error": {
    "message": "Invalid API key",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}
Siehe Leitfaden zur Fehlerbehandlung für Details.

Best Practices

Alle Schemata verwenden .passthrough() – unbekannte Parameter werden an die Upstream-Provider weitergeleitet.
Aktivieren Sie stream_options.include_usage für genaue Token-Zählungen in Streaming-Antworten.
Verwenden Sie das von Ihrem SDK erwartete Format. LemonData akzeptiert sowohl OpenAI- als auch Anthropic-Formate.