빠른 시작

1zheai API 키를 생성하고 curl 또는 SDK로 첫 Claude / GPT 호출을 완료한 뒤, 자주 사용하는 클라이언트에 연결하세요.

목표: 5분 이내에 API 키를 받고 첫 Claude 또는 GPT 요청을 완료합니다.

등록 및 충전
1zheai.com/register을 열어 회원가입하세요. 호출할 때마다 잔액에서 차감되므로 먼저 충전해야 합니다. 잔액은 USD(미국 달러)로 표시되며, 위챗페이, 알리페이, Stripe(신용카드), USDT를 지원합니다 — 정확한 결제 수단과 금액 한도는 지갑 주문 페이지 기준입니다. 충전 후 7일 이내에 사용하지 않은 원금을 원래 결제 수단으로 환불 요청할 수 있으며, 이미 사용한 금액과 결제 처리 수수료는 환불되지 않습니다. 자세한 규칙은 충전, 환불 및 인보이스을 참조하세요.
API 키 생성
콘솔로 이동해 왼쪽 사이드바의 “API 키”를 클릭한 뒤, 오른쪽 위의 “API 키 생성”을 클릭하고 이름을 붙여 저장하세요. API 키는 sk-로 시작합니다 — 목록에서 복사 아이콘을 클릭해 복사하고 보관하세요. 자세한 내용은 API 키 발급 및 관리을 참조하세요.
첫 번째 요청 보내기
API 키를 환경 변수에 넣은 다음, curl로 Anthropic 네이티브 엔드포인트를 한 번 호출합니다:
macOS / Linux
Windows PowerShell
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"}] }'
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에 측정한 실제 응답입니다:

1
{
2
  "model": "claude-sonnet-5-5",
3
  "id": "msg_011Cg3G8HQmyTrnqSBX6o6Pw",
4
  "type": "message",
5
  "role": "assistant",
6
  "content": [
7
    {
8
      "type": "text",
9
      "text": "HTTP(超文本传输协议)是一种基于请求-响应模式的应用层协议,用于在客户端(如浏览器)和服务器之间传输网页、图片、API 数据等内容。"
10
    }
11
  ],
12
  "container": null,
13
  "stop_reason": "end_turn",
14
  "stop_sequence": null,
15
  "stop_details": null,
16
  "usage": {
17
    "input_tokens": 530,
18
    "cache_creation_input_tokens": 0,
19
    "cache_read_input_tokens": 0,
20
    "cache_creation": {
21
      "ephemeral_5m_input_tokens": 0,
22
      "ephemeral_1h_input_tokens": 0
23
    },
24
    "output_tokens": 69,
25
    "output_tokens_details": {"thinking_tokens": 0},
26
    "service_tier": "standard",
27
    "inference_geo": "global"
28
  },
29
  "input_transformations": [],
30
  "diagnostics": null,
31
  "context_management": {"applied_edits": []}
32
}

input_tokens은 질문 자체보다 수백 개 더 많습니다 — 이 유형의 클라이언트(curl, SDK, 서드파티 도구)가 모든 요청에 붙이는 시스템 프롬프트이며 입력으로 과금됩니다. Claude Code는 시스템 프롬프트를 붙이지 않으니 시스템 프롬프트 과금을 참조하세요.

그다음 콘솔 왼쪽의 “호출 로그”로 이동하면 이 호출을 확인할 수 있습니다: 시각, 사용한 API 키(“토큰” 열), 모델, 입력 / 출력 토큰, 캐시 읽기/쓰기, 비용.

GPT로 시작할 수도 있습니다

OpenAI SDK를 쓰거나 Codex 연동을 계획한다면 GPT 프로토콜을 바로 선택할 수 있습니다. 먼저 같은 터미널에서 위의 ONEZHE_API_KEY을 설정한 다음 실행합니다:

1
curl --fail-with-body https://1zheai.com/v1/chat/completions \
2
  -H "Authorization: Bearer $ONEZHE_API_KEY" \
3
  -H "Content-Type: application/json" \
4
  -d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"用一句话解释 HTTP。"}]}'

이것은 macOS / Linux 셸 예시입니다. Windows에서는 크로스 플랫폼 Python / Node.js 예시를 바로 실행할 수 있습니다. 텍스트는 choices[0].message.content에 넣습니다. 모델이 목록에 없다면 먼저 사용 가능한 모델 조회을 하세요. Codex는 Responses를 요구합니다 — Codex 구성 튜토리얼을 따라 연동하세요.

다음 단계

자주 쓰는 도구에 연결하세요:

Claude Code

환경 변수 두 개면 충분합니다.

CC Switch

설정 파일을 직접 편집하고 싶지 않다면 이 방법을 쓰세요.

Cursor

사용자 지정 Base URL 작성법과 그 제한 사항.

OpenAI SDK

이미 OpenAI 코드가 있다면 base_url만 바꾸면 됩니다.

요청이 실패하면 먼저 오류 코드 및 문제 해결을 확인하세요. 반환된 필드와 사용량을 검증하려면 모델 및 사용량 검증을 참조하세요.