Claude Haiku 5.5

POST https://api.seedrouter.ai/v1/messages에서 claude-haiku-5-5를 사용합니다. 모델은 텍스트, 이미지, 문서를 입력받아 텍스트 또는 도구 호출을 반환합니다. 모델 페이지에서 현재 토큰 요율을 확인할 수 있습니다.

아래 계약은 2026년 10월 9일에 확인한 Anthropic의 모델별 문서를 따릅니다. 공식 기능 한계와 전체 경로 검증은 별개입니다. 필드가 수락되었다고 의도한 효과가 발생했다는 의미는 아닙니다. 고급 옵션을 사용하기 전에 아래 호환성 결과를 확인하세요.

빠른 시작

curl https://api.seedrouter.ai/v1/messages \
  -H "x-api-key: $SEEDROUTER_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": "Classify this request as billing, technical or account: I was charged twice. Return only the label."}]
  }'

import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["SEEDROUTER_API_KEY"],
    base_url="https://api.seedrouter.ai",
)
message = client.messages.create(
    model="claude-haiku-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Summarize the purpose of a database index."}],
)
for block in message.content:
    if block.type == "text":
        print(block.text)

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  apiKey: process.env.SEEDROUTER_API_KEY,
  baseURL: 'https://api.seedrouter.ai',
});
const message = await client.messages.create({
  model: 'claude-haiku-5-5',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Summarize the purpose of a database index.' }],
});
for (const block of message.content) {
  if (block.type === 'text') console.log(block.text);
}

API 키는 서버에 보관하세요. type으로 응답 블록을 선택합니다. 응답은 사고 또는 도구 호출로 시작할 수 있습니다.

package main

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

func main() {
    body, err := json.Marshal(map[string]any{
        "model": "claude-haiku-5-5",
        "max_tokens": 1024,
        "messages": []map[string]string{
            {"role": "user", "content": "Summarize the purpose of a database index."},
        },
    })
    if err != nil { panic(err) }
    req, err := http.NewRequest("POST", "https://api.seedrouter.ai/v1/messages", bytes.NewReader(body))
    if err != nil { panic(err) }
    req.Header.Set("x-api-key", os.Getenv("SEEDROUTER_API_KEY"))
    req.Header.Set("anthropic-version", "2023-06-01")
    req.Header.Set("Content-Type", "application/json")
    client := &http.Client{Timeout: 2 * time.Minute}
    res, err := client.Do(req)
    if err != nil { panic(err) }
    defer res.Body.Close()
    data, err := io.ReadAll(res.Body)
    if err != nil { panic(err) }
    if res.StatusCode >= 400 { panic(fmt.Sprintf("HTTP %d: %s", res.StatusCode, data)) }
    fmt.Println(string(data))
}

요청 파라미터

네이티브 계약에는 최상위 필드 25개 가 있습니다. 선택 사항이라고 null을 허용하는 것은 아닙니다. null을 명시한 행만 이를 허용합니다. 텍스트 모델 파라미터 정책에 따라 알 수 없는 필드와 지원하지 않는 샘플링 필드는 전달 전에 제거합니다. 지원하는 필드에 잘못된 값을 입력하면 생성 전에 invalid_request_error를 반환합니다.

플레이그라운드는 지원 필드의 컨트롤과 중첩 구조용 JSON 컨트롤을 제공합니다. 샘플링 파라미터와 고정된 표준 속도는 폼에서 생략합니다. 모델 ID는 이 페이지의 모델로 고정됩니다. JSON 요청 미리보기에서 제출 본문을 확인하세요.

사고와 노력 수준

기본값은 medium 노력 수준의 적응형 사고이며 사고 텍스트는 생략합니다. 노력 수준은 low, medium, high, xhigh, max 또는 기본값을 사용하는 null을 허용합니다.

{
  "thinking": {"type": "adaptive", "display": "summarized"},
  "output_config": {"effort": "medium"}
}

사고를 비활성화하려면 low, medium, high 노력 수준과 {"type":"disabled"}를 사용합니다. disabled 모드에는 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 }이며 선택적 정수/null remaining을 포함할 수 있습니다. 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이 있습니다. 도구 선언만으로 전체 서버 도구 세션의 작동을 검증할 수 없습니다. 사용하기 전에 도구의 공식 가이드와 베타 요구 사항을 검토하세요.

대화와 컨텍스트 관리

일반적인 어시스턴트 프리필은 지원하지 않습니다. 일시 중지된 서버 도구의 계속 실행은 다릅니다. Messages 프로토콜의 안내에 따라 전체 어시스턴트 블록을 다시 보냅니다.

내용이 있는 system 메시지는 user 메시지 또는 일시 중지된 서버 도구 결과 뒤에 올 수 있습니다. 그 뒤에 assistant 메시지가 오거나 마지막 메시지여야 합니다. 연속된 system 메시지는 하나의 그룹으로 평가합니다. 클라이언트 도구 호출과 필수 결과 사이에는 삽입하지 마세요.

내용이 빈 system 메시지는 mid-conversation-output-config-2026-07-01을 통해 output_config.effort만 변경할 수 있습니다. 어디에나 배치할 수 있습니다. 사고가 비활성화된 동안에는 유효 노력 수준을 변경할 수 없습니다. system의 clear_at은 mid-conversation-system-clear-at-2026-08-21과 함께 never, next_user_message, null을 허용합니다. 턴 범위 메시지는 텍스트만 허용하며 출력 설정이나 블록 캐싱은 사용할 수 없습니다.

컨텍스트 편집에는 다음이 포함됩니다.

온디맨드 compaction에는 compact-2026-09-04가 필요합니다. context_management, stop_sequences, 출력 형식, 도구 강제, task_budget.remaining과 결합할 수 없습니다. 서명된 압축 블록도 task_budget.remaining이나 임계값 기반 압축과 결합할 수 없습니다. 계속할 때 반환된 블록과 서명을 보존하세요.

이미지, PDF와 요청 크기

이미지는 JPEG, PNG, GIF, WebP를 URL, base64 또는 파일 참조로 허용합니다. PDF도 URL, base64, 파일 참조를 허용합니다. 파일 참조에는 관련 Files API 베타와 유효한 파일 접근 권한이 필요합니다. 텍스트 문서에는 텍스트 또는 콘텐츠 소스를 사용할 수 있습니다.

네이티브 요청 한도는 32 MB입니다. 공식 이미지 한도는 최대 600장, 이미지당 base64로 인코딩된 데이터 10 MB, 각 변 8000픽셀입니다. 이미지가 많은 요청에는 플랫폼별로 더 엄격한 제한이 있을 수 있습니다. 이 모델의 컨텍스트 크기에서 PDF는 암호화되지 않아야 하며 최대 600페이지입니다. 원격 파일 검사는 여전히 API의 책임입니다. 로컬 형태 검사만으로 URL 내용을 확인할 수 없습니다.

플레이그라운드는 첨부 파일을 업로드한 뒤 URL을 제출합니다. 대화 JSON도 네이티브 미디어 콘텐츠 블록을 지원합니다. 전체 미디어 크기와 컨텍스트 윈도우 경계 검사는 작은 예시 요청과 별개입니다.

프롬프트 캐싱과 과금

Haiku의 캐시 가능한 최소 프롬프트는 512토큰입니다. 더 짧은 프롬프트에 표시를 해도 캐시 항목 생성 없이 실행될 수 있습니다. 캐시 중단점은 최대 4개를 사용하세요. 자동 최상위 캐시 제어가 슬롯 하나를 소비합니다. 유효 기간이 긴 캐시 접두사를 짧은 접두사 앞에 배치하세요.

max_tokens: 0은 답변 생성 없이 캐시 사전 준비를 요청합니다. stream: true, 구조화된 출력, 도구 사용 강제와 함께 사용할 수 없습니다. 캐시 준비와 재사용 요청 사이에 사고 및 노력 수준 설정을 일치시키세요.

usage.input_tokens, output_tokens, cache_creation_input_tokens, cache_read_input_tokens 및 cache_creation 아래의 5m/1h 내역을 확인하세요. 사고는 출력 토큰에 포함됩니다. 보고된 사고 토큰 내역은 다시 더할 추가 요금이 아닙니다. 현재 요율은 요금 섹션에 있으며 요금 가이드에서 더 자세히 설명합니다.

응답, 스트리밍과 오류

완료된 응답에는 id, type: "message", role: "assistant", model, content, stop_reason, stop_sequence, usage가 포함됩니다. 선택적 container, diagnostics, context_management, stop_details, input_transformations는 반환되는 경우 보존합니다.

end_turn, max_tokens, stop_sequence, tool_use, pause_turn, compaction, refusal, model_context_window_exceeded를 처리하세요. 한도에 따른 중지나 거절은 HTTP 오류와 다릅니다. 첫 번째 콘텐츠 블록이 항상 텍스트라고 가정하지 마세요.

스트리밍은 Messages SSE 이벤트 message_start, content_block_start, content_block_delta, content_block_stop, message_delta, message_stop을 사용합니다. ping 및 error 이벤트도 처리하세요. 이후 턴에 필요한 사고 서명과 도구 블록을 보존하세요.

오류는 Anthropic 형식을 사용합니다.

{"type":"error","error":{"type":"invalid_request_error","message":"max_tokens must be an integer from 0 to 128000."}}

오류를 반환한 요청은 과금되지 않습니다. 공통 오류 유형은 오류 처리를 확인하세요.

OpenAI 호환 형식

동일한 ID를 /v1/chat/completions와 /v1/responses에서도 사용할 수 있습니다. 각 형식의 네이티브 필드를 사용하세요. Chat은 messages, Responses는 input을 사용합니다. Claude 네이티브 옵션은 Messages용이며 OpenAI 형식 본문에 그대로 모두 복사하면 안 됩니다.

curl https://api.seedrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-5-5","max_tokens":256,"messages":[{"role":"user","content":"Reply with OK."}]}'

curl https://api.seedrouter.ai/v1/responses \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-5-5","max_output_tokens":256,"input":"Reply with OK."}'

호환성 결과

2026년 10월 9일 개발 환경에서 확인했습니다. 이 검사는 특정 요청에서 관찰한 동작을 확인한 것이며 모든 공식 한계나 운영 배포를 검증한 것은 아닙니다.

1시간 캐시 쓰기와 압축 과금은 출시 검증을 통과하지 않았습니다. 최대 컨텍스트/출력 실행, 별도 요금이 있는 호스팅 도구, Files API 접근, 폴백 크레딧 사용은 테스트하지 않았습니다. 공식 요청 형태를 유지하고 성공 상태만으로 지원을 추론하지 마세요.

참조 자료

• Haiku 5.5 모델 개요
• Haiku 5.5 마이그레이션 가이드
• Messages 참조 문서
• 베타 Messages 참조 문서
• 사고, 노력 수준, 작업 예산
• 온디맨드 압축, 컨텍스트 편집
• 프롬프트 캐싱, 비전, PDF 지원