ホーム / ドキュメント / Chat Completions API

Chat Completions API

POST /v1/chat/completions — Cursor、LangChain、LiteLLM、OpenAI SDK向けのOpenAI形式のエンドポイント。

OpenAI互換インターフェース。モデルと料金は同じで、データの外側の構造が異なります。

エンドポイントPOST https://aiprimetech.io/v1/chat/completions
SDK用のベースURLhttps://aiprimetech.io/v1 — /v1に注意
認証Authorization: Bearer sk-...

リクエストボディ

項目種類必須説明
model文字列はい次の取得元に含まれる任意のID: /v1/models(ClaudeのIDも含む)
messages配列はいsystem、user、assistantロールに対応
max_tokens整数いいえMessages APIとは異なり、ここでは省略可能
temperature数値いいえOpenAIの規約では0~2
streamブール値いいえSSEチャンクを使用する場合はtrue
tools配列いいえOpenAIの関数呼び出し形式
Messagesとは異なり、 system は ここではロールです。次の配列の先頭要素として配置してください: messages。このエンドポイントには、トップレベルの system フィールドを送信しないでください。

例

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

レスポンス

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

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)

両形式間のフィールド対応

概念MessagesChat Completions
システムプロンプトトップレベル systemmessages[0] systemロールを指定
応答テキストcontent[0].textchoices[0].message.content
停止理由stop_reasonfinish_reason
入力トークンusage.input_tokensusage.prompt_tokens
出力トークン数usage.output_tokensusage.completion_tokens
ストリームの差分content_block_deltachoices[0].delta.content