Naia 계정 — Naia 사용법

Naia 계정 하나로 Naia 앱과 외부 도구에서 같은 AI 자원을 사용할 수 있습니다. 계정의 크레딧은 선택한 모델의 실제 사용량에 따라 차감됩니다.

계정 관리는 naia.nextain.io에서 합니다.

대시보드에서 할 수 있는 일

현재 크레딧 잔액과 기간별 사용량 확인
모델·토큰·비용별 호출 기록 확인
Naia API 키 생성·폐기
크레딧 충전과 구독 관리
Discord 등 지원 채널 연결

Naia API 키 발급

naia.nextain.io에 로그인합니다.
API 키 메뉴에서 알아보기 쉬운 이름을 입력하고 키를 생성합니다.
gw-로 시작하는 키를 안전한 암호 관리자에 보관합니다. 생성 직후에만 전체 값이 보일 수 있습니다.
더 이상 쓰지 않는 키는 같은 화면에서 폐기합니다.

API 키는 비밀번호와 같습니다. Git 저장소, YAML·Markdown 문서, 채팅, 스크린샷에 값을 넣지 마세요.

naia-adk에서 사용

naia-adk를 받은 뒤 키를 환경변수로 설정하면, 기본 모델 설정과 문서 번역 스킬이 Naia 계정 크레딧을 사용합니다.

git clone https://github.com/nextain/naia-adk.git
cd naia-adk
$env:NAIA_KEY = "gw-..."

macOS·Linux:

export NAIA_KEY="gw-..."

NAIA_KEY가 정식 이름입니다. NAIA_API_KEY, NAIA_ANYLLM_API_KEY는 이전 설정을 위한 호환 이름으로만 읽습니다. NAIA_PROD_KEY, NAIA_DEV_KEY는 개발자가 개인 포크에서 사용하던 이름이며 공개 사용 계약이 아닙니다.

실제 키 값은 운영체제의 자격 증명 관리자나 보호된 셸 환경에 보관하세요. naia-settings/llm.json에는 모델·API 주소와 apiKeyRef: "NAIA_KEY"만 기록하고 키 값은 넣지 않습니다. 개인 ADK 포크에서 별도 백업이 필요하면 data-private/key/를 기존 key.age 암호화 볼트로 관리합니다. .env.local은 개발 서비스 설정용이므로 Naia 계정 키를 저장하지 않습니다. 번역 명령도 이 파일을 자동으로 읽지 않습니다.

기본 API 주소는 https://api.nextain.io/v1입니다.

모델을 고정하려면 NAIA_MODEL을 설정하거나 naia-settings/config.json의 기존 Naia 모델 설정을 사용합니다. 명령행에서 지정한 모델이 있으면 그 값이 가장 우선합니다.

지원 모델과 가격 조회

모델 목록과 가격표는 공개 상품 정보이므로 API 키 없이도 조회할 수 있습니다.

curl https://api.nextain.io/v1/models
curl https://api.nextain.io/v1/pricing

naia-adk에서는 보기 좋게 다음 명령을 사용할 수 있습니다.

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는 유료 모델을 호출하지 않고 키 유효성과 잔액을 확인합니다. 지원 모델과 가격은 바뀔 수 있으므로 큰 작업 직전에 다시 조회하세요. /v1/pricing 값은 Naia에서 실제 차감할 가격이며, 별도의 가산율을 다시 곱하지 않습니다.

문서 번역

translate-doc 스킬은 PDF·텍스트·Markdown을 작은 단위로 나누어 번역합니다. 중단된 작업을 재개하고, 모델·토큰·입출력 해시와 가격 스냅샷을 영수증으로 남깁니다.

python .agents/skills/translate-doc/scripts/naia_translate.py estimate book.pdf --model deepseek-v4-flash
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

구매한 책이나 비공개 문서는 tmp/처럼 Git에서 제외된 개인 경로에 두세요. 번역 권한은 사용자가 확인해야 하며, 번역본을 공개 저장소나 블로그에 올려서는 안 됩니다.

동시 요청 수는 기본 4개이며 --concurrency로 1~16 사이에서 조정할 수 있습니다. 큰 값을 쓰면 게이트웨이 대기열이 포화되어 모델·가격·잔액 조회까지 느려질 수 있습니다. 429 제한 응답이나 장시간 정체가 나타나면 값을 낮추고 같은 출력 폴더로 다시 실행하세요.

무료 제공과 요금 기준

2026년 8월 3일 현재 서비스 계약 기준입니다. 결제 화면과 운영 API의 최신 표시가 우선합니다.

구분	가격	제공 크레딧
Free 가입 보너스	무료	최초 1회 200
Free 월간 보충	무료	30일마다, 잔액이 100 미만일 때 최대 100까지 보충
Basic	월 $10	월 10,000
Pro	월 $30	월 30,000

크레딧은 기본적으로 미화 $1당 1,000을 기준으로 합니다. 일회성 충전 상품은 다음과 같습니다.

결제액	지급 크레딧	보너스
$10	10,000	없음
$30	30,300	1%
$60	61,200	2%
$100	103,000	3%

모델마다 입력·출력 토큰 단가가 다릅니다. 따라서 같은 문서도 모델, 입력 길이, 번역 결과 길이에 따라 차감량이 달라집니다. 시작 전 estimate, 완료 후 receipt.json과 대시보드 사용 기록을 함께 확인하세요.

문제 해결

401/403: 키가 잘못되었거나 폐기되었는지 확인하고 check를 실행합니다.
잔액 부족: 대시보드에서 잔액을 확인하고 모델을 더 저렴한 모델로 바꾸거나 충전합니다.
가격 없음: 가격이 확인되지 않은 모델은 큰 작업에 사용하지 마세요.
429/5xx: 스킬이 제한적으로 재시도합니다. 같은 출력 폴더로 다시 실행하면 완료된 번역 단위를 재사용합니다.

19. Naia 계정