Source: https://aiprimetech.io/ko/docs/getting-started/quickstart/

[홈](/ko/) / [문서](/ko/docs/) / 빠른 시작 

# 빠른 시작 

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

 페이지 복사 [ Markdown으로 보기](/ko/docs/getting-started/quickstart.md) [ ChatGPT에 질문](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/getting-started/quickstart.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ Claude에서 질문](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/getting-started/quickstart.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

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

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

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

```
Copyexport CLAUDEAPIKEY="sk-your-key-here"
```

## 단계 3 — API 호출 

### Anthropic 형식 

```
Copycurl 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 형식 

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

```
Copycurl 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 — 접근 가능한 모델 확인 

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

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

## 단계 5 — 실제 도구 연결 

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

```
Copyexport ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_AUTH_TOKEN="$CLAUDEAPIKEY"
claude
```

만약 ANTHROPIC_API_KEY 이 셸에 이미 설정되어 있다면 Claude Code가 해당 키에 요금을 청구하고 구독을 알림 없이 무시할 수 있습니다. 전환할 때는 해당 변수의 설정을 해제하세요. 다음을 참조하세요: [Claude Code](/ko/docs/guides/claude-code/). 

## 첫 호출 문제 해결 

 | 증상 | 원인 | 해결 방법

 | 401 | 키가 누락되었거나, 잘못 입력되었거나, 잘못된 헤더로 전송됨 | Anthropic 형식은 다음을 사용합니다: x-api-key; OpenAI 형식은 다음을 사용합니다: Authorization: Bearer

 | 402 | 크레딧이 없고 활성화된 요금제도 없음 | [충전](/ko/topup/) 또는 [요금제 구매](/ko/plans/)

 | 404 적용 대상: /v1/chat/completions | 클라이언트가 OpenAI 본문으로 Anthropic 경로를 호출하거나 그 반대로 호출함 | 형식을 엔드포인트에 맞추세요. 다음을 참조하세요: [개요](/ko/docs/api-reference/overview/)

 | model_not_found | 모델 ID가 다음에서 반환된 값과 정확히 일치하지 않음: /v1/models | 모델 엔드포인트에서 ID를 복사하세요 

[인증헤더 및 환경 변수 참고 자료](/ko/docs/getting-started/authentication/)[Messages API전체 요청 및 응답 스키마](/ko/docs/api-reference/messages/)[오류모든 상태 코드와 의미](/ko/docs/api-reference/errors/) 

[이전소개](/ko/docs/getting-started/introduction/)[다음인증](/ko/docs/getting-started/authentication/)