API 호출하기

이 페이지는 인증을 마친 뒤 실제로 부르는 경로를 다룹니다.
OpenAI 호환 경로와 Anthropic 호환 경로의 목록, 요청 본문에 stream 을 켰을 때 응답이 오는 방식,
음성·보이스 경로에만 적용되는 규칙 순서입니다.
모델 ID 와 모델별 허용된 호출은 모델 페이지에, 인증 헤더와 base URL 은 API 키로 인증하기 페이지에 있습니다.

진행 경로

두 호환 규격은 같은 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 로 응답합니다. 경로와 모델에 따라 아래처럼 다릅니다.

첫 청크와 함께 아래 세 헤더가 내려갑니다. 이후에는 청크마다 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 표에 있습니다.