Claude Haiku 5.5 API
Claude Haiku 5.5 API의 적응형·비활성 사고 모드, 강제 도구 호출, 매개변수, 스트리밍과 그룹별 토큰 요금을 안내합니다.
이 참조 문서는 Claude Haiku 5.5의 Messages 매개변수를 설명합니다. POST https://api.wanapi.app/v1/messages에 claude-haiku-5-5를 사용하세요. Claude 모델 비교.
모델 설정
| 설정 | Claude Haiku 5.5 |
|---|---|
| 모델 ID | claude-haiku-5-5 |
| 최대 동기 출력 | 사고 토큰을 포함하여 128000개 |
| 사고 모드 | 적응형 또는 비활성화 |
| 기본 사고 노력 | medium |
강제 도구 호출(any / tool) | 지원 |
연결 및 요청 전송
API 키 설정에서 키를 생성하세요. 하나의 API 키로 모든 모델과 그룹을 이용할 수 있습니다. 서버 환경의 WAN_API_KEY에 키를 보관하세요. anthropic-version: 2023-06-01을 전송하고, 필요한 기능에만 anthropic-beta를 추가하세요.
curl https://api.wanapi.app/v1/messages \
-H "x-api-key: $WAN_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-haiku-5-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Explain the purpose of a database index in three sentences."}]
}'import os
import anthropic
client = anthropic.Anthropic(
api_key=os.environ["WAN_API_KEY"],
base_url="https://api.wanapi.app",
)
message = client.messages.create(
model="claude-haiku-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Explain the purpose of a database index in three sentences."}],
)
print("".join(block.text for block in message.content if block.type == "text"))현재 API 지원 범위
아래 표는 이 모델의 네이티브 API 규격을 설명합니다. Wan API는 현재 호환 계층을 통해 요청을 전달합니다. max_tokens에는 양수를 사용하세요. 현재 게이트웨이는 0을 생성용 토큰 예산으로 바꾸므로, 여기에서는 캐시만 미리 채우는 용도로 사용할 수 없습니다.
현재 게이트웨이는 diagnostics, compaction, fallbacks, fallback_credit_token, thread를 전달하지 않습니다. 현재 채널 설정에서는 speed, service_tier, inference_geo도 걸러집니다. 아래에 이 필드들을 기재한 것은 모델의 규격을 설명하기 위한 것이며, 현재 연결에서는 아직 사용할 수 없습니다. 응답이 성공했다고 해서 무시된 필드가 적용되었다는 뜻은 아닙니다. 이 필드들이 필요한 베타 기능에도 같은 제한이 적용됩니다.
매개변수
| 필드 | 필수 | 규격 |
|---|---|---|
model | 예 | claude-haiku-5-5. |
max_tokens | 예 | 사고 토큰을 포함하여 정수 0–128000. API 기본값은 없습니다. |
messages | 예 | 역할과 문자열 또는 콘텐츠 블록 배열을 가진 메시지 1–100000개. 아래 대화 규칙을 참고하세요. |
system | 아니요 | 문자열 또는 텍스트 블록 배열. null은 허용하지 않습니다. |
thinking | 아니요 | 기본값은 적응형이며 비활성화도 가능합니다. 수동 예산과 도구 간 사고 모드는 지원하지 않습니다. |
output_config | 아니요 | effort, format과 선택적 베타 task_budget을 포함한 객체. |
stop_sequences | 아니요 | 생성을 중단할 문자열의 배열. |
stream | 아니요 | 불리언. 기본값은 false입니다. |
temperature | 아니요 | 생략하세요. 이 연결에서는 제거됩니다. 공식 호환 값은 1입니다. |
top_p | 아니요 | 생략하세요. 이 연결에서는 제거됩니다. 공식 호환 값은 0.99입니다. |
top_k | 아니요 | 지원하지 않으며 제거됩니다. |
tools | 아니요 | 클라이언트 도구 또는 공식 서버 도구 선언의 배열. |
tool_choice | 아니요 | auto, none, any 또는 이름을 지정한 tool. 강제 도구 호출을 지원합니다. |
metadata | 아니요 | 객체. 선택적 user_id는 최대 512자의 문자열 또는 null입니다. |
cache_control | 아니요 | null 또는 {"type":"ephemeral","ttl":"5m"}. TTL은 1h도 허용하며 기본값은 5m입니다. |
container | 아니요 | null, 컨테이너 ID 문자열 또는 선택적 ID와 최대 20개의 스킬을 포함한 객체. |
context_management | 아니요 | null 또는 공식 컨텍스트 편집을 포함한 객체. 베타 헤더가 필요합니다. |
mcp_servers | 아니요 | 최대 20개의 URL 서버 배열. 해당 MCP 베타 헤더가 필요합니다. |
service_tier | 아니요 | auto 또는 standard_only. Haiku에는 Priority Tier 처리 용량이 없습니다. |
inference_geo | 아니요 | global, us 또는 null. 생략하면 계정 기본값을 사용합니다. 처리 지역을 판단하기 전에 보고된 사용량을 확인하세요. |
diagnostics | 아니요 | null 또는 객체. previous_message_id는 null 또는 최대 256자의 문자열입니다. |
compaction | 아니요 | null 또는 {"type":"summarize","instructions":"..."}. instructions는 선택 사항으로 null을 허용하며 최대 16384자입니다. |
fallbacks | 아니요 | null 또는 해당 베타를 사용하는 default. Haiku에는 자동 대체 모델이 없으며 명시적 목록은 유효하지 않습니다. |
fallback_credit_token | 아니요 | null, 토큰 문자열 또는 {token,mode}. API가 자격과 유효성을 확인해야 하므로 특정 모델이 적격 대상이라고 가정하지 마세요. |
speed | 아니요 | standard 또는 null. Fast 모드는 지원하지 않습니다. |
사고 모드와 도구
기본값은 medium 노력 수준의 적응형 사고이며 사고 텍스트는 생략됩니다. 노력 수준은 low, medium, high, xhigh, max를 허용하며, null이면 기본값을 사용합니다.
{
"thinking": {"type": "adaptive", "display": "summarized"},
"output_config": {"effort": "medium"}
}사고를 비활성화하려면 {"type":"disabled"}와 low, medium 또는 high 노력 수준을 사용하세요. 비활성 모드에는 display나 block_binding을 넣지 마세요. enabled, budget_tokens, between_tools와 xhigh/max 노력 수준에서의 사고 비활성화는 유효하지 않습니다.
적응형 모드의 display는 omitted, summarized 또는 null을 허용합니다. 공통 베타 값인 updates에는 thinking-display-updates-2026-08-18이 필요합니다. Anthropic은 현재 Haiku에서 사람이 읽을 수 있는 진행 상황 업데이트를 보장하지 않으므로, 해당 출력에 의존하지 마세요.
선택적 thinking.block_binding에는 thinking-binding-controls-2026-08-01이 필요합니다. 값은 null 또는 prefix_mismatch_behavior가 error, drop_block, null 중 하나인 객체입니다. 대화 기록을 다시 보낼 때는 이전 턴과 전체 사고 블록을 그대로 유지하세요. 사고 서명은 이를 생성한 계정 또는 해당 계정과 연결된 계정에 귀속됩니다.
output_config.task_budget은 null 또는 { "type": "tokens", "total": 20000 }이며, 선택적 remaining은 정수 또는 null입니다. task-budgets-2026-03-13이 필요하며 total은 최소 20000이어야 합니다. 여기서는 remaining에 추가 범위 제한을 두지 않습니다.
도구와 구조화된 출력
클라이언트 도구에는 영문자, 숫자, 밑줄 또는 하이픈으로 된 1–128자의 이름과 type: "object"인 input_schema가 필요합니다. 선언한 도구의 호출을 강제하려면 tool_choice: {"type":"any"} 또는 {"type":"tool","name":"lookup"}를 사용하세요. 적응형 사고에서 강제 도구 응답은 사고 블록 없이 도구 호출부터 시작합니다.
disable_parallel_tool_use는 auto, any, tool 선택에서 사용하는 선택적 불리언이며 none의 필드는 아닙니다. 원래 tool_use_id와 함께 도구 결과를 돌려보내세요. 클라이언트 도구는 사용자 애플리케이션이 실행합니다.
{
"tools": [{
"name": "lookup",
"description": "Look up a product by SKU.",
"input_schema": {
"type": "object",
"properties": {"sku": {"type": "string"}},
"required": ["sku"],
"additionalProperties": false
}
}],
"tool_choice": {"type": "tool", "name": "lookup"}
}구조화된 응답은 output_config.format: {"type":"json_schema","schema":{...}}를 사용합니다. 객체의 additionalProperties: false를 포함하여 Anthropic이 지원하는 JSON Schema 하위 집합을 따르세요. 형식이 유효해도 값의 사실적 정확성을 보장하지는 않습니다. 엄격한 도구와 구조화된 출력에는 스키마 전체에 적용되는 제한이 있습니다. 공식 구조화된 출력 참조 문서를 확인하세요.
컴퓨터 사용에는 computer_toolset_20260801이 필요하며, 이전 컴퓨터 도구 버전은 유효하지 않습니다. 브라우저 사용에는 별도의 browser_toolset_20260801이 있습니다. 도구 선언만으로 전체 서버 도구 세션이 작동하는지 확인할 수는 없습니다. 사용 전에 해당 도구의 공식 가이드와 베타 요건을 확인하세요.
미디어 입력
이미지와 PDF는 사용자 메시지의 content 블록에 공개적으로 접근 가능한 HTTP(S) URL로 지정하세요. 파일은 직접 호스팅해야 합니다. 이 연동은 Files API나 업로드 기능을 제공하지 않습니다. 이미지 입력 예시는 다음과 같습니다.
{"role":"user","content":[
{"type":"image","source":{"type":"url","url":"https://example.com/chart.png"}},
{"type":"text","text":"What does this chart show?"}
]}PDF에는 document 블록을 사용하세요. 대화를 이어갈 때는 도구 사용 ID, 전체 사고 블록과 서명을 그대로 유지하세요. 클라이언트 도구를 실행하고 결과를 반환하는 주체는 사용자 애플리케이션입니다. 도구를 선언하는 것만으로 실행되지는 않습니다.
요금
토큰 100만 개당 USD
현재 요금에는 각 그룹의 배율이 반영되어 있습니다. 요금은 최대 2분 동안 캐시됩니다.
하나의 API 키로 모든 모델과 그룹을 이용할 수 있습니다. 기본 표시는 자동 라우팅 순서에서 가장 먼저 이용 가능한 그룹을 뜻하며, 실제로 선택된 그룹의 요금이 적용됩니다.
Claude Haiku 5.5
claude-haiku-5-5
| 과금 대상 토큰 | claude · 기본 | |
|---|---|---|
| 입력 토큰 ≤ 100,000 | 입력 토큰 > 100,000 | |
| 입력(캐시되지 않음) | US$0.05 | US$0.25 |
| 출력 | US$0.25 | US$1.25 |
| 캐시 읽기 | US$0.005 | US$0.025 |
| 캐시 쓰기 · 5분 | US$0.0625 | US$0.3125 |
| 캐시 쓰기 · 1시간 | US$0.1 | US$0.5 |
구간 기준: 캐시되지 않은 입력 토큰 수. 선택된 구간은 기준을 초과한 토큰만이 아닌 요청 전체에 적용됩니다.
—는 확인된 요금이 없다는 뜻이며, 무료를 의미하지 않습니다.
캐시 요금은 응답에 해당 캐시 사용량이 보고된 경우에만 적용됩니다. 캐시된 토큰을 캐시되지 않은 입력으로 다시 계산하지 마세요.
각 과금 대상 토큰 수에 해당 단가를 곱하고, 합계를 1,000,000으로 나누세요. 사고 토큰은 출력 토큰에 포함되며 별도로 중복 과금되지 않습니다. 캐시 읽기, 5분 쓰기, 1시간 쓰기에는 각각 별도의 단가가 적용됩니다. 길이에 따른 요금은 먼저 해당 구간을 선택한 뒤 요청 비용을 계산하세요.
응답과 스트리밍
완료된 메시지에는 id, type, role, model, content, stop_reason, usage가 포함됩니다. content에서 텍스트 블록을 읽으세요. 첫 번째 블록은 텍스트가 아닌 사고 또는 도구 호출일 수 있습니다. 아래 응답은 예시입니다.
{
"id": "msg_example",
"type": "message",
"role": "assistant",
"model": "claude-haiku-5-5",
"content": [{"type": "text", "text": "A database index helps locate rows without scanning the whole table."}],
"stop_reason": "end_turn",
"usage": {"input_tokens": 24, "output_tokens": 18}
}SSE를 받으려면 stream: true를 설정하고 curl -N을 사용하세요. message_start, content_block_start, content_block_delta, content_block_stop, message_delta, message_stop 외에 ping과 스트림 오류도 처리해야 합니다. 각 청크를 완성된 응답으로 취급하지 말고 최종 사용량을 읽으세요.
OpenAI 호환 형식
동일한 모델 ID를 POST /v1/chat/completions와 POST /v1/responses에서도 사용할 수 있습니다. Authorization: Bearer YOUR_API_KEY와 OpenAI SDK 기본 URL https://api.wanapi.app/v1을 사용하세요. Chat Completions는 messages를, Responses는 input을 사용합니다. 이들 필드는 Messages 형식으로 변환되므로, 위에 설명한 네이티브 매개변수는 /v1/messages를 사용하세요.
curl https://api.wanapi.app/v1/chat/completions \
-H "Authorization: Bearer $WAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"claude-haiku-5-5","max_tokens":256,"messages":[{"role":"user","content":"Reply with OK."}]}'사용 로그와 오류
LLM 로그에서 최근 7일 동안 완료된 호출의 모델, 입력 토큰, 출력 토큰과 비용을 확인할 수 있습니다. 호출 후 새로고침하고 claude-haiku-5-5로 필터링하세요. 이미지와 동영상은 작업 로그에서 확인합니다.
요청이 실패하면 HTTP 상태 코드와 error 객체를 확인하세요. 키, 잔액, 모델 ID와 지원되는 매개변수 조합을 점검하세요. 응답 거부나 출력 한도에 따른 중단은 HTTP 오류와 다릅니다. 요청이나 스트림이 중단되었다면 재시도 전에 로그를 확인하세요. 새 요청에는 추가 비용이 발생할 수 있습니다.