API 레퍼런스

API 문서

Claude Max를 애플리케이션에 통합하는 데 필요한 모든 것. 완전한 엔드포인트, 6개 언어의 코드 예제, 5개 모델 모두.

인증

기본 URL

프로덕션
https://claudemaxhub.com/api/v1

모든 API 요청은 HTTPS를 사용해야 합니다.

API 키 헤더

헤더
Authorization: Bearer YOUR_API_KEY

API 키는 체험 활성화 후 제공됩니다. 모든 요청에 포함하세요.

속도 제한

분당 60 요청

콘텐츠 유형

application/json

응답 형식

JSON (UTF-8)

API 키 받기

무료 체험 가입 → 계정 활성화 → 대시보드에서 API 키 확인.

사용 가능한 모델

모든 모델 포함 — 사용 사례에 맞는 모델을 선택하세요.

모델 API ID 컨텍스트 윈도우 최적 용도
Claude Opus 5 claude-opus-5 200K 복잡한 추론, 연구, 코딩
Claude Fable 5 claude-fable-5 1M 긴 문서, 대규모 코드베이스
Claude Opus 4 claude-opus-4-8 200K 분석, 상세 보고서
Claude Sonnet 4 claude-sonnet-4 200K 범용, 채팅, 글쓰기
Claude Haiku claude-haiku 200K 빠른 작업, 실시간 응답
GET /api/v1/models 계정에서 사용 가능한 모든 Claude 모델 목록을 반환합니다.
cURL
curl https://claudemaxhub.com/api/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"
Python
import requests

response = requests.get(
    "https://claudemaxhub.com/api/v1/models",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)

models = response.json()
for model in models["data"]:
    print(f"{model['id']}: {model['description']}")
JavaScript
const response = await fetch(
  'https://claudemaxhub.com/api/v1/models',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
    },
  }
);

const { data } = await response.json();
data.forEach(model => console.log(model.id));
200 — Success
{
  "data": [
    {"id": "claude-opus-5",   "description": "가장 강력 — 고급 추론 및 복잡한 분석",   "context_window": 200000},
    {"id": "claude-fable-5",  "description": "플래그십 모델 — 100만 토큰 컨텍스트 윈도우",  "context_window": 1000000},
    {"id": "claude-opus-4-8",   "description": "심층 분석 및 복잡한 다단계 작업",   "context_window": 200000},
    {"id": "claude-sonnet-4", "description": "속도와 품질의 최적 균형", "context_window": 200000},
    {"id": "claude-haiku",    "description": "가장 빠른 응답 — 실시간 애플리케이션에 이상적",    "context_window": 200000}
  ]
}
채팅 생성
POST /api/v1/chat Claude 모델에 메시지를 보내고 응답을 받습니다. 모든 상호작용의 핵심 엔드포인트입니다.
model 필수
string
응답에 사용할 모델.
messages 필수
array
role과 content를 포함하는 메시지 객체 배열.
max_tokens
integer
응답의 최대 토큰 수.
temperature
float
무작위성 제어. 0 = 결정적, 1 = 창의적.
stream
boolean
스트리밍 응답 활성화.
cURL
curl -X POST https://claudemaxhub.com/api/v1/chat \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "messages": [
      {"role": "user", "content": "Explain quantum computing in simple terms."}
    ],
    "max_tokens": 1024,
    "temperature": 0.7
  }'
Python
import requests

response = requests.post(
    "https://claudemaxhub.com/api/v1/chat",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "claude-opus-5",
        "messages": [
            {"role": "user", "content": "Explain quantum computing in simple terms."}
        ],
        "max_tokens": 1024,
        "temperature": 0.7,
    },
)

data = response.json()
print(data["content"][0]["text"])
JavaScript (Node.js / Fetch)
const response = await fetch('https://claudemaxhub.com/api/v1/chat', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'claude-opus-5',
    messages: [
      { role: 'user', content: 'Explain quantum computing in simple terms.' },
    ],
    max_tokens: 1024,
    temperature: 0.7,
  }),
});

const data = await response.json();
console.log(data.content[0].text);
PHP (cURL)
$ch = curl_init('https://claudemaxhub.com/api/v1/chat');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'model'       => 'claude-opus-5',
        'messages'    => [
            ['role' => 'user', 'content' => 'Explain quantum computing in simple terms.'],
        ],
        'max_tokens'  => 1024,
        'temperature' => 0.7,
    ]),
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo $data['content'][0]['text'];
Go
package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
    "io"
)

func main() {
    body, _ := json.Marshal(map[string]interface{}{
        "model": "claude-opus-5",
        "messages": []map[string]string{
            {"role": "user", "content": "Explain quantum computing in simple terms."},
        },
        "max_tokens":  1024,
        "temperature": 0.7,
    })

    req, _ := http.NewRequest("POST",
        "https://claudemaxhub.com/api/v1/chat",
        bytes.NewBuffer(body))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    result, _ := io.ReadAll(resp.Body)
    fmt.Println(string(result))
}
Ruby
require 'net/http'
require 'json'
require 'uri'

uri = URI('https://claudemaxhub.com/api/v1/chat')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = {
  model: 'claude-opus-5',
  messages: [
    { role: 'user', content: 'Explain quantum computing in simple terms.' }
  ],
  max_tokens: 1024,
  temperature: 0.7
}.to_json

response = http.request(request)
data = JSON.parse(response.body)
puts data['content'][0]['text']
200 — 성공 응답
{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "model": "claude-opus-5",
  "content": [
    {
      "type": "text",
      "text": "Quantum computing uses quantum bits (qubits) that can exist in multiple states simultaneously..."
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 15,
    "output_tokens": 128
  }
}
id
string
고유 메시지 식별자
model
string
응답에 사용된 모델
content
array
콘텐츠 블록 배열 (텍스트)
stop_reason
string
모델 중지 이유: end_turn, max_tokens
usage
object
토큰 사용 통계
오류 처리

가능한 모든 오류 응답과 처리 방법.

HTTP 상태 설명 해결방법
401 잘못되거나 누락된 API 키 대시보드에서 API 키를 확인하세요
403 계정 미활성화 또는 체험 기간 만료 계정을 활성화하거나 구독을 갱신하세요
404 잘못된 엔드포인트 또는 모델을 찾을 수 없음 URL과 모델 이름을 확인하세요
422 잘못된 요청 매개변수 요청 본문 형식을 검토하세요
429 속도 제한 초과 기다린 후 재시도하거나 요청 빈도를 줄이세요
500 내부 서버 오류 몇 초 후 재시도하세요

Claude Max로 구축할 준비가 되셨나요?

30일 체험으로 무료 API 키를 받으세요. 5개 모델 모두 포함, 신용카드 청구 없음.