Nanobot API 비용 및 설정: 제공업체, 모델, 한도

HKUDS의 nanobot은 $0입니다. 직접 설치하고 실행하는 MIT 라이선스 소프트웨어이며, GitHub 저장소나 nanobot.wiki 어느 곳에도 요금제, 등급, 좌석 또는 호스팅 서비스가 게시되어 있지 않습니다. 예산에 포함할 항목은 모델 토큰, nanobot gateway을 계속 실행하는 시스템, 그리고 연결하는 유료 채널 또는 도구 계정입니다. 이후 토큰 비용을 결정하는 것은 두 가지입니다. config.json에 작성하는 제공업체 키가 무엇인지에 따라 전송 프로토콜이 결정되며, nanobot이 요청 없이 활성화하는 백그라운드 작업이 무엇인지에 따라 달라집니다.

2026년 9월 21일 GitHub 및 PyPI API를 기준으로 확인했습니다. 릴리스 v0.3.5, 게시일 2026년 9월 15일; 패키지 nanobot-ai 0.3.5, MIT, Python 3.11 이상, 같은 날 업로드됨; 저장소는 MIT이며 보관되지 않았고 확인 당일 마지막으로 푸시되었습니다. 이 페이지 전체에 적용되는 범위 참고 사항이 하나 있습니다. 아래에 인용한 문서는 v0.3.5 태그보다 5일 앞선 main 브랜치에서 확인했으므로, 문서의 설명과 제공된 소스의 기본값을 별도로 표시하고 절대 합치지 않았습니다.

먼저 가격을 산정하는 nanobot이 어느 것인지 확인하세요

nanobot.ai는 nanobot 가격 페이지가 아닙니다. 2026년 9월 21일 이 사이트는 obot.ai로 리디렉션되었고, 제목은 "Obot | Enterprise AI Control Plane & MCP Gateway"였습니다. 이는 다른 회사의 엔터프라이즈 제품이며 자체 가격도 게시하지 않습니다. 해당 날짜에 /pricing URL이 404를 반환했기 때문입니다. 추가로 두 가지 혼동이 있습니다. 이름이 단순히 nanobot인 PyPI 패키지는 버전 0.4.1의 로봇 내비게이션 프레임워크이므로 pip install nanobot를 실행하면 잘못된 소프트웨어가 설치됩니다. 또한 obot-platform/nanobot은 Apache-2.0 라이선스의 Go 프로젝트이며 README 첫머리에서 유지 관리 모드라고 선언하므로 그 구성 키는 여기 적용되지 않습니다.

nanobot의 비용을 항목별로 보기

여기에는 정직하게 밝혀야 할 두 가지 공백이 있습니다. nanobot의 CLI 참고 자료는 별도의 "Desktop" 런타임과의 공존을 설명하지만, 공개 다운로드 페이지·저장소·가격은 찾지 못했습니다. 따라서 뒷받침할 수 있는 주장은 두 공식 표면에 유료 등급이 게시되어 있지 않다는 것이지, 어디에도 유료 구성 요소가 존재하지 않는다는 뜻은 아닙니다. 또한 음성 항목은 가격 문제가 아니라 진행을 막는 제한입니다. 제한은 "사용자 지정 엔드포인트 없음"보다 좁습니다. v0.3.5의 전사 어댑터는 각각 apiBase을 허용하므로 OpenAI 형태의 전사 엔드포인트로 대체할 수 있지만, transcription.provider 자체는 해당 레지스트리의 이름이어야 합니다. 채팅에서처럼 여기에 사용할 제공업체 키를 새로 만들 수는 없습니다. 어쨌든 여기서는 의미가 없습니다. Kunavo는 음성 텍스트 변환 모델을 제공하지 않기 때문입니다.

nanobot 사용자 지정 제공업체: 두 가지 경로 중 이름을 지정할 수 있는 것은 하나뿐

일반적인 "기본 URL을 설정하세요" 예제가 잘못 설명하는 부분이 바로 이것입니다. nanobot에서는 설정하는 필드가 아니라 어떤 제공업체 키를 작성하는지에 따라 프로토콜이 선택되며, 두 경로는 서로 바꿔 사용할 수 없습니다.

경로 A — OpenAI 호환. providers 아래에 키를 새로 만들거나 내장 custom 키를 사용하고, 프리셋이 이를 가리키도록 하세요. 제공업체 참고 자료에 따르면 사용자 지정 키는 직접적인 OpenAI 호환 제공업체로 취급되고, nanobot은 엔드포인트 URL을 알 수 없으므로 apiBase가 필수이며 로컬 서버나 비공개 프록시에서는 apiKey가 선택 사항입니다. apiBase에 버전 경로를 포함하세요.

{
  "providers": {
    "kunavo": {
      "apiKey": "${KUNAVO_API_KEY}",
      "apiBase": "https://api.kunavo.com/v1"
    }
  },
  "modelPresets": {
    "primary": {
      "provider": "kunavo",
      "model": "claude-sonnet-5",
      "maxTokens": 8192,
      "contextWindowTokens": 200000
    },
    "cheap": {
      "provider": "kunavo",
      "model": "claude-haiku-4-5",
      "maxTokens": 8192,
      "contextWindowTokens": 200000
    }
  },
  "agents": {
    "defaults": {
      "modelPreset": "primary",
      "dream": {
        "modelOverride": "cheap"
      }
    }
  }
}

같은 참고 자료에서 이 블록에 적용되는 세 가지 규칙이 나옵니다. openai, openai-codex, github-copilot 또는 lm-studio 같은 내장 이름이나 별칭과 충돌하지 마세요. 사용자 지정 키에 apiType를 설정하지 마세요. 이는 providers.openai에만 사용되며 v0.3.5 스키마도 이를 적용합니다. 엔드포인트 문서에서 비표준 사고 토글을 명시한 경우에만 thinkingStyle를 설정하며, 허용되는 값은 thinking_type, enable_thinking 및 reasoning_split입니다. 모델 ID에는 문서의 한 줄만으로는 부족하므로 정확한 설명이 필요합니다. 문서에는 명시적으로 이름이 지정된 사용자 지정 제공업체 아래에서 모델이 작성된 그대로 전송된다고 되어 있고, 제공된 0.3.5 레지스트리는 동적 사양의 strip_model_prefixes을 제공업체 키 자체의 이름과 snake_case 형식으로 설정합니다. 문서의 해당 문장이 외부 접두사에 관한 것이라면 두 설명이 모두 성립합니다. 제공업체 키와 동일한 접두사는 제거되고 다른 접두사는 그대로 통과하며, 접두사 기반 제공업체 추론은 제공업체 "auto"에서만 실행됩니다.

경로 B — Anthropic Messages. 이 프로토콜에는 사용자 지정 이름을 사용하는 경로가 전혀 없습니다. 참고 자료에 따르면 임의의 사용자 지정 제공업체 이름은 OpenAI 호환 방식만 지원하며 Anthropic Messages 요청 형식은 사용하지 않고, 이름이 지정된 사용자 지정 경로는 Anthropic 호환 엔드포인트용이 아닙니다. 대신 내장 블록을 재정의합니다.

{
  "providers": {
    "anthropic": {
      "apiKey": "${KUNAVO_API_KEY}",
      "apiBase": "https://api.kunavo.com"
    }
  },
  "modelPresets": {
    "primary": {
      "provider": "anthropic",
      "model": "claude-sonnet-5",
      "maxTokens": 8192,
      "contextWindowTokens": 200000
    }
  },
  "agents": {
    "defaults": {
      "modelPreset": "primary"
    }
  }
}

이렇게 하면 providers.anthropic 자체가 수정되므로 게이트웨이는 해당 제공업체를 가리키는 모든 프리셋에서 직접 Anthropic을 그 옆에 두는 대신 대체하며, 네이티브 백엔드가 이를 거부하므로 proxy는 여기서 사용할 수 없습니다. Kunavo의 두 기본 URL 규칙은 두 경로에 정확히 대응합니다. 기본 URL 참고 자료는 Messages 경로에 대한 오리진과 OpenAI 호환 경로에 대한 /v1 형식을 제공합니다. nanobot은 이 점에서 이례적으로 관대합니다. 제공된 0.3.5 anthropic 제공업체는 URL을 SDK에 전달하기 전에 끝의 /v1를 제거합니다. 자체 주석에 따르면 Anthropic SDK가 요청 경로에 내부적으로 /v1를 추가하기 때문입니다. 따라서 nanobot에서는 두 표기가 모두 작동합니다. 기본 URL을 Anthropic SDK에 변경 없이 전달하는 클라이언트에서는 이 습관을 적용하지 마세요. 추가된 /v1가 중복되기 때문입니다. 위 블록에 관한 마지막 참고 사항 두 가지입니다. contextWindowTokens는 어떤 모델의 속성이 아니라 v0.3.5에서 nanobot 자체 프리셋의 기본값이므로 실제 수치는 모델 페이지에서 확인하세요. 또한 fallbackModels의 항목은 원시 ID가 아니라 프리셋 이름이며, 컨텍스트 크기는 체인에서 가장 작은 창에 맞춰집니다.

nanobot의 프롬프트 캐싱은 선택한 프로토콜을 따릅니다

이는 경로 A와 경로 B의 비용 차이에 관한 내용이며 제공된 소스에서 확인할 수 있습니다. v0.3.5에서 제공업체 사양에는 기본값이 false인 supports_prompt_caching가 있으며, 정확히 두 사양이 이를 true로 설정합니다. anthropic 및 openrouter입니다. OpenAI 호환 클라이언트는 해당 플래그가 설정되어 있고 모델 ID가 anthropic/ 또는 claude로 시작할 때만 캐시 제어 마커를 주입합니다. 내장 custom 사양과 동적으로 생성되는 모든 사용자 지정 제공업체는 플래그를 false로 유지하므로 OpenAI 호환 사용자 지정 경로는 캐시 마커를 전혀 보내지 않는 반면 네이티브 anthropic 백엔드는 기본적으로 캐시 마커를 적용합니다.

이는 클라이언트가 보내는 내용에 관한 설명이지 엔드포인트가 자체적으로 수행하는 작업에 관한 설명이 아닙니다. 엔드포인트는 별개로 서버 측에서 캐시할 수 있습니다. nanobot은 한 경로에서 prompt_tokens_details.cached_tokens를 정규화하고 다른 경로에서 cache_creation_input_tokens 및 cache_read_input_tokens를 읽어 확인할 수 있는 수단을 제공합니다. Kunavo가 이러한 필드를 nanobot에 반환하는지는 여기서 테스트하지 않았으므로, 반복 작업을 캐시된 것으로 예산에 반영하기 전에 실제 호출 한 번에서 반환된 사용량을 확인하세요. 프롬프트 캐싱과 캐싱 문서에서 작동하는 캐시의 모습을 확인할 수 있습니다.

nanobot에 가장 적합한 모델: 공급업체는 순위를 게시하지 않음

정직한 답은 nanobot 자체가 제시하는 답입니다. 제공업체 참고 자료에는 문서에 구체적인 제공업체 이름을 표시하는 이유가 JSON을 복사할 수 있도록 하기 위해서이지 nanobot이 제공업체 순위를 매기기 때문이 아니라고 명시되어 있습니다. 인용할 공급업체 벤치마크는 없습니다. nanobot이 제공하는 것은 기본값입니다. v0.3.5의 에이전트 기본값은 provider auto와 함께 anthropic/claude-opus-4-5을 지정하고, 최대 토큰 8192 및 컨텍스트 200,000토큰을 가정합니다. 해당 ID는 Kunavo 카탈로그에 없으므로 이곳을 대상으로 하는 프리셋은 카탈로그에 실제로 등록된 ID를 지정해야 하며 ID는 변경됩니다. 이 페이지를 포함한 어떤 페이지가 아니라 카탈로그에서 현재 ID를 확인하세요.

요금은 최신 Kunavo 카탈로그 가격이며, 작업 열은 누군가 측정한 품질 순위가 아니라 nanobot의 구조에서 도출됩니다. 구성보다는 성능을 기준으로 제품군을 비교하려면 Opus, Sonnet, Haiku 비교를 참조하세요.

계산 예시: 직접 입력한 대화와 nanobot이 자동으로 실행하는 주기적 작업

이는 측정된 작업 비용이 아니라 예시적인 토큰 산술이며 청구 금액의 상한도 아닙니다. 한 어시스턴트가 30일 동안 하루 20회의 직접 입력 대화를 처리하며, 대화당 캐시되지 않은 입력 토큰 10,000개와 출력 토큰 600개를 사용한다고 가정하세요. 그러면 한 달에 입력 토큰 6.0M개와 출력 토큰 0.36M개입니다.

출처로 확인된 부분은 일정이며, 토큰 크기와 실제로 비용이 청구되는 실행 횟수는 확인된 값이 아닙니다. nanobot의 구성 참고 자료는 기본적으로 intervalS 1800마다 게이트웨이 하트비트를 활성화하며, v0.3.5의 Dream 구성은 기본적으로 intervalH 2마다 활성화됩니다. 이에 따라 30일 동안 하트비트 틱은 1,440회, Dream 틱은 360회입니다. 틱은 모델 호출이 아닙니다. 제공된 v0.3.5 게이트웨이에서 하트비트 작업은 HEARTBEAT.md를 읽고, 파일이 없거나 ## Active Tasks 제목 아래에 내용이 없으면 모델 요청 전에 반환합니다. Dream 작업은 새 기록이 커서 이후 누적되지 않았을 때 "nothing to process"를 기록하고 반환합니다. 따라서 유휴 설치에서는 두 작업 모두 비용이 들지 않으며, 1,800은 일정상 허용되는 상한이지 반드시 도달할 하한이 아닙니다. nanobot은 두 작업 모두 실행당 토큰 수치를 게시하지 않습니다. 따라서 위의 세 가지 크기는 사용자가 직접 측정한 값으로 대체해야 하는 자리표시자이며, 해당 실행의 출력 토큰은 제외했습니다. 다른 에이전트의 하트비트 수치를 여기에 가져오지 마세요. 다른 프로그램에 해당하는 수치입니다.

두 레버는 대칭적이지 않습니다. Dream은 더 저렴한 프리셋을 가리키는 modelOverride을 허용합니다. 프리셋 이름만 가능하며 원시 ID는 거부됩니다. 위의 Path A 블록에 있는 한 줄 변경만 적용하면 됩니다. 하트비트에는 문서화된 모델 재정의 기능이 없습니다. 옵션은 enabled, intervalS, keepRecentMessages이므로 속도를 늦추거나 끌 수 있으며, 시스템이 관리하는 cron 작업이므로 cron 도구로 제거할 수 없습니다. 구성에서 비활성화한 뒤 게이트웨이를 다시 시작하세요. 실행할 작업이 있는 경우 하트비트 평가에는 구성 참조에서 모델 스트림을 여는 것으로 나열한 내부 작업이 포함되므로 비용은 HEARTBEAT.md에 입력한 내용에 따라 달라지고, 빈 파일이 가장 저렴한 경우입니다. Kunavo의 nanobot vs OpenClaw 페이지에는 Dream이 기본적으로 cron 일정으로 실행된다고 되어 있는데, 이는 메모리 참조와 일치합니다. v0.3.5에서는 이를 더 정확히 설명하며, 2시간마다 실행되는 interval 일정이고 cron은 레거시 재정의입니다.

Kunavo의 카탈로그 금액은 상한이 아니라 청구 하한입니다. 업스트림에서 요금을 보고하면 청구액은 카탈로그 비용과 업스트림 비용에 해당 마크업을 곱한 금액 중 더 큰 값입니다. 캐시 요금, 도구 및 호스팅 비용은 이 예시에 포함되지 않습니다. 최소 충전 금액은 선불 크레딧 $10입니다. 이는 자금 충전 최소액이지 작업 요금이나 구독료가 아닙니다. billing details 및 측정 방법은 cost optimization을 참조하세요.

루프 범위를 설정한 다음 한 번 실행하여 확인하세요

nanobot의 세 가지 턴당 제한 중 두 가지는 구성 참조에 전혀 없습니다. 제공된 v0.3.5 소스에서 확인하면 에이전트 기본값은 max_tool_iterations 200 및 max_tool_result_chars 16,000이고, 문서화된 참조에는 기본값이 4인 maxConcurrentSubagents만 main에 나옵니다. 200회 반복 제한은 비용이 큰 무한 실행 턴의 형태이므로 그대로 상속하지 말고 의도적으로 설정하세요.

그런 다음 문서에 기재된 순서대로 확인하세요. nanobot status은 의도적으로 모델 요청을 보내지 않으므로 비용 없이 구성을 확인하며, CLI 참조에서는 그다음에 nanobot agent -m "Hello!"을 실행하라고 안내합니다. 증상 표는 사용자 지정 엔드포인트에서 발생하는 네 가지 오류를 설명합니다. 401은 키가 없거나 만료되었거나 공백이 포함되었거나 잘못 저장된 경우입니다. model not found는 해당 공급자에 존재하지 않는 ID입니다. connection refused는 로컬 공급자 서버가 실행 중이지 않거나, apiBase가 잘못된 포트를 가리키는 경우입니다. provider not found는 활성 프리셋에서 공급자 이름을 잘못 입력한 경우입니다.

그런 다음 토큰이 아니라 실제 금액과 대조하세요. v0.3.5에서 nanobot은 각 공급자 호출을 source으로 기록하며, 이는 user, api, cron, dream, system에 대해 검증됩니다. 이 구분은 백그라운드 지출과 입력된 지출을 분리합니다. 그러나 해당 모듈 어디에도 비용 필드는 없습니다. WebUI 차트는 라운드별 입력 토큰과 보고된 경우의 캐시 적중률을 표시하며, 해당 수치가 청구서가 아님을 명시합니다. 2026년 9월 21일에 확인한 CLI 참조에는 총 지출 명령도 없었습니다. 이는 해당 문서에 없다는 뜻이지, 그런 기능이 전혀 없다는 증거는 아닙니다. 비용은 공급자의 원장에서 확인하세요.

어느 경로가 더 유리하며 비용은 얼마인가

두 가지 경계 관련 참고 사항입니다. 이미지 생성은 공급자 값으로 custom을 허용하며 기본적으로 꺼져 있지만, Kunavo의 이미지 엔드포인트가 nanobot이 보내는 요청 형식과 일치하는지는 여기서 테스트하지 않았습니다. 검증되지 않았으므로 기능이라고 볼 수 없습니다. 또한 nanobot의 영구 메모리는 벡터 인덱스가 아니라 작업 공간 아래의 일반 파일이므로, Kunavo가 임베딩 모델을 제공하지 않는다는 점에서 편리합니다.

Kunavo는 nanobot 통합 페이지를 게시하지 않았으며 해당 엔드포인트에서 nanobot을 런타임 테스트하지도 않았습니다. 위의 모든 블록은 nanobot 자체 문서와 제공된 v0.3.5 소스에서 읽은 내용이므로, 호환성 결과가 아니라 시도해 볼 구성 참조로 취급하세요. 작동하는 경로를 하나 유지하고, 제한된 작업을 한 번 실행한 다음 계정에 기록된 내용을 확인하세요. quickstart와 base URL reference는 두 엔드포인트 규칙을 모두 다루며, creating a Kunavo account는 키에 자금을 충전하기 전에 수행하는 단계입니다. 아직 프로그램을 선택 중이라면 nanobot vs OpenClaw에서 런타임을 비교하고, agent API directory에서는 와이어 프로토콜과 BYOK 경계별로 클라이언트를 색인합니다.

자주 묻는 질문

2026년 9월 21일 확인한 출처: HKUDS/nanobot 및 nanobot-ai의 GitHub 및 PyPI API, main 브랜치의 nanobot 공급자·구성·메모리·CLI 문서, 그리고 모든 숫자 기본값을 확인하기 위해 PyPI에서 다운로드한 제공된 v0.3.5 소스입니다. 문서의 설명과 소스의 기본값은 5일 차이가 나며 전체 문서에서 별도로 표시했습니다. Kunavo는 nanobot을 런타임 테스트하지 않았습니다. 토큰 요금은 실시간 카탈로그에서 가져왔고 모든 달러 수치는 명시된 가정을 적용한 예시 계산입니다