빠른 시작
키를 발급받고 환경 변수 두 개를 설정한 다음 약 일 분 만에 첫 요청을 보내세요.
이 페이지에서는 처음부터 정상적인 응답을 받기까지의 과정을 안내합니다. 필요한 것은 다음뿐입니다: curl; SDK 버전은 다음에 나와 있습니다: SDK.
단계 1 — 키 생성
- 계정을 등록 하고 이메일을 인증하세요.
- 크레딧 충전 또는 무제한 요금제 구매. 신규 계정은 첫 암호화폐 충전 시 보너스를 받습니다. 다음을 참조하세요: 요금.
- 대시보드를 열고 다음으로 이동하세요: API 키. 그런 다음 키를 생성하세요. 키는 다음으로 시작합니다:
sk-. - 즉시 복사하세요. 전체 값은 한 번만 표시됩니다.
단계 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를 복사하세요 |