title: "Guia RikkaHub: Como configurar o APIYI e entender as diferenças entre /v1 e /v1beta"
description: "Aprenda a configurar o RikkaHub com o serviço proxy de API APIYI, resolvendo problemas de conexão e entendendo as diferenças entre /v1 e /v1beta."
Nota do autor: O RikkaHub é um cliente Android que suporta múltiplos Modelos de Linguagem Grande. Este artigo utiliza o APIYI como exemplo para detalhar os passos completos de conexão com um serviço proxy de API de terceiros, focando na distinção entre os tipos de canal /v1 e /v1beta e como evitar erros comuns.
Ao usar Modelos de Linguagem Grande no celular, você não precisa mais ficar alternando entre os aplicativos do ChatGPT, Gemini e Claude. O RikkaHub é um cliente nativo Android para Modelos de Linguagem Grande que permite acessar todos os modelos principais através de um serviço proxy de API de terceiros. No entanto, muitos usuários encontram um obstáculo na configuração: a mesma chave API funciona perfeitamente no Cherry Studio no computador para todos os modelos, mas no RikkaHub, apenas os modelos do Google funcionam, enquanto GPT e Claude falham.
O problema está no tipo de canal — a diferença entre /v1 e /v1beta. Este artigo usa o APIYI como exemplo para explicar detalhadamente esse ponto de configuração.
Valor principal: Ao terminar este artigo, você saberá como configurar corretamente o serviço proxy de API APIYI no RikkaHub, entenderá a diferença entre /v1 e /v1beta e poderá invocar todos os modelos do Claude, GPT e Gemini em um único aplicativo.
Pontos principais para conectar o RikkaHub ao APIYI
| Ponto | Descrição | Importância |
|---|---|---|
| Seleção do tipo de canal | /v1 para todos os modelos, /v1beta apenas para Gemini | Crucial |
| Base URL | https://vip.apiyi.com/v1 |
Atenção ao caminho final |
| Chave API | Obtida na plataforma APIYI | Uma chave para todos os modelos |
| Seleção de modelo | Insira o nome do modelo manualmente ou selecione da lista | Configure conforme necessário |
| Método de configuração | Crie um provedor separado para cada tipo de canal | Melhor prática |
O que é o RikkaHub?
O RikkaHub é um cliente de chat para Modelos de Linguagem Grande nativo para Android, de código aberto, desenvolvido com Kotlin + Jetpack Compose e utilizando a linguagem de design Material You. Sua maior característica é suportar a conexão com múltiplos provedores de IA em um único aplicativo, permitindo a alternância livre entre modelos durante a conversa.
| Informações básicas | Detalhes |
|---|---|
| Repositório | github.com/rikkahub/rikkahub |
| Versão mais recente | v2.1.7 (28/03/2026) |
| Plataformas suportadas | Android + Web |
| APIs suportadas | Compatível com OpenAI, nativo com Google Gemini, compatível com Anthropic |
| Funcionalidades principais | Alternância entre modelos, entrada multimodal, integração com busca, suporte a MCP |
| Como instalar | Google Play / GitHub Release / Download no site oficial |
Os destaques do RikkaHub incluem:
- Entrada multimodal: Suporte a imagens, arquivos PDF e DOCX
- Ramificação de mensagens: Explore diferentes direções de resposta na conversa
- Integração com busca: Motores de busca integrados como Exa, Tavily, Brave, etc.
- Suporte a MCP: Compatível com o Model Context Protocol
- Renderização Markdown: Destaque de código, fórmulas LaTeX, diagramas Mermaid
- Importação de cartões de personagem: Compatível com cartões de personagem do SillyTavern
Tutorial Completo: Configurando a APIYI no RikkaHub
Passo 1: Obtenha sua chave API da APIYI
Primeiro, obtenha sua chave API na plataforma APIYI:
- Acesse o site da APIYI em apiyi.com e crie sua conta.
- Vá até o painel de controle e crie uma nova chave API.
- Copie e salve a chave (o formato será algo como
sk-xxxxxxxx).
Passo 2: Adicione o Provedor no RikkaHub
Abra o RikkaHub → Configurações → Provedor de IA → Adicionar novo Provedor:
Configuração do canal compatível com OpenAI (recomendado para todos os modelos):
| Item de configuração | Conteúdo a preencher | Observação |
|---|---|---|
| Tipo de Provedor | OpenAI Compatible | Selecione compatível com OpenAI |
| Base URL | https://vip.apiyi.com/v1 |
Atenção: o final deve ser /v1 |
| Chave API | Sua chave APIYI | sk-xxxxxxxx |
| Nome do modelo | Conforme necessário | Ex: claude-sonnet-4-20250514 |
Passo 3: Selecione o modelo e comece a conversar
Após a configuração, basta selecionar o modelo correspondente na interface de chat para começar a usar. Através da interface unificada da APIYI, você pode invocar no RikkaHub:
- Série Claude: claude-sonnet-4, claude-opus-4, etc.
- Série GPT: gpt-5.4, gpt-5.4-mini, etc.
- Série Gemini: gemini-2.5-pro, gemini-2.5-flash, etc.
- Modelos de código aberto: Llama 4, DeepSeek, etc.
🎯 Início rápido: Após obter a chave API em apiyi.com, basta adicionar um Provedor no RikkaHub para alternar livremente entre todos os principais modelos de IA no seu celular.
Detalhes sobre os tipos de canal /v1 e /v1beta: A diferença de configuração mais crítica
Por que alguns modelos não funcionam no RikkaHub com a mesma chave?
Este é o problema mais comum entre os usuários do RikkaHub:
"Por que o mesmo token e API funcionam no Cherry Studio no computador, mas no RikkaHub no Android só funcionam os do Google, e não consigo usar GPT ou Claude?"
Causa raiz: O RikkaHub possui dois tipos de canais; se você escolher o errado, alguns modelos ficarão indisponíveis.
A principal diferença entre /v1 e /v1beta
| Característica | /v1 (Compatível com OpenAI) | /v1beta (Nativo do Gemini) |
|---|---|---|
| Modelos compatíveis | Claude + GPT + Gemini + Código aberto | Apenas série Gemini |
| Formato da API | Formato OpenAI Chat Completions | Formato nativo Google Gemini |
| Exemplo de Base URL | https://vip.apiyi.com/v1 |
https://vip.apiyi.com/v1beta |
| Cenário de uso | Geral, recomendado como primeira opção | Quando precisar de recursos específicos do Gemini |
| Compatibilidade Google | Boa | Melhor |
Vantagens e limitações do /v1beta
/v1beta é o formato de API nativo do Google Gemini. Quando você escolhe o caminho /v1beta, o RikkaHub usa o formato de requisição nativo do Gemini (em vez do formato compatível com OpenAI) para se comunicar com o servidor.
Vantagens:
- Melhor compatibilidade com modelos Gemini.
- Suporte a recursos exclusivos do Gemini (como Grounding e Configurações de Segurança).
- Formato de resposta mais nativo, sem passar por conversão de formato.
Limitações:
- Pode ser usado apenas para modelos da série Gemini.
- Modelos que não são do Google, como Claude e GPT, ficam totalmente indisponíveis.
- Como o formato de requisição é diferente, as solicitações enviadas para Claude/GPT resultarão em erro.
Plano de configuração correto
Opção A: Usar apenas /v1 (recomendado para a maioria dos usuários)
Se você usa principalmente Claude, GPT e Gemini de forma mista, basta criar um Provedor compatível com OpenAI:
Tipo de Provedor: OpenAI Compatible
Base URL: https://vip.apiyi.com/v1
Chave API: sk-your-apiyi-key
Esta configuração permite invocar todos os modelos da APIYI, incluindo o Gemini.
Opção B: Provedor duplo /v1 + /v1beta (usuários avançados)
Se você deseja obter a melhor compatibilidade para modelos Gemini, pode criar dois Provedores:
| Provedor | Tipo | Base URL | Uso |
|---|---|---|---|
| Provedor 1 | OpenAI Compatible | https://vip.apiyi.com/v1 |
Claude / GPT / Modelos abertos |
| Provedor 2 | Gemini | https://vip.apiyi.com/v1beta |
Série Gemini (melhor compatibilidade) |
Ambos os Provedores usam a mesma chave APIYI; durante a conversa, o sistema seleciona automaticamente o Provedor correspondente ao modelo.
💡 Dica para evitar erros: Se você criou apenas um Provedor do tipo
/v1beta, apenas os modelos Gemini funcionarão. É por isso que muitos usuários relatam que "só conseguem usar modelos do Google". A solução é criar outro Provedor do tipo/v1ou usar apenas o/v1como seu único Provedor.
Exemplos de configuração de modelos comuns no RikkaHub
Tabela de configurações de modelos populares no RikkaHub
Aqui estão as configurações de modelos comumente usadas no RikkaHub através da APIYI:
| Modelo | ID do Modelo | Tipo de Canal | Uso Recomendado |
|---|---|---|---|
| Claude Sonnet 4 | claude-sonnet-4-20250514 | /v1 | Conversas diárias, análise |
| Claude Opus 4 | claude-opus-4-20250514 | /v1 | Raciocínio complexo |
| GPT-5.4 | gpt-5.4 | /v1 | Flagship geral |
| GPT-5.4 Mini | gpt-5.4-mini | /v1 | Leve e eficiente |
| Gemini 2.5 Pro | gemini-2.5-pro | /v1 ou /v1beta | Janela de contexto longa |
| Gemini 2.5 Flash | gemini-2.5-flash | /v1 ou /v1beta | Resposta rápida |
| DeepSeek V3 | deepseek-chat | /v1 | Raciocínio com custo-benefício |
| Llama 4 Maverick | meta-llama/llama-4-maverick | /v1 | Topo de linha open-source |
Dicas de configuração avançada do RikkaHub
Cabeçalhos HTTP personalizados: O RikkaHub suporta cabeçalhos de solicitação personalizados, caso você precise passar parâmetros adicionais:
Headers:
X-Custom-Header: seu-valor
Importação/Exportação por QR Code: Você pode gerar um código QR para a configuração do seu provedor, facilitando o compartilhamento com amigos ou a sincronização entre vários dispositivos.
Variáveis de comando: Suporta o uso de variáveis no comando do sistema, como {model} (nome do modelo atual) e {timestamp} (carimbo de data/hora).
🚀 Dica de eficiência: Através da interface unificada da APIYI (apiyi.com), você só precisa de uma chave API para alternar livremente entre todos os modelos principais, como Claude, GPT, Gemini e DeepSeek, dentro do RikkaHub. Com a função de ramificação de conversas do RikkaHub, você pode comparar rapidamente a qualidade das respostas de diferentes modelos.
Comparação do RikkaHub com outros clientes de IA para Android
| Dimensão de comparação | RikkaHub | App ChatGPT | App Gemini | App Claude |
|---|---|---|---|---|
| Suporte a múltiplos modelos | Todos os modelos | Apenas GPT | Apenas Gemini | Apenas Claude |
| API personalizada | Suportado | Não suportado | Não suportado | Não suportado |
| Serviço proxy de API de terceiros | Suportado | Não suportado | Não suportado | Não suportado |
| Open-source | Sim | Não | Não | Não |
| Suporte a MCP | Sim | Não | Não | Não |
| Integração de busca | Múltiplos motores | Busca ChatGPT | Nenhuma | |
| Preço | Gratuito | Assinatura | Assinatura | Assinatura |
A maior vantagem diferencial do RikkaHub é: um único aplicativo para todos os modelos de IA. Com uma plataforma de serviço proxy de API como a APIYI, você não precisa mais pagar separadamente ou instalar um aplicativo para cada provedor de IA.
🎯 Sugestão de escolha: Se você usa apenas uma IA (como apenas o ChatGPT), o aplicativo oficial é mais conveniente. Mas, se você, como a maioria dos desenvolvedores, precisa alternar entre vários modelos, o RikkaHub + APIYI (apiyi.com) é a solução mais flexível no Android.
Solução de problemas comuns na integração do RikkaHub com a APIYI
Erros comuns e soluções
| Sintoma | Causa | Solução |
|---|---|---|
| Apenas o Gemini funciona, outros dão erro | Tipo de canal selecionado como /v1beta | Altere para /v1 ou crie um novo provedor compatível com OpenAI |
| Todos os modelos apresentam erro | URL base preenchida incorretamente | Confirme se é https://vip.apiyi.com/v1 |
| Falha de autenticação | Chave API incorreta ou expirada | Verifique o status da chave no painel da APIYI |
| Modelo inexistente | Erro de digitação no ID do modelo | Consulte a documentação da APIYI para confirmar o ID do modelo |
| Formato de resposta anormal | Incompatibilidade entre o tipo de canal e o modelo | Use /v1beta para Gemini e /v1 para os demais |
Perguntas frequentes
Q1: Devo escolher /v1 ou /v1beta?
Na maioria dos casos, escolha /v1. O /v1 é o formato compatível com OpenAI e suporta todos os modelos (incluindo o Gemini). O /v1beta é o formato nativo do Gemini, que suporta apenas modelos Gemini, mas oferece melhor compatibilidade. Se você usa principalmente Claude e GPT, escolha /v1. Se precisar da melhor experiência com o Gemini, pode criar dois provedores e configurar cada um separadamente. Você pode usar a mesma chave API do site apiyi.com para configurar ambos os canais.
Q2: O que fazer se funciona no Cherry Studio, mas não no RikkaHub?
A causa mais comum é a configuração incorreta do tipo de canal. O Cherry Studio usa o formato compatível com OpenAI (/v1) por padrão. Se você selecionou o tipo Gemini (/v1beta) no RikkaHub, isso impedirá o uso de modelos que não sejam da Google. Solução: crie um novo provedor do tipo "OpenAI Compatible" e preencha a URL base com https://vip.apiyi.com/v1.
Q3: O RikkaHub é gratuito?
O aplicativo RikkaHub em si é gratuito e de código aberto. No entanto, a invocação do modelo de linguagem grande requer custos de API. Ao obter uma chave API na plataforma APIYI (apiyi.com), você paga pelo uso real, sem taxas mensais ou assinaturas. Comparado a assinar o ChatGPT Plus ($20/mês), Claude Pro ($20/mês) e Gemini Advanced ($19,99/mês) simultaneamente, o modelo de pagamento por uso da APIYI + RikkaHub costuma ser muito mais econômico.
Resumo
Pontos principais para integrar o RikkaHub a um serviço proxy de API de terceiros:
- O tipo de canal é fundamental:
/v1é compatível com todos os modelos (Claude/GPT/Gemini/Open Source), enquanto o/v1betaé exclusivo para o Gemini, oferecendo melhor compatibilidade com os modelos do Google. - Recomendação de configuração com dois provedores: Utilize o
/v1como canal geral e o/v1betacomo canal dedicado ao Gemini, usando a mesma chave API da APIYI. - Um único app para tudo: Com o RikkaHub e a APIYI (apiyi.com), você consegue alternar livremente entre Claude, GPT, Gemini e outros modelos diretamente no Android.
Chega de ficar alternando entre três ou quatro aplicativos de IA. Recomendamos obter sua chave API através da APIYI (apiyi.com); uma única chave cobre todos os principais modelos, permitindo que você transforme seu celular em um assistente de IA completo com o RikkaHub.
📚 Referências
-
Repositório GitHub do RikkaHub: Código aberto e download das versões mais recentes
- Link:
github.com/rikkahub/rikkahub - Descrição: Contém o código-fonte completo, downloads de lançamentos e explicações de funcionalidades.
- Link:
-
Documentação oficial do RikkaHub: Guia de configuração e uso de provedores
- Link:
docs.rikka-ai.com - Descrição: Contém métodos detalhados de configuração para diversos provedores.
- Link:
-
Central de Documentação da APIYI: Obtenção de chave API e lista de modelos
- Link:
docs.apiyi.com - Descrição: Contém os IDs de todos os modelos suportados, preços e exemplos de invocação do modelo.
- Link:
Autor: Equipe Técnica APIYI
Troca de experiências: Sinta-se à vontade para compartilhar sua experiência de configuração do RikkaHub nos comentários. Para mais materiais sobre a integração de Modelos de Linguagem Grande, visite a central de documentação da APIYI em docs.apiyi.com.
