Skip to main content
POST

Authorizations

string
필수
API 키, 인증에 사용됨 (Anthropic SDK 표준 방식)API Key 받기:API Key 관리 페이지에서 API Key를 받으세요
Bearer Token 형식도 지원됩니다:

Body

string
필수
모델 이름
  • claude-haiku-4-5-20251001 — 경량화 및 고속, 고빈도 단순 작업에 적합
  • claude-sonnet-4-5-20250929 — 성능과 비용의 균형, 종합 추천
  • claude-sonnet-4-6 — Sonnet 신버전, 더 강력한 성능
  • claude-opus-4-5-20251101 — 플래그십 추론 모델, 복잡한 분석에 적합
  • claude-opus-4-6 — Opus 신버전, 가장 강력한 능력
전체 모델 목록은 다음을 참조하세요: GET /api/v1/models
array
필수
메시지 목록메시지 배열, 모델은 이 메시지를 바탕으로 다음 응답을 생성합니다. 각 메시지는 rolecontent 두 개의 필드를 포함합니다.빠른 입력 (Try it 영역):
  1. ”+ Add an item”를 클릭하여 메시지를 추가합니다
  2. roleuser (사용자 메시지) 또는 assistant (AI 응답, 다중 대화용)를 입력합니다
  3. content 에 하고 싶은 말을 입력합니다
단일 사용자 메시지 예시:
다중 대화 예시:
사전 채우기된 조수 응답:
integer
필수
최대 출력 토큰 수모델이 최대 생성할 수 있는 토큰 수를 제어하며, 모델은 상한에 도달하기 전에 자연스럽게 종료할 수 있습니다. 최소값: 1.모델마다 다른 컨텍스트 윈도우 상한이 있으니 모델 문서를 참고하세요.
string | array
시스템 프롬프트모델의 역할, 지시문 및 배경 정보를 설정합니다.문자열 형식 (권장):
구조화 형식 (cache_control 지원):
boolean
스트리밍 출력 사용 여부true로 설정하면 SSE(Server-Sent Events)를 통해 실시간 스트리밍으로 응답을 반환합니다. **기본값 true**입니다. 비스트리밍 응답을 원할 경우 명시적으로 "stream": false를 전송해야 합니다.스트리밍 이벤트 순서: pingmessage_startcontent_block_startcontent_block_delta × N → content_block_stopmessage_deltamessage_stop
number
온도 값, 범위 0–1
  • 낮은 값 (예: 0.2): 더 확정적이고 보수적인 출력
  • 높은 값 (예: 0.8): 더 무작위적이고 창의적인 출력
기본값 1.0. top_p와 동시에 사용하지 않는 것이 좋습니다.
number
핵심 샘플링 파라미터, 범위 0–1누적 확률이 top_p에 도달할 때까지의 토큰 집합에서 샘플링합니다. 기본값 1.0. temperature와 동시에 사용하지 않는 것이 좋습니다.
integer
Top-K 샘플링확률이 가장 높은 K개의 토큰 중에서만 샘플링하여 낮은 확률의 롱테일을 필터링합니다. 고급 사용 사례 튜닝에 적합합니다.

Response

string
메시지 고유 식별자예시: "msg_01XFDUDYJgAACzvnptvVoYEL"
string
객체 유형, 고정값 "message"
string
역할, 고정값 "assistant"
array
콘텐츠 블록 배열텍스트 콘텐츠:
콘텐츠 유형: text (텍스트)
string
실제 요청을 처리하는 모델 이름
string
중단 사유
  • end_turn — 자연 종료
  • max_tokensmax_tokens 제한 도달
  • stop_sequence — 사용자 지정 중단 시퀀스 발동
string | null
중단 시퀀스에 의해 중단된 경우 트리거된 시퀀스 내용 반환; 그렇지 않으면 null
object
토큰 사용 통계

사용 예제

기본 대화

시스템 프롬프트 + 다중 대화

스트리밍 응답

시각적 이해

스트리밍 응답 이벤트 형식

주의사항

  1. 인증 방식: x-api-key 요청 헤더 또는 Authorization: Bearer 두 가지 방식을 지원하며, Anthropic 공식 SDK는 기본적으로 전자를 사용합니다.
  2. 포인트 부족: 잔액이 부족할 경우 HTTP 402를 반환하므로, 충전 후 다시 시도해 주세요.
  3. 스트리밍 연결 끊김 재접속: 클라이언트는 SSE 재접속 메커니즘을 구현해야 하며, 연결이 끊길 경우 이미 수신한 내용을 기반으로 재요청 여부를 판단합니다.
  4. 모델 선택 권장 사항:
    • Haiku — 고빈도 간단 질문 응답, 비용 최저
    • Sonnet — 코드 생성, 문서 처리, 종합 추천
    • Opus — 복잡한 추론, 장문 분석, 최고 성능