Startseite / Dokumentation / Chat Completions API

Chat Completions API

POST /v1/chat/completions — der Endpunkt im OpenAI-Format für Cursor, LangChain, LiteLLM und die OpenAI SDKs.

Die OpenAI-kompatible Schnittstelle. Dieselben Modelle, dieselben Preise, eine andere Nachrichtenstruktur.

EndpunktPOST https://aiprimetech.io/v1/chat/completions
Basis-URL für SDKshttps://aiprimetech.io/v1 — beachten Sie /v1
AuthentifizierungAuthorization: Bearer sk-...

Anfragekörper

FeldTypErforderlichBeschreibung
modelZeichenfolgejaBeliebige ID aus /v1/models, einschließlich Claude-IDs
messagesArrayjaUnterstützt die Rollen system, user und assistant
max_tokensGanzzahlneinHier optional, anders als bei der Messages API
temperatureZahlnein0–2 gemäß der OpenAI-Konvention
streamBoolescher Wertneintrue für SSE-Chunks
toolsArrayneinOpenAI-Struktur für Funktionsaufrufe
Anders als bei Messages system ist hier eine Rolle — setzen Sie sie als ersten Eintrag in messages. Senden Sie kein system Feld auf oberster Ebene an diesen Endpunkt.

Beispiel

curl https://aiprimetech.io/v1/chat/completions \
  -H "Authorization: Bearer $CLAUDEAPIKEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Antwort

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "claude-sonnet-4-6",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "..."},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 9, "completion_tokens": 12, "total_tokens": 21}
}

Verwendung des OpenAI SDK

from openai import OpenAI

client = OpenAI(
    api_key=class="s">"sk-your-key",
    base_url=class="s">"https://aiprimetech.io/v1",   class=class="s">"c"># the /v1 matters
)

resp = client.chat.completions.create(
    model=class="s">"claude-sonnet-4-6",
    messages=[{class="s">"role": class="s">"user", class="s">"content": class="s">"Hello"}],
)
print(resp.choices[0].message.content)

Feldzuordnung zwischen den beiden Formaten

KonzeptMessagesChat Completions
Systempromptauf oberster Ebene systemmessages[0] mit der Rolle system
Antworttextcontent[0].textchoices[0].message.content
Grund für den Abschlussstop_reasonfinish_reason
Eingabetokensusage.input_tokensusage.prompt_tokens
Ausgabe-Tokenusage.output_tokensusage.completion_tokens
Streaming-Deltacontent_block_deltachoices[0].delta.content