변경 로그

web_search: true로 보낸 요청은 출처를 밝힙니다. /v1/chat/completions와 /v1/messages의 sources는 모델에 전달된 결과를 나열하고, /v1/chat/completions의 annotations는 답변이 각 출처를 인용한 위치를 표시합니다. 내장 웹 검색

/v1/chat/completions와 /v1/messages의 web_search: true는 모델이 답하기 전에 웹 검색을 실행하고 그 결과를 번호가 매겨진 출처로 전달합니다. 결과를 찾은 요청은 일일 할당량의 검색 한 번을 사용합니다. 남은 검색이 없으면 검색 없이 응답합니다. 내장 웹 검색

서버 측에서 끊긴 스트림은 그 시점까지 보고된 사용량만큼 청구됩니다. 확보해 둔 나머지 양은 잔액으로 돌아옵니다.

shannon-coder-1이 다른 두 엔드포인트와 마찬가지로 /v1/responses에서도 응답합니다. CLI 코딩 도구

교체된 API 키는 즉시 작동을 멈춥니다.

POST /v1/tokenize와 POST /v1/messages/count_tokens: 호스팅 오픈 웨이트 모델용 무료 토큰 계산. 토큰 수 계산

호스팅 오픈 웨이트 모델의 프롬프트 캐싱. 캐시된 입력은 입력 가격의 25%로 청구되며 세 엔드포인트 모두의 usage에 보고됩니다: prompt_tokens_details.cached_tokens, input_tokens_details.cached_tokens, cache_read_input_tokens. GET /v1/models는 이 모델들에 대해 pricing.cached_input_per_million_usd와 capabilities.prompt_caching을 보고합니다. 프롬프트 캐싱

호스팅 오픈 웨이트 모델: 강제된 tool_choice(required 또는 이름이 지정된 함수)는 도구 호출을 생성합니다. 함수 호출

호스팅 오픈 웨이트 모델이 대화의 첫 메시지가 아닌 system 메시지를 허용합니다.

API는 Tor onion 서비스와 I2P 주소로 접속할 수 있습니다. api.shannon-ai.com의 응답은 Onion-Location과 X-I2P-Location 헤더에 두 주소를 담습니다. 암호화, Tor, I2P 엔드포인트

새 모델 shannon-3.1과 shannon-3.1-pro가 GET /v1/models에 나열됩니다. 모델 및 가격

클라이언트의 연결이 끊긴 스트리밍 요청도 끝까지 실행되고 집계됩니다. 이전에는 연결이 끊기면 답변이 중단되었습니다.

/v1/responses로 보낸 요청이 사용 로그에 표시됩니다.

호스팅 오픈 웨이트 모델이 샘플링 필드를 적용합니다. /v1/chat/completions에서는 temperature, top_p, seed, stop, max_tokens, /v1/messages에서는 temperature, top_p, stop_sequences, /v1/responses에서는 temperature, top_p, max_output_tokens입니다. Chat Completions

사용 로그에 호출별 및 합계 비용이 USD로 표시됩니다.

공개된 id가 아닌 model 값은 세 엔드포인트 모두에서 400, 유형 invalid_request_error, 메시지 unknown model: <id>로 응답합니다. 이전에는 이런 요청에 shannon-1.6-lite가 응답했습니다. 모델 및 가격

/v1은 API 키만 받습니다. 웹사이트의 로그인 쿠키는 읽지 않습니다. 인증

플러드 보호: 세 생성 엔드포인트에서 계정당 분당 120건의 요청. 한도 및 잔액

모델이 응답할 수 없을 때 오류에는 고정 메시지 The model backend failed to answer. Please retry.가 담깁니다. 잔액 확인을 할 수 없는 경우에는 503과 유형 api_error로 응답합니다. 오류 처리

스트리밍이 아닌 요청이 실패하면 확보해 둔 양이 잔액으로 돌아옵니다.

GET /v1/models가 각 모델의 capabilities.reasoning_effort를 보고합니다. 추론 effort

호스팅 오픈 웨이트 모델: 스트리밍이 아닌 요청이 응답을 받지 못하면 504와 유형 api_error로 끝납니다. 빈 결과는 502입니다. 오류 처리

호스팅 오픈 웨이트 모델은 지명한 모델이 받는 입력을 받습니다. 텍스트 전용 id에 이미지를 보내면 400과 <id> does not accept image input으로 응답합니다. 구조화된 출력이 없는 id에 response_format을 보내면 400으로 응답합니다. GET /v1/models는 각 id에 대해 capabilities.vision, response_format, json_schema를 보고합니다. 이미지와 파일

스트리밍이 아닌 응답에도 추론 텍스트가 포함됩니다. /v1/chat/completions에서는 메시지의 reasoning_content, /v1/messages에서는 텍스트 앞의 thinking 블록입니다. 추론 effort

호스팅 오픈 웨이트 모델의 가격이 새로 책정되었습니다. 입력 1M 토큰당 $0.50, 출력 1M 토큰당 $2.00부터입니다. 모델 및 가격

호스팅 오픈 웨이트 모델은 모델마다 id가 하나씩 있으며, 모두 열두 개입니다. 모델 및 가격

shannon-3, shannon-3-pro, shannon-3.1, shannon-3.1-pro에서 구조화된 출력을 지원합니다. GET /v1/models는 이 모델들에 대해 capabilities.json_schema: true를 보고합니다. 구조화된 출력

/v1/responses가 구조화된 출력을 위해 text.format(json_object 또는 json_schema)을 읽습니다. Responses API

/v1/responses가 Shannon 모델의 추론을 반환합니다. message 항목 앞에 reasoning 출력 항목이 오고, 스트림 이벤트로 response.reasoning_summary_text.delta와 response.reasoning_summary_text.done이 있습니다. Responses API

응답의 model 필드는 모든 엔드포인트에서 공개된 id입니다. Responses 객체에는 model과 created_at이 포함됩니다.

GET /v1/models가 각 모델의 컨텍스트 윈도우를 보고합니다. 모델 및 가격

호스팅 오픈 웨이트 모델이 /v1/chat/completions뿐 아니라 /v1/messages와 /v1/responses에서도 사용자의 시스템 프롬프트 및 도구 호출과 함께 응답합니다. /v1/messages는 thinking을 받으며, reasoning_effort는 요청 필드입니다. 모델 및 가격

/v1의 오류 본문은 SDK 형식을 따릅니다. OpenAI 형식 엔드포인트에서는 type과 message가 있는 error 객체이고, /v1/messages에서는 같은 객체가 {"type": "error"} 안에 들어갑니다. 오류 처리

열려 있는 스트림에 15초마다 keep-alive 전송: /v1/chat/completions에서는 : ping 주석 줄, /v1/messages에서는 event: ping. 스트리밍

도구 호출 id는 /v1/chat/completions와 /v1/responses에서는 call_로, /v1/messages에서는 toolu_로 시작합니다. 함수 호출

/v1/responses: stream의 기본값은 false입니다. Responses API

/v1/chat/completions에서 max_completion_tokens가 max_tokens의 다른 이름으로 허용됩니다. Chat Completions

Responses 스트림의 response.completed 이벤트가 output 배열을 포함합니다. Responses API

GET /v1/models 항목에 display_name, context_window, max_output_tokens, pricing, capabilities, endpoints가 포함됩니다. 모델 및 가격

모든 응답에 x-request-id가 포함되며, 보낸 값은 그대로 반환됩니다. 요청 본문은 최대 32 MiB까지 가능합니다.

새 키를 발급하지 않고도 키를 폐기할 수 있습니다. 사용 로그는 페이지로 나뉩니다.

요청의 이미지와 문서: /v1/chat/completions의 image_url 파트, /v1/messages의 image, document, file 블록, /v1/responses의 input_image 파트. 이미지와 파일

새 모델 shannon-3-pro. 모델 및 가격

새 모델 shannon-3. 모델 및 가격

/v1/chat/completions의 스트림은 추론을 delta.reasoning_content로 전달합니다. 추론 effort

max_tokens는 1에서 65,536 범위로 유지됩니다. 이 범위를 벗어난 값은 거부되지 않고 가장 가까운 끝값으로 조정됩니다. Chat Completions

shannon-coder-1은 /v1/chat/completions와 /v1/messages에서 플랜별 호출 횟수로 집계됩니다. 한 구간의 호출 횟수를 모두 사용하면 Shannon Coder call quota reached 메시지와 함께 429로 응답합니다. CLI 코딩 도구

컨텍스트 윈도우보다 큰 대화는 400, 유형 invalid_request_error, 코드 context_length_exceeded로 응답합니다. 스트림 중의 오류는 답변 속 텍스트가 아니라 오류 이벤트로 도착합니다. CLI 코딩 도구

/v1 엔드포인트: POST /v1/chat/completions, POST /v1/messages, POST /v1/responses, GET /v1/models. OpenAI 및 Anthropic SDK, Claude Code, Codex CLI가 호출하는 엔드포인트입니다. 개요

/v1/chat/completions와 /v1/messages에서 tools를 이용한 도구 호출, response_format을 이용한 구조화된 출력, /v1/messages에서 문자열 또는 텍스트 블록 형태의 system. 함수 호출

shannon-1.6-lite와 함께 모델 id shannon-1.6-pro, shannon-2-lite, shannon-2-pro, shannon-coder-1 추가. 모델 및 가격

API 첫 릴리스: OpenAI 형식과 Anthropic 형식의 채팅, 그리고 Responses 엔드포인트. 모두 sk-로 시작하는 API 키로 호출합니다. 인증