---
title: RikkaHub 扫码导入
description: 在 Android RikkaHub 扫码导入 OpenAI 兼容供应商，配置模型并排错。
---

<aside className="docs-publication" data-pagefind-ignore>文档由 <a href="https://1zheai.com/editorial/#publisher">1折AI</a> 维护。<a href="https://1zheai.com/editorial/">来源、商业关系与纠错说明</a>。发现错误，请向 <a href="mailto:support@1zheai.com">support@1zheai.com</a> 提供页面地址与可核查依据，不要发送密钥或账号资料。</aside>

RikkaHub 是 Android AI 客户端。本站使用其 `ai-provider:v1:` 分享格式生成本地二维码，不调用第三方二维码网站。

## 扫码配置

1. 控制台 **API 密钥 → 使用工具 → RikkaHub**。
2. 在私密环境点 **显示导入二维码**。二维码相当于完整密钥，不能分享截图。
3. 在 RikkaHub **设置 → 供应商设置 → 导入**选择扫码。若两端在同一手机上，使用客户端的从图片导入功能，并在导入后删除含密钥的截图。
4. 导入后获取模型列表，选择聊天模型，发送简短消息，再到本站调用日志确认。
5. 完成后隐藏二维码。误发给他人时撤销该密钥并重新创建。

## 手动备用

| 字段 | 值 |
| --- | --- |
| 类型 | OpenAI |
| Base URL | `https://1zheai.com/v1` |
| Chat Completions Path | `/chat/completions` |
| API Key | 当前密钥 |

导入不预置模型能力或上下文长度，也不启用 Responses 开关。需要 Responses 时先核对所选模型及客户端版本再单独验证。

## 排错

扫码失败先核对二维码完整、屏幕清晰、客户端版本；仍不行使用手动字段。模型列表失败时检查密钥与地址，权限不足不能通过重新扫码解决。

官方：[快速开始](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 密钥](/docs/api-keys/)、[模型列表](/docs/models/)、[调用日志](/docs/usage-logs/)、[地址说明](/docs/base-url/)。