Quickstart

첫 API 호출

가격과 플랜을 확인한 뒤 대시보드에서 API 키를 만들고 OpenAI 호환 endpoint로 요청합니다.

curl https://YOUR_SHOVEL_AI_HOST/v1/chat/completions \
  -H 'Authorization: Bearer kr_live_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "shovel/gemini-3-1-flash-lite",
    "messages": [{"role": "user", "content": "안녕. 한 문장으로 답해줘."}]
  }'

스트리밍 응답

OpenAI 호환 클라이언트에서 `stream: true`를 보내면 `text/event-stream` 응답으로 받을 수 있습니다. 운영 연결에서는 모델 제공자의 SSE 청크를 그대로 전달하고, 연결 준비 모드에서는 완료된 응답을 SSE 형식으로 변환합니다. 마지막 이벤트는 `data: [DONE]`입니다.

curl -N https://YOUR_SHOVEL_AI_HOST/v1/chat/completions \
  -H 'Authorization: Bearer kr_live_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "shovel/gemini-3-1-flash-lite",
    "stream": true,
    "messages": [{"role": "user", "content": "짧게 요약해줘."}]
  }'

data: {"object":"chat.completion.chunk", ...}

data: [DONE]

크레딧 사용량, 요청 ID, 키별 사용량은 일반 응답과 동일하게 완료된 요청 기준으로 기록됩니다.

순서

1. `/pricing`에서 플랜과 환불 기준을 확인합니다.

2. `/playground`에서 가입 시 지급된 10,000 테스트 크레딧으로 호출 결과와 사용액을 먼저 확인합니다.

3. 로그인된 대시보드의 `/dashboard/keys`에서 운영 API 키를 만듭니다.

4. 키 값은 생성 직후 한 번만 전체 표시됩니다.

5. 응답 header, 요청 ID, 대시보드에서 사용량과 차감 크레딧을 확인합니다.

curl https://YOUR_SHOVEL_AI_HOST/v1/key \
  -H 'Authorization: Bearer kr_live_xxx'

curl https://YOUR_SHOVEL_AI_HOST/v1/credits \
  -H 'Authorization: Bearer kr_live_xxx'

curl 'https://YOUR_SHOVEL_AI_HOST/v1/generation?id=req_xxx' \
  -H 'Authorization: Bearer kr_live_xxx'

curl https://YOUR_SHOVEL_AI_HOST/api/account/credits
curl https://YOUR_SHOVEL_AI_HOST/api/account/usage?limit=25