---
title: "RikkaHub QR Code Import"
description: "Import an OpenAI-compatible provider into Android RikkaHub via QR code, configure models, and troubleshoot."
headingIds: {"QR Code Configuration":"section-1","Manual Fallback":"section-2","Troubleshooting":"section-3"}
---

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

Documentation maintained by [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Sources and corrections](https://1zheai.com/en/editorial/).

Found an error? [Contact support](mailto:support@1zheai.com) with the page address and a description. Do not send API keys or account credentials.

</aside>
RikkaHub is an Android AI client. This site uses its `ai-provider:v1:` share format to generate a local QR code, without calling any third-party QR code website.

## QR Code Configuration

1. In the console, go to **API Keys → Tools → RikkaHub**.
2. In a private environment, tap **Show Import QR Code**. The QR code is equivalent to the full key; do not share screenshots of it.
3. In RikkaHub, go to **Settings → Provider Settings → Import** and choose QR code scanning. If both ends are on the same phone, use the client's import-from-image feature, and delete the screenshot containing the key after importing.
4. After importing, fetch the model list, select a chat model, send a short message, then confirm on this site's call log.
5. When done, hide the QR code. If it was accidentally sent to someone else, revoke that key and create a new one.

## Manual Fallback

| Field | Value |
| --- | --- |
| Type | OpenAI |
| Base URL | `https://1zheai.com/v1` |
| Chat Completions Path | `/chat/completions` |
| API Key | Current key |

Import does not pre-configure model capabilities or context length, nor does it enable the Responses toggle. If you need Responses, first verify the selected model and client version, then validate separately.

## Troubleshooting

If QR code scanning fails, first check that the QR code is complete, the screen is clear, and the client version is correct; if it still fails, use the manual fields. If the model list fails, check the key and address; insufficient permissions cannot be resolved by rescanning the QR code.

Official: [Quick Start ](https://github.com/rikkahub/docs/blob/main/quickstart.mdx), [Share Format Implementation ](https://github.com/rikkahub/rikkahub/blob/master/app/src/main/java/me/rerere/rikkahub/ui/components/ui/ShareSheet.kt).

<Note> protocol and official materials verified on 2026-10-19. This site has implemented configuration generation and frontend regression testing; real inference verification across all clients, systems, and models has not been completed. Please re-verify after client upgrades. Custom integration does not imply official partnership or built-in recommendation. </Note>

More: [API Keys ](/en/docs/api-keys/), [Model List ](/en/docs/models/), [Call Log ](/en/docs/usage-logs/), [Address Notes ](/en/docs/base-url/).