aisplice

API-Referenz

Chat Completions

POST/v1/chat/completions

Der Standard-Endpunkt: Chat über mehrere Runden, Streaming, Tool-Calling, Vision und JSON-Modus für jedes chatfähige Modell im Katalog.

#Anfrageparameter

  • modelstringerforderlich

    Modell-ID aus /v1/models. Das Gateway ermittelt daraus den Upstream-Anbieter.

  • messagesarrayerforderlich

    Gesprächsrunden: {role: system|user|assistant|tool, content}. Der Inhalt kann ein String oder ein multimodales Array aus Teilen sein.

  • streambooleanoptional

    true streamt SSE-Deltas, abgeschlossen mit data: [DONE].

  • temperaturenumberoptional

    0 bis 2. Leer lassen für den Modellstandard.

  • max_tokensintegeroptional

    Obergrenze für generierte Tokens; begrenzt auch die vorab reservierte Kontingentschätzung.

  • toolsarrayoptional

    Funktionsdeklarationen, die das Modell aufrufen darf — siehe Leitfaden zum Tool-Calling.

  • tool_choicestring | objectoptional

    "auto", "none" oder eine bestimmte Funktion festlegen.

  • response_formatobjectoptional

    {"type":"json_object"} oder ein json_schema-Wrapper für strukturierte Ausgabe bei unterstützten Modellen.

  • top_pnumberoptional

    Nucleus Sampling; verwenden Sie temperature oder top_p, nicht beides.

  • stopstring | arrayoptional

    Bis zu 4 Stoppsequenzen, die die Generierung beenden.

#Zugehörige Fehler

  • 400 invalid_request_errorFehlerhafter Body oder für dieses Modell nicht unterstützter Parameter.
  • 401Ungültiges oder fehlendes Bearer-Token. Auf diesem Pfad gibt es kein error.code — werten Sie den Status aus.
  • 402 insufficient_user_quotaDas Wallet-Guthaben deckt die vorab reservierte Schätzung nicht.
  • 429Drosselung pro Schlüssel. Leerer Body; warten Sie Retry-After ab. Ein 429, das insufficient_user_quota enthält, ist dagegen ein tägliches Ausgabenlimit.
  • 503 model_not_foundUnbekanntes Modell, oder derzeit bedient es kein funktionsfähiger Kanal.

Vollständige Fehlercode-Tabelle →

#Beispielanfrage

curl https://www.aisplice.store/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-luna",
    "messages": [{"role": "user", "content": "Say hello."}]
  }'

#Antwort

response.json
{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "gpt-5.6-luna",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "Hello!"},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 9, "completion_tokens": 3, "total_tokens": 12}
}

Immer noch nicht gelöst?

Senden Sie uns die Anfrage-ID oder die Fehlermeldung, und wir sehen uns das an.