메인 콘텐츠로 건너뛰기
모델은 Ollama, llama.cpp, vLLM 또는 LM Studio가 실행되는 머신에 그대로 유지됩니다. 휴대전화에서 이를 액세스하려면 커스텀 OpenAI 호환 엔드포인트를 지원하는 채팅 앱을 설치하고, https://api.tokios.com/v1 API 키와 함께 sk-tok-…로 연결합니다. VPN, 포트 포워딩, 홈 네트워크 노출 없이도 가능합니다. 이 페이지는 OpenAI 호환 인터페이스만 다룹니다. 일부 모바일 채팅 앱은 설정 가능한 Anthropic 기본 URL을 제공하지 않으므로, 이를 지원하는 앱을 찾을 때까지 ANTHROPIC_BASE_URL은 데스크톱/CLI 기능으로 간주하십시오(자세한 내용은 Claude Code 사용 참조).

​
모든 설정을 망치는 유일한 함정: /v1 포함 여부

모바일 앱들은 기본 URL 필드에 /v1 접미사를 포함해야 하는지에 대해 의견이 다릅니다:
  • 다음 앱은 /v1을 포함해야 합니다: Maid, Open WebUI, LibreChat. https://api.tokios.com/v1을 사용하십시오.
  • 호스트만 필요하고 경로를 자체적으로 추가하는 앱: Chatbox. https://api.tokios.com을 사용하십시오(제외된 /v1).
이 설정을 잘못하면 요청이 404 오류가 발생하거나 앱에서 전혀 전송되지 않습니다. 필드의 플레이스홀더 텍스트를 확인하십시오 — 기본값이 /v1로 끝나는 경우(예: https://api.openai.com/v1)에는 /v1을 포함하십시오. 필드가 단순히 API Host로 표시된 경우 마지막 /v1은 제외하십시오.

​
사용하지 말아야 할 앱

  • iOS용 Chatbox — 사용하지 마십시오. 확인된 미해결 버그(chatboxai/chatbox#3516)로 인해 iOS에서 Bearer 키 인증을 사용하는 커스텀 OpenAI 호환 엔드포인트가 실패합니다: 프록시가 아닌 요청은 CORS를 강제하는 WKWebView fetch()를 통해 전송되며, Authorization 헤더는 Tokios(대부분의 로컬 서버와 동일하게)가 앱이 기대하는 방식으로 응답하지 않는 사전 검사 OPTIONS 요청을 트리거합니다. Android용 Chatbox에는 이 버그가 없습니다 — 아래 참조.
  • Reins 및 Enchanted — 사용하지 마십시오. 두 앱 모두 Ollama 네이티브 API(/api/chat, /api/generate)만 지원합니다. Tokios는 OpenAI 호환(/v1/chat/completions) 및 Anthropic 호환(/v1/messages) 인터페이스를 노출하지만, 원시 Ollama API는 노출하지 않으므로, 향후 릴리스에서 OpenAI 호환 모드가 추가되지 않는 한 이 앱들은 연결할 수 없습니다.
아래 세 앱 모두 커스텀 엔드포인트와 Bearer API 키를 받습니다. 이 앱들은 Tokios 전용이 아니므로, 앱 버전 간에 라벨이 변경될 수 있으므로 앱 내 정확한 필드 라벨을 확인한 후 사용하십시오.

​
Pal Chat

커스텀 OpenAI 호환 엔드포인트 및 자체 키 제공자를 지원합니다.

​
Apollo (Liquid AI)

OpenAI 호환 형식을 사용하는 로컬 또는 커스텀 AI 서버에 연결하며, 커스텀 백엔드에 대한 모델 식별자를 지정할 수 있습니다.

​
3sparks Chat

OpenAI 호환 API, 로컬 및 온라인과 호환된다고 설명합니다. 정확한 필드 라벨은 확인되지 않았습니다.
iOS에서 Chatbox는 사용하지 마십시오 — 위의 사용하지 말아야 할 앱 참조.

​
고급 옵션: 호스팅된 웹 UI 실행 및 PWA로 설치

전용 네이티브 앱 대신 더 풍부한 채팅 인터페이스(채팅 기록, 여러 배포, 시스템 프롬프트)가 필요하다면, 서버에 Open WebUI 또는 LibreChat을 호스팅하고, OpenAI 호환 연결을 Tokios로 연결한 후, 휴대전화에 프로그레시브 웹 앱(PWA)으로 설치하십시오:
1

서버에서 Tokios 구성

Open WebUI에서: Admin → Settings → Connections → OpenAI API. 다음을 설정하십시오:LibreChat의 동등한 설정은 서버 측의 OpenAI 호환 커스텀 엔드포인트 구성입니다.
2

휴대전화에 PWA 설치

휴대전화 브라우저에서 호스팅된 인스턴스의 URL을 연 후:
  • iOS (Safari 전용): Share → Add to Home Screen를 탭하십시오.
  • Android (Chrome, Firefox, Brave, Edge): 브라우저 메뉴 → Install app / Add to Home Screen.
Tokios 구성은 서버에만 있습니다 — 휴대전화는 API 키를 직접 보유하지 않으며, 호스팅된 Open WebUI 또는 LibreChat 인스턴스에 대해 설치된 PWA를 열기만 합니다.

​
다음 단계

빠른 시작

제로에서 작동하는 커넥터, 배포 및 API 키로 이동합니다.

로컬 모델에 API 키 추가

모바일 앱에 키를 제공하기 전에 키를 특정 배포에 스코프합니다.