---
title: "RikkaHub QR 코드 가져오기"
description: "Android RikkaHub에서 QR 코드로 OpenAI 호환 제공자를 가져오고, 모델을 구성하며 문제를 해결합니다."
headingIds: {"QR 코드 구성":"section-1","수동 대체":"section-2","문제 해결":"section-3"}
---

<aside className="docs-publication" data-pagefind-ignore>

[1ZheAI](https://1zheai.com/en/editorial/#publisher)가 관리하는 문서입니다. [출처 및 수정 사항](https://1zheai.com/en/editorial/).

오류를 발견하셨나요? 페이지 주소와 설명을 첨부하여 [고객 지원](mailto:support@1zheai.com)으로 문의해 주세요. API 키나 계정 정보는 보내지 마세요.

</aside>
RikkaHub는 Android AI 클라이언트입니다. 이 사이트는 `ai-provider:v1:` 공유 형식을 사용하여 로컬 QR 코드를 생성하며, 제3자 QR 코드 웹사이트를 호출하지 않습니다.

## QR 코드 구성

1. 콘솔에서 **API 키 → 도구 사용 → RikkaHub**로 이동합니다.
2. 비공개 환경에서 **가져오기 QR 코드 표시**를 클릭합니다. QR 코드는 전체 키와 동일하므로 스크린샷을 공유하면 안 됩니다.
3. RikkaHub에서 **설정 → 제공자 설정 → 가져오기**에서 QR 코드 스캔을 선택합니다. 양쪽이 같은 휴대폰에 있는 경우 클라이언트의 이미지에서 가져오기 기능을 사용하고, 가져온 후 키가 포함된 스크린샷을 삭제합니다.
4. 가져온 후 모델 목록을 가져오고, 채팅 모델을 선택하며, 짧은 메시지를 보낸 다음 이 사이트의 호출 로그에서 확인합니다.
5. 완료 후 QR 코드를 숨깁니다. 실수로 다른 사람에게 전송한 경우 해당 키를 폐기하고 새로 생성합니다.

## 수동 대체

| 필드 | 값 |
| --- | --- |
| 유형 | OpenAI |
| Base URL | `https://1zheai.com/v1` |
| Chat Completions Path | `/chat/completions` |
| API Key | 현재 키 |

가져오기는 모델 능력이나 컨텍스트 길이를 사전 설정하지 않으며, Responses 스위치도 활성화하지 않습니다. Responses가 필요한 경우 선택한 모델과 클라이언트 버전을 먼저 확인한 다음 별도로 검증합니다.

## 문제 해결

QR 코드 스캔이 실패하면 QR 코드가 완전한지, 화면이 선명한지, 클라이언트 버전을 먼저 확인합니다. 그래도 안 되면 수동 필드를 사용합니다. 모델 목록 가져오기가 실패하면 키와 주소를 확인합니다. 권한 부족은 QR 코드를 다시 스캔하는 것으로 해결할 수 없습니다.

공식 문서: [빠른 시작](https://github.com/rikkahub/docs/blob/main/quickstart.mdx), [공유 형식 구현](https://github.com/rikkahub/rikkahub/blob/master/app/src/main/java/me/rerere/rikkahub/ui/components/ui/ShareSheet.kt).

<Note> 프로토콜 및 공식 자료와 대조 확인일: 2026-10-19. 이 사이트는 구성 생성 및 프런트엔드 회귀 테스트를 구현했습니다. 모든 클라이언트, 시스템 및 모델에 대한 실제 추론 검증은 완료되지 않았습니다. 클라이언트 업그레이드 후 다시 검증하십시오. 사용자 지정 연결은 공식 협력이나 내장 추천을 의미하지 않습니다. </Note>

더 보기: [API 키](/ko/docs/api-keys/), [모델 목록](/ko/docs/models/), [호출 로그](/ko/docs/usage-logs/), [주소 설명](/ko/docs/base-url/).
