LIMIT:AI HACKATHON 참가자 안내

1. 한눈에 보기

• 팀마다 HyperCLOVA X 사용 한도 50만원이 주어집니다.
• HyperCLOVA X는 두 가지 방법으로 쓸 수 있고, 둘 다 팀 사용 금액에 집계됩니다.

• 팀 사용 금액은 00:30(1차)과 03:00(2차)에 Credit Board로 공개되고, 08:00 기준 금액으로 크레딧 배율이 정해집니다.

2. 운영진에게 받는 것

두 값 모두 팀 밖으로 공유하지 마세요. 다른 사람이 쓰면 여러분 팀 사용량으로 집계됩니다.

3. 시작하기: CLOVA Studio API Key 등록 (팀당 1회, 대표 1명)

1. NCP 팀 계정으로 콘솔에 로그인 → CLOVA Studio
2. 왼쪽 메뉴 관리 → API 키 → 테스트 탭에서 오른쪽 위 [테스트 API 키 발급]
3. 나온 키(nv-로 시작)를 바로 복사하세요. 발급할 때 한 번만 볼 수 있습니다.
4. /team 화면을 열고 팀 접속 키(tb_로 시작) 입력 → [팀 확인]
5. 복사한 nv- 키를 붙여 넣고 [등록]

코드 ──(Authorization: Bearer tb_…)──▶ Gateway ──(팀의 nv-… 키로 바꿔서)──▶ CLOVA Studio
                                        └─ 사용량(입력·출력 토큰) 기록

4. 코드에서 호출하기

CLOVA Studio 공식 예제에서 주소와 Key, 두 곳만 바꾸면 됩니다. 요청 본문, 응답 형식, 스트리밍은 공식 Chat Completions v3 문서와 같습니다.

사용할 수 있는 API

튜닝, 스킬셋, 라우터, 구모델(HCX-003, HCX-DASH-001)은 막혀 있습니다(403).

curl https://limitai.43.202.27.129.sslip.io/v3/chat-completions/HCX-005 \
  -H "Authorization: Bearer $TEAM_ACCESS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"안녕하세요"}],"maxTokens":256}'

import os, requests

resp = requests.post(
    "https://limitai.43.202.27.129.sslip.io/v3/chat-completions/HCX-005",
    headers={"Authorization": f"Bearer {os.environ['TEAM_ACCESS_KEY']}"},
    json={"messages": [{"role": "user", "content": "안녕하세요"}], "maxTokens": 256},
    timeout=120,
)
print(resp.json()["result"]["message"]["content"])

const res = await fetch('https://limitai.43.202.27.129.sslip.io/v3/chat-completions/HCX-005', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.TEAM_ACCESS_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ messages: [{ role: 'user', content: '안녕하세요' }], maxTokens: 256 }),
});
const data = await res.json();
console.log(data.result.message.content);

import os
from openai import OpenAI

client = OpenAI(base_url="https://limitai.43.202.27.129.sslip.io/v1/openai",
                api_key=os.environ["TEAM_ACCESS_KEY"])
r = client.chat.completions.create(model="HCX-005",
        messages=[{"role": "user", "content": "안녕하세요"}], max_tokens=256)
print(r.choices[0].message.content)

알아 두면 좋은 점

• 스트리밍: 요청 헤더에 Accept: text/event-stream을 넣습니다. 사용량은 마지막 result 이벤트에 들어 있습니다.
• HCX-007 추론: "thinking": {"effort": "none" | "low" | "medium" | "high"}와 maxCompletionTokens를 씁니다. 추론 토큰도 출력 토큰으로 과금되므로, 단순한 작업은 none이나 HCX-005를 쓰세요.
• 도구 호출(function calling): tools를 쓸 때는 max_tokens와 max_completion_tokens를 빼야 합니다. HCX-007은 추론도 꺼야(reasoning_effort: "none") 합니다.

5. Credit Board 공개

• Credit Board는 팀별 HyperCLOVA X 사용 금액을 보여줍니다. 공개 시각에만 운영진이 보여 드립니다.
• 코드 호출분은 실시간으로 집계되고, 플레이그라운드 사용분은 운영진이 30분마다 콘솔에서 읽어 반영합니다.

6. 사용 금액과 점수

• 팀 사용 금액 = Gateway 호출 금액 + 플레이그라운드 사용분 환산 금액
• 팀 사용 금액은 참가자가 직접 조회할 수 없습니다. 00:30과 03:00 Credit Board 공개 때 확인하세요.
• 팀의 토큰 사용량은 NCP 콘솔 → CLOVA Studio → My Product → 사용량에서 모델별로 확인할 수 있습니다. 코드 호출과 플레이그라운드 사용이 합쳐진 값이며, 3~5초 안에 반영됩니다.

모델 단가 (Gateway 호출, 1,000토큰당, VAT 별도)

플레이그라운드 사용분은 이렇게 계산합니다

• 플레이그라운드에서 쓴 사용량은 콘솔에 입력과 출력을 합친 토큰 수로만 나옵니다. 입력 토큰과 출력 토큰을 각각 알 수 있는 방법이 없습니다.
• 그래서 운영진이 항목별 환산 단가를 정했고, 30분마다 이 단가로 계산해 크레딧에 수기로 반영합니다.
• 아래 표의 HCX 모델 "사전 테스트 비율"은 운영진 6명이 4시간 동안 실제 대회와 비슷한 방식으로 사용해 측정한 입력:출력 비율입니다.

• 비율로 정한 단가는 실제와 다를 수 있는 추정치이며, 모든 팀에 같은 기준으로 적용합니다.
• 팀 사용 한도는 50만원이며, 넘으면 Gateway가 호출을 막습니다.

점수 반영 방식

7. 꼭 지킬 것

8. 자주 보는 오류