Accueil / Documentation / API Chat Completions

API Chat Completions

POST /v1/chat/completions — l’endpoint au format OpenAI, pour Cursor, LangChain, LiteLLM et les SDK OpenAI.

L’interface compatible avec OpenAI. Mêmes modèles, mêmes tarifs, enveloppe différente.

EndpointPOST https://aiprimetech.io/v1/chat/completions
URL de base pour les SDKhttps://aiprimetech.io/v1 — notez le /v1
AuthentificationAuthorization: Bearer sk-...

Corps de la requête

ChampTypeObligatoireDescription
modelchaîneouiTout identifiant provenant de /v1/models, y compris les identifiants Claude
messagestableauouiPrend en charge les rôles system, user et assistant
max_tokensentiernonFacultatif ici, contrairement à l’API Messages
temperaturenombrenon0–2 selon la convention OpenAI
streambooléennontrue pour recevoir des fragments SSE
toolstableaunonStructure d’appel de fonctions OpenAI
Contrairement à Messages, system est un rôle ici — placez-le comme première entrée de messages. N’envoyez pas de champ system au niveau racine à cet endpoint.

Exemple

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"}]
  }'

Réponse

{
  "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}
}

Utilisation du SDK OpenAI

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)

Correspondance des champs entre les deux formats

ConceptMessagesChat Completions
Prompt systèmeau niveau racine systemmessages[0] avec le rôle system
Texte de la réponsecontent[0].textchoices[0].message.content
Motif de l’arrêtstop_reasonfinish_reason
Tokens d’entréeusage.input_tokensusage.prompt_tokens
Tokens de sortieusage.output_tokensusage.completion_tokens
Delta du fluxcontent_block_deltachoices[0].delta.content