소개
Claude Fable 5는 서사 쪽에 무게를 둔 Anthropic의 채팅 모델로, 여기서는 /v1/chat/completions의 OpenAI 호환 엔드포인트 하나로 제공합니다. 요청마다 최대 1,000,000토큰을 읽고 응답 하나로 최대 128,000토큰을 쓰므로, 롤플레이 대화 기록 전체를 그대로 보내고 한 챕터를 통째로 받을 수 있습니다.
메시지 내용은 텍스트와 이미지를 받습니다. 추론 강도는 low, medium, high 중에서 고르며 기본값은 medium이고, 같은 호출에 도구 정의를 최대 128개까지 실을 수 있으며 응답은 Server-Sent Events로 스트리밍할 수 있습니다. 샘플링은 모델이 고정하므로 temperature와 top_p는 요청에 넣지 않습니다.
핵심 기능 및 하이라이트
지금까지의 이야기를 위한 100만 토큰
긴 세션이 무너지는 건 문장이 나빠져서가 아니라, 서른 턴 전에 한 약속을 캐릭터가 잊어버릴 때입니다. 입력 1,000,000토큰이면 요약 대신 쓰인 그대로의 대화 기록을 보낼 수 있어서, 나중에야 의미가 생기는 한 줄도 그때까지 남아 있습니다.
챕터 길이의 응답
max_tokens는 128,000까지 올릴 수 있고 기본값은 4,096입니다. 한 챕터를 한 번에 받고 싶다면 일부러 올리세요. 한 번의 생성으로 쓴 장면은 인칭, 시제, 호흡이 유지되지만 이어 붙인 조각은 이음매에서 어긋나기 쉽습니다.
요청마다 정하는 추론 강도
low, medium, high는 요청 본문의 문자열 하나이고 기본값은 medium입니다. 심어 둔 복선과 확정된 사실을 맞춰야 하는 장면에서는 high로, 속도가 더 중요한 짧은 대화 턴에서는 low로 낮춥니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
messages | 예 | 순서대로 놓인 대화 턴이며, content는 문자열이거나 text와 |
max_tokens | 아니요 | 응답을 128,000에서 자릅니다. 기본값은 4,096입니다. |
reasoning_effort | 아니요 | low, medium, high 중 하나이고 기본값은 medium입니다. 높은 단계는 수십 턴에 걸친 일관성을 지키는 데 시간을 더 씁니다. |
stop | 아니요 | 최대 4개의 정지 시퀀스를 문자열 또는 배열로 지정합니다. 모델이 그중 하나를 쓰는 즉시 응답이 끝나며, 일치한 텍스트 자체는 반환되지 않습니다. 1자 이상 · 1개 이상 · 4개 이하 |
tools | 아니요 | 요청당 함수 정의 최대 128개입니다. 128개 이하 |
parallel_tool_calls | 아니요 | true 또는 false이며 기본값은 true입니다. true이면 모델이 한 턴에 여러 도구 호출을 요청할 수 있습니다. 기본값: |
tool_choice | 아니요 | auto, none, required, 또는 함수 하나를 지정한 객체입니다. |
요금
입력 $9 / 출력 $45 100만 토큰당
활용 사례
한 캐릭터를 쉰 턴 동안 유지하기
페르소나와 확정된 사실은 system 메시지에, 지금까지의 본문 전체는 대화 기록에 넣습니다. 캐릭터가 맹세한 것, 거절한 것, 무심코 흘린 것을 매 턴 원래 표현 그대로 읽히므로 메모에서 다시 짜 맞출 필요가 없습니다.
여러 인물이 함께하는 장면
한 방에 있는 네 인물의 말투, 입버릇, 금기가 이미 기록에 남아 있습니다. 장면 전체를 다시 보내 이어 쓰게 하면 각 목소리가 제 주인에게 붙어 있어 하나의 말투로 뭉개지지 않습니다.
연재 소설을 호출 한 번에 한 챕터씩
지금까지의 이야기를 보내고 다음 챕터를 요청하되, max_tokens를 그 길이에 맞게 올립니다. 한 번의 긴 생성에는 손볼 이음매가 없으므로, 조각을 이어 붙인 글에 보통 필요한 퇴고 과정을 줄일 수 있습니다.
프롬프트 가이드 및 실전 팁
요약 말고 본문을 보내세요
요약에는 그 순간 중요해 보였던 것만 남고, 긴 픽션에서 그것이 나중에 필요한 디테일인 경우는 드뭅니다. 대화 기록은 messages 배열에 오래된 순서로 넣고, 말투와 시점, 넘지 않을 선은 system 메시지에 두세요.
확정된 사실은 짧은 목록으로
편지는 끝내 부치지 않았다. 빚진 상대는 남동생이다. 화자는 누나의 이름을 한 번도 부르지 않는다. system 메시지의 세 줄은 200,000토큰 앞에 묻힌 세 가지 사실보다 놓치기 어렵습니다.
요청의 한계를 미리 반영하세요
128,000을 넘는 max_tokens는 검증에서 거부되고, 도구 결과도 본문과 같은 창을 차지합니다. 동영상과 오디오 파트는 받지 않으며, 응답 앞부분을 미리 채우려고 assistant 메시지로 대화를 끝낼 수도 없습니다. 기계가 읽을 출력이 필요하면 JSON 스키마를 매개변수로 삼은 도구를 정의하고 tool_choice로 호출을 강제하세요.
API 빠른 시작
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "anthropic/claude-fable-5/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.
