Naia를 앱 안에서만 쓰지 않고, 독립적인 작업공간에서도 같은 계정의 AI 자원을 사용할 수 있게 했습니다. naia-adk를 Git으로 받은 뒤 NAIA_KEY 하나만 설정하면 됩니다.
이번 작업은 866쪽 분량의 구입한 영문 기술서를 한국어로 읽고 싶다는 필요에서 시작했습니다. 한 번 쓰고 버리는 번역 명령 대신, 다음 문서에도 다시 쓸 수 있는 스킬로 만들었습니다. 모델 목록과 가격을 먼저 확인하고, 긴 작업은 중단 지점부터 재개하며, 완료 뒤에는 사용 모델·토큰·파일 해시를 영수증으로 남깁니다.
시작하기
git clone https://github.com/nextain/naia-adk.git
cd naia-adk
$env:NAIA_KEY = "gw-..."
키는 Naia 계정 대시보드의 API 키 메뉴에서 발급합니다. 키 값은 저장소나 설정 문서에 넣지 않고 환경변수나 운영체제의 자격 증명 관리자에 보관합니다. naia-settings/llm.json에는 키 값이 아니라 apiKeyRef: "NAIA_KEY"만 둡니다. 개인 포크에서 백업할 때는 data-private/key/의 암호화 볼트를 사용하며, 개발 서비스용 .env.local에는 계정 키를 넣지 않습니다.
naia-adk의 기본 모델 공급자는 이제 naia입니다. 기존 naia-settings/config.json에서 선택한 Naia 모델이 있으면 그대로 사용하고, NAIA_MODEL이나 명령행 --model로 작업별 모델을 바꿀 수도 있습니다.
지원 모델과 가격은 API로 확인합니다
Naia가 지원하는 모델과 현재 가격은 고정된 문서 목록이 아니라 운영 API가 기준입니다.
python .agents/skills/translate-doc/scripts/naia_translate.py models
python .agents/skills/translate-doc/scripts/naia_translate.py pricing
python .agents/skills/translate-doc/scripts/naia_translate.py check
모델·가격 목록은 키 없이 볼 수 있습니다. check는 키를 노출하거나 유료 추론을 실행하지 않고 키 유효성과 잔액을 확인합니다. 2026년 8월 3일 확인한 목록에는 Azure를 통해 제공되는 deepseek-v4-flash, deepseek-v4-pro, gpt-5.6-luna, gpt-5.6-sol, grok-4.3 등이 포함되어 있습니다. 모델 상태와 가격은 바뀔 수 있으므로 실제 작업 직전에 다시 확인하는 편이 안전합니다.
긴 문서는 예상 비용부터 확인합니다
python .agents/skills/translate-doc/scripts/naia_translate.py estimate book.pdf --model deepseek-v4-flash
이번 866쪽, 약 188만 글자 문서는 운영 가격 기준으로 입력 약 58만 토큰, 출력 약 67만 토큰, 약 **501크레딧($0.50 상당)**으로 추정됐습니다. 이 값은 글자 수 기반 예상치이므로 실제 토크나이저와 한국어 결과 길이에 따라 달라집니다.
python .agents/skills/translate-doc/scripts/naia_translate.py translate book.pdf --output-dir tmp/book-ko --model deepseek-v4-flash --concurrency 4
python .agents/skills/translate-doc/scripts/naia_translate.py verify --output-dir tmp/book-ko
결과 폴더에는 한국어 Markdown·HTML·PDF와 함께 manifest.json, receipt.json, verification.json이 생깁니다. 도중에 네트워크가 끊겨도 같은 명령을 다시 실행하면 검증이 끝난 번역 단위는 재사용합니다.
구입한 책이나 회사 문서는 개인용·승인된 범위에서만 번역하고 tmp/ 같은 비공개 경로에 둡니다. 원문과 번역 전문을 공개 저장소나 블로그에 싣지 않는 것도 스킬의 기본 규칙입니다.
무료 제공과 가격 기준
2026년 8월 3일 현재 Free 계정은 가입할 때 200크레딧을 한 번 받고, 이후 30일마다 잔액이 100보다 적으면 최대 100까지 보충됩니다. Basic은 월 $10에 10,000크레딧, Pro는 월 $30에 30,000크레딧입니다.
일회성 충전은 $10/10,000, $30/30,300, $60/61,200, $100/103,000크레딧입니다. 기본 환산은 $1당 1,000크레딧이며, 실제 차감은 선택한 모델의 입력·출력 토큰 가격을 따릅니다. Free 제공량만으로도 짧은 문서나 기능 시험은 가능하지만, 이번 책 전체 예상치 501크레딧처럼 긴 작업은 잔액 확인이 필요합니다.
가격과 무료 정책은 변경될 수 있습니다. 최신 값은 결제 화면과 GET https://api.nextain.io/v1/pricing 응답을 우선해 확인해 주세요. 자세한 명령과 보안 주의사항은 Naia 계정 사용설명서에 정리했습니다.
한 번의 작업을 작업공간의 능력으로 남기기
이번 기능에서 중요하게 본 것은 “이 책 한 권을 번역했다”는 결과만이 아닙니다. 같은 계정과 같은 검증 절차로 다음 PDF, 보고서, 연구자료도 처리할 수 있도록 작업 방법을 저장소의 스킬로 남겼습니다.
하네스 엔지니어링에서 말하는 좋은 작업공간은 모델에게 명령만 전달하지 않습니다. 비용을 먼저 보여주고, 비밀키와 저작물을 보호하고, 실패 뒤 재개하며, 마지막 결과가 빠짐없이 만들어졌는지 증거로 확인합니다. Naia 키를 naia-adk에 연결한 것도 그런 실행 환경을 한 단계 더 완성하기 위한 작업입니다.
