API を呼び出す

このページでは、認証後に実際に呼び出すパスについて説明します。
OpenAI 互換パスと Anthropic 互換パスの一覧、リクエスト本文で stream を有効にした場合のレスポンスの返り方、
音声・ボイスパスにのみ適用されるルールの順に説明します。
モデル ID とモデルごとに許可されている呼び出しはモデルページに、認証ヘッダーと base URL は API キーで認証するページに記載されています。

進行パス

2 つの互換規格では同じ API キーを使用し、対話型推論モデルはどちらの規格からでも呼び出せます。目的と使用している SDK に応じてパスを選択します。

OpenAI 互換パス

base URL は https://platform.clevi.net/api/v2/aiservice/openai/v1 で、リクエストとレスポンスの本文は OpenAI 規格に準拠します。下表は推論とモデルのパスです。音声・ボイスパスは後のセクションに別途まとめています。

curl https://platform.clevi.net/api/v2/aiservice/openai/v1/chat/completions \
  -H "X-API-Key: sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "cip-5.5-im",
    "messages": [{"role": "user", "content": "안녕하세요"}]
  }'

sk-... にはAPIキー画面で発行したキーを、model にはモデルページのIDを入力します。

その他のパス

Anthropic 互換パス

base URL は https://platform.clevi.net/api/v2/aiservice/anthropic で、Anthropic SDK がパスに /v1 を自動的に付加します。リクエストとレスポンスの本文は Anthropic Messages 仕様に準拠します。

curl https://platform.clevi.net/api/v2/aiservice/anthropic/v1/messages \
  -H "X-API-Key: sk-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "cip-5.5-im",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "안녕하세요"}]
  }'

ストリーミング (SSE)

リクエスト本文に "stream": true を含めると、サーバーは Server-Sent Events で応答します。パスとモデルによって以下のように異なります。

最初のチャンクとともに、以下の3つのヘッダーが返されます。その後はチャンクごとに event: 行（アップストリームがイベント名を指定した場合のみ）と data: 行を送信し、直ちに flush します。

• Content-Type: text/event-stream
• Cache-Control: no-cache
• X-Accel-Buffering: no

Anthropic 互換パスのチャンクは、event 行と data 行が対になります。

event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"안"}}

chat/completions のチャンクは data 行で送られ、最後に data: [DONE] がそのまま転送されます。

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","choices":[...]}

data: [DONE]

音声とボイスのパス

TTS・STT と Cosa ボイス管理パスは OpenAI 互換仕様に対応しており、通常の推論とは異なるルールがいくつかあります。どのモデルがどのパスを許可するかは、モデルページの Cosa 表に記載されています。