← 모든 글

Claude API: 키, /v1/messages 엔드포인트 및 모델 버전 선택

15.10.2026

Claude API는 채팅 창 대신 자신의 코드에서 Claude 모델을 호출하는 방법입니다. 사이트의 지원 봇, 티켓 분류 스크립트, 편집기의 코드 완성, CRM 통합 등이 있습니다. NeuralSpace에서는 약 1분 안에 대시보드에 키가 생성되고 요청은 Anthropic 호환 POST /v1/messages 구독 없이 토큰 잔액으로 비용을 지불합니다. 다음은 키를 얻는 방법, 첫 번째 통화의 모양, 모델 버전(Haiku, Sonnet, Opus 또는 Fable)을 선택하는 방법에 대한 단계별 가이드입니다.

Claude API는 무엇이며 채팅과 어떻게 다른가요?

Claude는 Anthropic의 언어 모델 제품군입니다. 채팅 창에서는 모델과 직접 대화할 수 있습니다. API를 통해 코드는 동일한 작업을 수행합니다. 즉, 일련의 메시지를 보내고, 생성된 답변을 얻고, 이를 제품에서 사용합니다. 즉, 사용자에게 보여주고, 저장하고, 추가로 처리합니다. 일반적인 사용 사례: 봇 지원, 이메일 및 문서 요약, 구조화된 데이터 추출, 콘텐츠 초안 작성, 스크립트에서 일상적인 작업 자동화. 채팅과의 주요 차이점은 예측 가능성입니다. 시스템 지침, 응답 제한 및 모델 버전을 직접 설정하고 지출을 토큰으로 볼 수 있습니다.

1단계. 키 받기

이메일로 NeuralSpace에 가입하세요. 1분도 채 걸리지 않습니다. 신규 사용자는 충전 없이 첫 번째 요청에 충분한 스타터 토큰을 받습니다.
열기 API 키 페이지 대시보드에서 키 이름(예: "My bot")을 입력하고 만들기를 클릭합니다.
열쇠는 다음과 같습니다 nsk-… 한 번만 표시됩니다. 저장소 코드가 아닌 비밀번호 관리자나 환경 변수에 바로 복사하세요.
잔액을 확인하세요. 텍스트 모델에는 계정에 최소 50개의 토큰이 필요합니다. 구독료 없이 대시보드에서 충전이 이루어집니다.

NeuralSpace API 키 페이지: 생성 키 및 Claude 빠른 시작

2단계. /v1/messages에 대한 첫 번째 호출

Claude 텍스트 모델은 Anthropic 호환에 적용됩니다. POST https://neuralspace.pro/v1/messages 끝점. 몸은 모델을 운반합니다. messages 배열하다 user/assistant 역할, 응답 제한 max_tokens (1 ~ 32000) 및 선택 사항 system 지침. 최소한의 컬 요청:

curl https://neuralspace.pro/v1/messages \
  -H "x-api-key: nsk-your_key" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "system": "You answer technical questions briefly.",
    "messages": [{"role": "user", "content": "How is streaming different from a regular response?"}]
  }'

응답은 Anthropic 형식으로 돌아옵니다. 텍스트는 다음과 같습니다. content[0].text 실제 지출은 usage 필드. 다음으로 인증하세요. x-api-key: nsk-… 헤더; Bearer만 사용하는 클라이언트는 사용할 수 있습니다. Authorization: Bearer nsk-… 대신에.

3단계. Anthropic SDK 연결

공식 Anthropic SDK에 이미 코드가 있는 경우 정확히 두 가지 값을 변경합니다. base_url 그리고 열쇠:

from anthropic import Anthropic

client = Anthropic(
    base_url="https://neuralspace.pro",
    api_key="nsk-your_key",
)

resp = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    system="You answer technical questions briefly.",
    messages=[{"role": "user", "content": "Suggest three names for a channel about AI"}],
)
print(resp.content[0].text)

채팅 인터페이스의 경우 스트리밍이 도움이 됩니다. 추가 "stream": true 답변은 서버에서 보낸 이벤트를 통해 덩어리로 도착하므로 사용자는 생성이 완료되기 전에 첫 번째 단어를 볼 수 있습니다.

선택할 모델 버전

공개 NeuralSpace 카탈로그에는 네 가지 Claude 버전이 있으며, 이들 간의 차이점은 추론의 깊이에 대한 속도와 가격의 균형입니다. 아래 가격은 API 토큰 백만 개당 사이트 토큰 단위이며, 입력 및 출력이 별도로 청구됩니다(작성 당시 요금은 유동적임).

클로드 하이쿠 4.5 (claude-haiku-4-5) — 41 / 213. 가장 빠르고 저렴합니다: 분류, 짧은 답변, 대량 텍스트 처리, 대략적인 라벨링.
클로드 소네트 5 (claude-sonnet-5) — 152.5 / 767. 주력: 코드, 긴 지침, 컨텍스트 중심 대화. 합리적인 기본값입니다.
클로드 오푸스 5 (claude-opus-5) — 359 / 1794.5. 어려운 작업: 다단계 추론, 대규모 문서 분석, 미묘한 논리.
클로드 우화 5 (claude-fable-5) — 718 / 3589.5. 가격보다 품질이 더 중요한 가장 까다로운 시나리오를 위한 주력 제품입니다.

실용적인 규칙: Haiku 또는 Sonnet으로 시작하고 Opus 및 Fable로 선택적으로 전환하십시오. 처음 두 가지가 실제로 부족한 경우에만 선택하십시오. 버전은 단일로 설정됩니다. model 필드를 요청에 포함하므로 동일한 프롬프트에서 비교할 수 있습니다.

스트리밍, 한도 및 서비스 엔드포인트

두 가지 제한으로 인해 사람들이 일찍 작업을 시작하지 못하게 됩니다. 즉, 키당 분당 60개의 요청과 텍스트 모델의 경우 최소 잔액 50개 토큰입니다. 현재 잔액은 다음에서 가져옵니다. GET /v1/balance및 실시간 가격이 포함된 기계 판독 가능한 모델 목록 GET /v1/models. 둘 다 열쇠가 필요합니다. 현재 요율은 항상 표에 표시됩니다. API 문서 페이지.

Claude API 및 MCP: Claude Code에 연결

동일한 키가 NeuralSpace를 AI 에이전트에 MCP 서버로 연결합니다. 에이전트 자체는 계정을 대신하여 채팅, 이미지, 비디오 및 음악 생성을 호출합니다. Claude Code의 경우 하나의 명령입니다.

claude mcp add --transport http neuralspace https://neuralspace.pro/mcp \
  --header "Authorization: Bearer nsk-your_key"

아직 API가 필요하지 않은 경우 인터페이스에서 동일한 모델을 사용할 수 있습니다. 채팅 클로드를 선택해 코드 없이 대화할 수 있으며, 채팅과 API 간에 균형이 공유됩니다.

FAQ

Anthropic 계정이나 외국 카드가 필요합니까?

아니요. 키는 NeuralSpace 대시보드에서 발급되며 계정 토큰으로 지불합니다. 구독이나 클라우드 청구 설정이 필요하지 않습니다.

/v1/messages는 /v1/chat/completions와 어떻게 다른가요?

이는 동일한 API의 두 가지 형식입니다. /v1/messages Anthropic Messages API를 반영합니다(필드 model, messages, system, max_tokens) Claude 모델과 Anthropic SDK에 적합합니다. /v1/chat/completions GPT 및 Grok 채팅 모델을 위한 OpenAI 형식입니다. 주소와 본체 구조만 변경됩니다.

Claude API 호출 비용은 얼마입니까?

실제로 사용하는 토큰에 대해서만: 작성 당시 Claude Sonnet 5는 백만 입력당 152.5개 토큰, 백만 출력당 767개입니다. 2,000개의 토큰을 요청하는 데 드는 비용은 대략 $0.01입니다. 현재 가격은 GET /v1/models 그리고 문서 테이블에 있습니다.

무료 등급이 있나요?

플랫폼에는 자유로운 세대가 없습니다. 신규 사용자는 첫 번째 실행에 충분한 시작 토큰을 얻습니다. 그 후에는 구독료 없이 토큰당 비용을 지불합니다.

API 페이지로 이동 →