홈 / 문서 / 빠른 시작

빠른 시작

키를 발급받고 환경 변수 두 개를 설정한 다음 약 일 분 만에 첫 요청을 보내세요.

이 페이지에서는 처음부터 정상적인 응답을 받기까지의 과정을 안내합니다. 필요한 것은 다음뿐입니다: curl; SDK 버전은 다음에 나와 있습니다: SDK.

단계 1 — 키 생성

  1. 계정을 등록 하고 이메일을 인증하세요.
  2. 크레딧 충전 또는 무제한 요금제 구매. 신규 계정은 첫 암호화폐 충전 시 보너스를 받습니다. 다음을 참조하세요: 요금.
  3. 대시보드를 열고 다음으로 이동하세요: API 키. 그런 다음 키를 생성하세요. 키는 다음으로 시작합니다: sk-.
  4. 즉시 복사하세요. 전체 값은 한 번만 표시됩니다.

단계 2 — 환경 변수로 내보내기

export CLAUDEAPIKEY="sk-your-key-here"

단계 3 — API 호출

Anthropic 형식

curl https://aiprimetech.io/v1/messages \
  -H "x-api-key: $CLAUDEAPIKEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

OpenAI 형식

모델은 동일하지만 메시지 구조가 다릅니다. 클라이언트에 맞는 형식을 선택하세요:

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

단계 4 — 접근 가능한 모델 확인

curl https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $CLAUDEAPIKEY"

그러면 해당 키로 호출할 수 있는 모든 모델 ID가 반환됩니다. 다음에 해당 ID를 그대로 사용하세요: model 필드를 사용합니다.

단계 5 — 실제 도구 연결

Claude Code는 변수 두 개만 설정하면 됩니다:

export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_AUTH_TOKEN="$CLAUDEAPIKEY"
claude
만약 ANTHROPIC_API_KEY 이 셸에 이미 설정되어 있다면 Claude Code가 해당 키에 요금을 청구하고 구독을 알림 없이 무시할 수 있습니다. 전환할 때는 해당 변수의 설정을 해제하세요. 다음을 참조하세요: Claude Code.

첫 호출 문제 해결

증상원인해결 방법
401키가 누락되었거나, 잘못 입력되었거나, 잘못된 헤더로 전송됨Anthropic 형식은 다음을 사용합니다: x-api-key; OpenAI 형식은 다음을 사용합니다: Authorization: Bearer
402크레딧이 없고 활성화된 요금제도 없음충전 또는 요금제 구매
404 적용 대상: /v1/chat/completions클라이언트가 OpenAI 본문으로 Anthropic 경로를 호출하거나 그 반대로 호출함형식을 엔드포인트에 맞추세요. 다음을 참조하세요: 개요
model_not_found모델 ID가 다음에서 반환된 값과 정확히 일치하지 않음: /v1/models모델 엔드포인트에서 ID를 복사하세요