
자료
도구
로컬 AI 이미지/영상용 ThAPI Studio와 API 연결용 API CLI.
데스크톱 앱
ThAPI Studio — AI 이미지 & 영상
API 키 입력, 지갑 차감, 결과물을 로컬로 저장하는 올인원 앱.


설치
API CLI & thapi-router 다운로드
원라이너와 npm 링크. thapi-router는 레거시 별칭이며 API CLI로 연결됩니다.
curl -fsSL https://thapi.cloud/install/api-cli.sh | bashirm https://thapi.cloud/install/api-cli.ps1 | iexAPI CLI
Claude Code, Codex, OpenClaw, Cline용 공식 CLI. Node.js ≥ 18.
npm install -g api-cli@latest
thapi-router
레거시 설치기(StaliRouter / 9Router). 계속 동작하며 API CLI로 이동합니다.
API CLI를 권장합니다. 아래 router 링크는 이전 명령 호환용입니다.
# macOS / Linux curl -fsSL https://thapi.cloud/install/stalirouter.sh | bash # Windows PowerShell irm https://thapi.cloud/install/stalirouter.ps1 | iex
API CLI
Claude Code, Cursor, OpenClaw 등 연결을 위한 CLI 설치 가이드.
Còn gọi: wizard · api-cli doctor · api-cli
API CLI: 설정 도구를 설치하고 앱 연결을 확인합니다.
Hướng dẫn đã xuất bản · Phiên bản ứng dụng: chưa xác minh
Ví dụ chat, ping, invoke hoặc tạo nội dung có thể gửi yêu cầu thật và phát sinh phí. Kiểm tra model, số dư, đơn giá và mức tối thiểu trước khi chạy; GET /v1/models chỉ kiểm tra xác thực và danh mục. Đặt biến môi trường an toàn
URL gốc phải dán
SDK OpenAI thường dùng URL kết thúc bằng /v1; SDK Anthropic dùng URL gốc. Tránh thêm /v1 hai lần. Giao thức tương thích không bảo đảm mọi tính năng của nhà cung cấp.
Xem ghi chú / theo protocolApp này có ngoại lệ — đọc mục Ghi chú bên dưới trước khi dán.
Chuẩn bị
- Node.js ≥ 18 (LTS 권장)
- Dashboard → Keys에서 발급한 sk-thapi-… 형식의 API 키
- 홈 디렉터리 쓰기 권한 (~/.thapi 생성 및 앱 설정 수정에 필요)
Model khuyến nghị: claude-fable-5
Cách nhanh — lệnh / cấu hình
# 권장 — Win / macOS / Linux에서 동일
npm install -g API CLI@latest
# 마법사 열기 — 요청 시 API 키 붙여 넣기
api-cli
# 또는 특정 앱 설정
api-cli configure claude -m claude-fable-5
api-cli configure codex -m gpt-5.6-sol
api-cli configure openclaw
api-cli configure clineBỏ file / điền Settings ở đâu
API CLI가 생성한 파일 (chmod 0600). 저장된 API 키와 base URL을 포함합니다. 이 파일을 Git에 커밋하지 마세요.
macOS와 같습니다. 확인: ls -la ~/.thapi/config.json
PowerShell: notepad $env:USERPROFILE\.thapi\config.json 설정을 정확히 이해한 경우에만 수정 — api-cli auth login / api-cli -k '…' 권장.
Kiểm tra đã chạy đúng
- `api-cli doctor`를 실행하세요. 설치된 도구가 ThAPI를 가리키는 것으로 표시되어야 합니다.
- Dashboard → 사용량을 여세요. 테스트 채팅 명령을 실행하면 차감 내역이 표시되어야 합니다.
- `api-cli info`로 현재 사용 중인 base URL을 확인합니다.
Khắc phục sự cố
| Triệu chứng | Nguyên nhân | Cách xử lý |
|---|---|---|
| npm install -g에서 EACCES / 권한 오류 발생 | 전역 npm prefix에 쓸 권한이 없습니다. | nvm/fnm을 사용하거나 사용자 단위 npm prefix를 설정하세요. 위험을 이해하지 못했다면 sudo는 피하세요. |
| doctor가 도구가 설정되지 않았다고 보고함 | 앱이 설치되지 않았거나 이전 설정이 아직 수정되지 않았습니다. | `api-cli configure <tool> -k '…'` 또는 `api-cli doctor --fix`. |
Ghi chú
- Base URL Anthropic: https://thapi.cloud — OpenAI: https://thapi.cloud/v1. API CLI tự chọn theo từng tool.
- Repo: https://thapi.cloud