---
title: "빠른 시작"
description: "1zheai API 키를 생성하고 curl 또는 SDK로 첫 Claude / GPT 호출을 완료한 뒤, 자주 사용하는 클라이언트에 연결하세요."
headingIds: {"GPT로 시작할 수도 있습니다":"section-1","다음 단계":"section-2"}
---
목표: 5분 이내에 API 키를 받고 첫 Claude 또는 GPT 요청을 완료합니다.
[1zheai.com/register](https://1zheai.com/register?lng=ko)을 열어 회원가입하세요. 호출할 때마다 잔액에서 차감되므로 먼저 충전해야 합니다. 잔액은 USD(미국 달러)로 표시되며, 위챗페이, 알리페이, Stripe(신용카드), USDT를 지원합니다 — 정확한 결제 수단과 금액 한도는 지갑 주문 페이지 기준입니다. 충전 후 7일 이내에 사용하지 않은 원금을 원래 결제 수단으로 환불 요청할 수 있으며, 이미 사용한 금액과 결제 처리 수수료는 환불되지 않습니다. 자세한 규칙은 [충전, 환불 및 인보이스](/ko/docs/billing/)을 참조하세요.
[콘솔](https://1zheai.com/console?lng=ko)로 이동해 왼쪽 사이드바의 "API 키"를 클릭한 뒤, 오른쪽 위의 "API 키 생성"을 클릭하고 이름을 붙여 저장하세요. API 키는 `sk-`로 시작합니다 — 목록에서 복사 아이콘을 클릭해 복사하고 보관하세요. 자세한 내용은 [API 키 발급 및 관리](/ko/docs/api-keys/)을 참조하세요.
API 키를 환경 변수에 넣은 다음, curl로 Anthropic 네이티브 엔드포인트를 한 번 호출합니다:
```bash title="macOS / Linux"
export ONEZHE_API_KEY="sk-你的Key"
curl https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 128,
"messages": [{"role": "user", "content": "用一句话解释什么是 HTTP"}]
}'
```
```powershell title="Windows PowerShell"
$env:ONEZHE_API_KEY = "sk-你的Key"
$body = @{
model = "claude-sonnet-5-5"
max_tokens = 128
messages = @(@{ role = "user"; content = "用一句话解释什么是 HTTP" })
} | ConvertTo-Json -Depth 5
Invoke-RestMethod -Uri "https://1zheai.com/v1/messages" -Method Post `
-Headers @{ "x-api-key" = $env:ONEZHE_API_KEY; "anthropic-version" = "2023-06-01" } `
-ContentType "application/json; charset=utf-8" `
-Body ([System.Text.Encoding]::UTF8.GetBytes($body))
```
`ONEZHE_API_KEY`은 예시 변수명일 뿐이며, 어떤 이름을 써도 됩니다.
성공하면 공식과 동일한 구조의 HTTP 200을 받습니다. 두 가지를 확인하세요. `model`이 요청한 모델인지, 그리고 `usage`의 토큰 수입니다. 아래는 2026-10-15에 측정한 실제 응답입니다:
```json
{
"model": "claude-sonnet-5-5",
"id": "msg_011Cg3G8HQmyTrnqSBX6o6Pw",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "HTTP(超文本传输协议)是一种基于请求-响应模式的应用层协议,用于在客户端(如浏览器)和服务器之间传输网页、图片、API 数据等内容。"
}
],
"container": null,
"stop_reason": "end_turn",
"stop_sequence": null,
"stop_details": null,
"usage": {
"input_tokens": 530,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0,
"cache_creation": {
"ephemeral_5m_input_tokens": 0,
"ephemeral_1h_input_tokens": 0
},
"output_tokens": 69,
"output_tokens_details": {"thinking_tokens": 0},
"service_tier": "standard",
"inference_geo": "global"
},
"input_transformations": [],
"diagnostics": null,
"context_management": {"applied_edits": []}
}
```
`input_tokens`은 질문 자체보다 수백 개 더 많습니다 — 이 유형의 클라이언트(curl, SDK, 서드파티 도구)가 모든 요청에 붙이는 시스템 프롬프트이며 입력으로 과금됩니다. Claude Code는 시스템 프롬프트를 붙이지 않으니 [시스템 프롬프트 과금](/ko/docs/pricing-explained/#section-3)을 참조하세요.
그다음 콘솔 왼쪽의 "호출 로그"로 이동하면 이 호출을 확인할 수 있습니다: 시각, 사용한 API 키("토큰" 열), 모델, 입력 / 출력 토큰, 캐시 읽기/쓰기, 비용.
## GPT로 시작할 수도 있습니다
OpenAI SDK를 쓰거나 Codex 연동을 계획한다면 GPT 프로토콜을 바로 선택할 수 있습니다. 먼저 같은 터미널에서 위의 `ONEZHE_API_KEY`을 설정한 다음 실행합니다:
```bash
curl --fail-with-body https://1zheai.com/v1/chat/completions \
-H "Authorization: Bearer $ONEZHE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"用一句话解释 HTTP。"}]}'
```
이것은 macOS / Linux 셸 예시입니다. Windows에서는 [크로스 플랫폼 Python / Node.js 예시](/ko/docs/code-examples/)를 바로 실행할 수 있습니다. 텍스트는 `choices[0].message.content`에 넣습니다. 모델이 목록에 없다면 먼저 [사용 가능한 모델 조회](/ko/docs/api-models/)을 하세요. Codex는 Responses를 요구합니다 — [Codex 구성 튜토리얼](/ko/docs/quickstart-codex/)을 따라 연동하세요.
## 다음 단계
자주 쓰는 도구에 연결하세요:
환경 변수 두 개면 충분합니다.
설정 파일을 직접 편집하고 싶지 않다면 이 방법을 쓰세요.
사용자 지정 Base URL 작성법과 그 제한 사항.
이미 OpenAI 코드가 있다면 base_url만 바꾸면 됩니다.
요청이 실패하면 먼저 [오류 코드 및 문제 해결](/ko/docs/troubleshooting/)을 확인하세요. 반환된 필드와 사용량을 검증하려면 [모델 및 사용량 검증](/ko/docs/verify-model/)을 참조하세요.