LogoWan API 문서
홈페이지
X (Twitter)
홈페이지

시작하기

개요연동 가이드잔액 확인작업 삭제

Wan 모델

Wan 3.0Wan 3.0 PrimeWan 3.0 ProWan 3.0 Prime Pro

Seedance 모델

Seedance 2.5Seedance 2.5 FlashSeedance 2.0Seedance 2.0 FastSeedance 2.0 Mini

이미지 모델

Seedream 5.0 ProSeedream 5.5 API

언어 모델

Claude APIClaude Haiku 5.5Claude Sonnet 5.5Claude Opus 5.5Claude Fable 5.2GPT APIGPT Luna 6GPT Terra 6.1GPT Sol 6.1GPT Astra 6
X (Twitter)

Claude Fable 5.2 API

Claude Fable 5.2 API의 적응형 사고, 기본 high 노력 수준, 네이티브 매개변수, 베타 요건과 그룹별 토큰 요금을 안내합니다.

이 참조 문서는 Claude Fable 5.2의 Messages 매개변수를 설명합니다. POST https://api.wanapi.app/v1/messages에 claude-fable-5-2를 사용하세요. Claude 모델 비교.

모델 설정

설정Claude Fable 5.2
모델 IDclaude-fable-5-2
컨텍스트 창토큰 1M개
최대 동기 출력사고 토큰을 포함하여 128000개
사고 모드적응형, 항상 활성화
기본 사고 노력high
강제 도구 호출(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-fable-5-2",
    "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-fable-5-2",
    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-fable-5-2. 정확한 ID를 사용하세요. 그룹은 자동으로 선택됩니다.
max_tokens필수 정수사고 토큰을 포함하여 0–128000. 0은 stream true, 구조화된 출력 또는 강제 도구 호출과 함께 사용할 수 없습니다.
messages필수 배열공식 대화 턴 1–100000개. pause_turn 이후 스레드를 이어가는 경우에만 비워 둘 수 있습니다.
system문자열 또는 텍스트 블록 배열스레드를 이어갈 때는 완전히 생략해야 합니다.
thinking객체, 기본값은 adaptiveadaptive만 허용합니다. display: omitted(기본값), summarized, updates 또는 null.
output_config객체effort: low, medium, high(기본값), xhigh, max 또는 null. format과 task_budget은 선택 사항입니다.
output_format객체 또는 null지원 중단 예정인 구조화된 출력 별칭. output_config.format을 권장합니다.
stop_sequences문자열 배열null을 허용하지 않습니다. 요청 시 압축과 함께 사용할 수 없습니다.
stream불리언, falsetrue이면 SSE를 반환합니다. null을 허용하지 않습니다.
tools배열공식 클라이언트 도구와 서버 도구·도구 세트. 클라이언트 도구는 사용자 애플리케이션이 실행합니다.
tool_choice객체auto 또는 none. 강제 도구 호출은 거부됩니다.
metadata객체user_id는 최대 512자의 문자열 또는 null입니다.
cache_control객체 또는 nulltype은 ephemeral, ttl은 5m 또는 1h입니다.
container문자열, 객체 또는 null선택적 id와 최대 20개의 스킬.
context_management객체 또는 null공식 컨텍스트 편집. 해당 베타가 필요합니다.
mcp_servers배열최대 20개의 HTTPS 서버. 해당 MCP 베타가 필요합니다.
diagnostics객체 또는 nullprevious_message_id는 최대 256자의 문자열 또는 null입니다.
service_tierauto 또는 standard_only선택 사항. null은 허용하지 않습니다.
inference_geo문자열 또는 null계정에서 이용 가능한 global 또는 us.
speed문자열 또는 nullstandard, fast 또는 null. fast에는 베타가 필요하지 않습니다.
compaction객체 또는 nulltype은 summarize. 선택적 instructions는 최대 16384개의 유니코드 문자입니다.
fallbacksdefault, 배열 또는 null서로 다른 대상 최대 3개. 공식 server-side-fallback 베타가 필요합니다.
fallback_credit_token문자열, 객체 또는 null토큰은 최대 2048자. 공식 크레딧 베타가 필요하며 fallbacks와 함께 사용할 수 없습니다.
thread객체 또는 nullcreate 또는 previous_message_id를 사용한 continue. message-threads-2026-08-12가 필요합니다.

사고 모드와 도구

Claude Fable 5.2는 기본적으로 high 노력 수준의 적응형 사고를 사용합니다. enabled, disabled, between_tools 사고 모드와 budget_tokens는 지원하지 않습니다. thinking.display: updates에는 thinking-display-updates-2026-08-18이 필요합니다. thinking.block_binding은 thinking-binding-controls-2026-08-01을 사용할 때 prefix_mismatch_behavior에 error, drop_block 또는 null을 허용합니다.

output_config.task_budget에는 task-budgets-2026-03-13이 필요합니다. type은 tokens, total은 최소 20000인 정수이며, 선택적 remaining은 0 이상의 정수입니다. 압축을 사용하거나 서명된 압축 블록을 다시 보낼 때는 remaining을 생략하세요. 요청 시 압축에는 compact-2026-09-04가 필요하며, context_management, stop_sequences, 구조화된 출력 또는 강제 도구 호출과 함께 사용할 수 없습니다. 임계값 기반 압축은 compact-2026-01-12를 사용하며 input_tokens 트리거는 최소 50000이어야 합니다.

시스템 메시지별 사고 노력에는 mid-conversation-output-config-2026-07-01이 필요합니다. 마지막 어시스턴트 응답 미리 채우기는 거부되지만, 공식 pause_turn 및 압축 이후의 대화 이어가기는 유효합니다.

컴퓨터 사용에는 computer_toolset_20260801을 사용하세요. Advisor 도구에는 advisor-tool-2026-03-01과 지원되는 대상이 필요합니다. 도구 실행과 권한은 사용자 애플리케이션이 제어합니다.

스레드를 이어갈 때는 새 메시지만 전송하고 system과 tools를 생략해야 합니다. 압축 또는 모든 사고를 유지하는 것 이외의 컨텍스트 편집과 함께 사용할 수 없습니다. 요청 없이 5분이 지나면 상태가 만료되므로 대화는 로컬에 보관하세요. 상태에 따른 제약은 대화를 이어갈 때 확인됩니다.

Fable 5.2의 대체 모델 대상은 Claude Opus 4.8과 Claude Opus 5입니다. 고급 베타 기능의 실행과 fast 모드 과금은 실제 검증이 필요합니다. 요청 스키마 자체가 실측으로 확인된 기능을 보장하지는 않습니다.

미디어 입력

이미지와 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 Fable 5.2

claude-fable-5-2

Claude Fable 5.2 — 토큰 100만 개당 USD
과금 대상 토큰claude · 기본
모든 입력 길이
입력(캐시되지 않음)US$4
출력US$20
캐시 읽기US$0.1
캐시 쓰기 · 5분US$5
캐시 쓰기 · 1시간US$8

—는 확인된 요금이 없다는 뜻이며, 무료를 의미하지 않습니다.

캐시 요금은 응답에 해당 캐시 사용량이 보고된 경우에만 적용됩니다. 캐시된 토큰을 캐시되지 않은 입력으로 다시 계산하지 마세요.

각 과금 대상 토큰 수에 해당 단가를 곱하고, 합계를 1,000,000으로 나누세요. 사고 토큰은 출력 토큰에 포함되며 별도로 중복 과금되지 않습니다. 캐시 읽기, 5분 쓰기, 1시간 쓰기에는 각각 별도의 단가가 적용됩니다. 길이에 따른 요금은 먼저 해당 구간을 선택한 뒤 요청 비용을 계산하세요.

응답과 스트리밍

완료된 메시지에는 id, type, role, model, content, stop_reason, usage가 포함됩니다. content에서 텍스트 블록을 읽으세요. 첫 번째 블록은 텍스트가 아닌 사고 또는 도구 호출일 수 있습니다. 아래 응답은 예시입니다.

{
  "id": "msg_example",
  "type": "message",
  "role": "assistant",
  "model": "claude-fable-5-2",
  "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-fable-5-2","max_tokens":256,"messages":[{"role":"user","content":"Reply with OK."}]}'

사용 로그와 오류

LLM 로그에서 최근 7일 동안 완료된 호출의 모델, 입력 토큰, 출력 토큰과 비용을 확인할 수 있습니다. 호출 후 새로고침하고 claude-fable-5-2로 필터링하세요. 이미지와 동영상은 작업 로그에서 확인합니다.

요청이 실패하면 HTTP 상태 코드와 error 객체를 확인하세요. 키, 잔액, 모델 ID와 지원되는 매개변수 조합을 점검하세요. 응답 거부나 출력 한도에 따른 중단은 HTTP 오류와 다릅니다. 요청이나 스트림이 중단되었다면 재시도 전에 로그를 확인하세요. 새 요청에는 추가 비용이 발생할 수 있습니다.

모델 참고 문서

  • 모델 개요
  • Messages 참조 문서
  • 사고 모드

Claude Opus 5.5

Claude Opus 5.5 API의 적응형 사고, 기본 medium 노력 수준, 매개변수, 스트리밍과 그룹별 토큰 요금을 안내합니다.

GPT API

GPT Luna 6, Terra 6.1, Sol 6.1, Astra 6 API: 모델 ID, 추론 설정, 실시간 토큰 요금.

목차

모델 설정연결 및 요청 전송현재 API 지원 범위매개변수사고 모드와 도구미디어 입력요금응답과 스트리밍OpenAI 호환 형식사용 로그와 오류모델 참고 문서