---
title: "Importação por QR Code no RikkaHub"
description: "Importe provedores compatíveis com OpenAI por QR Code no RikkaHub para Android, configure modelos e resolva problemas."
headingIds: {"Configuração por QR Code":"section-1","Alternativa manual":"section-2","Resolução de problemas":"section-3"}
---

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

Documentação mantida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fontes e correções](https://1zheai.com/en/editorial/).

Encontrou um erro? [Contate o suporte](mailto:support@1zheai.com) com o endereço da página e uma descrição. Não envie chaves de API ou credenciais de conta.

</aside>
RikkaHub é um cliente de IA para Android. Este site usa seu formato de compartilhamento `ai-provider:v1:` para gerar um QR Code local, sem chamar sites de QR Code de terceiros.

## Configuração por QR Code

1. No console, **Chave da API → Ferramentas → RikkaHub**.
2. Em um ambiente privado, clique em **Exibir QR Code de importação**. O QR Code equivale à chave completa e não pode ser compartilhado por captura de tela.
3. No RikkaHub, em **Configurações → Configurações de provedor → Importar**, escolha a leitura por QR Code. Se os dois lados estiverem no mesmo celular, use a função de importar a imagem do cliente e, após a importação, exclua a captura de tela que contém a chave.
4. Após importar, obtenha a lista de modelos, selecione o modelo de chat, envie uma mensagem curta e confirme no registro de chamadas deste site.
5. Ao concluir, oculte o QR Code. Se enviá-lo por engano a outra pessoa, revogue essa chave e crie outra.

## Alternativa manual

| Campo | Valor |
| --- | --- |
| Tipo | OpenAI |
| Base URL | `https://1zheai.com/v1` |
| Caminho de Chat Completions | `/chat/completions` |
| Chave da API | chave atual |

A importação não pré-configura capacidades de modelos nem tamanho de contexto, e não ativa a opção de Responses. Quando precisar de Responses, verifique primeiro o modelo selecionado e a versão do cliente e valide separadamente.

## Resolução de problemas

Se a leitura por QR Code falhar, verifique primeiro se o QR Code está completo, a tela está nítida e a versão do cliente; se ainda falhar, use os campos manuais. Se a lista de modelos falhar, confira a chave e o endereço; permissões insuficientes não podem ser resolvidas lendo o QR Code novamente.

Oficial: [Início rápido](https://github.com/rikkahub/docs/blob/main/quickstart.mdx), [Implementação do formato de compartilhamento](https://github.com/rikkahub/rikkahub/blob/master/app/src/main/java/me/rerere/rikkahub/ui/components/ui/ShareSheet.kt).

<Note> verificado com o protocolo e materiais oficiais em 2026-10-19. Este site já implementou a geração de configuração e testes de regressão no frontend; não concluiu a verificação de inferência real em todos os clientes, sistemas e modelos. Após atualizar o cliente, verifique novamente. A integração personalizada não representa parceria oficial nem recomendação embutida.</Note>

Mais: [Chave da API](/pt/docs/api-keys/), [Lista de modelos](/pt/docs/models/), [Registro de chamadas](/pt/docs/usage-logs/), [Explicação do endereço](/pt/docs/base-url/).