---
title: "Integração com o Cherry Studio"
description: "Adicione a 1折AI como um provedor personalizado no Cherry Studio escolhendo o endpoint Anthropic ou OpenAI e inserindo a URL base, a chave da API e os modelos."
headingIds: {"Importação em um clique":"section-1","Configuração":"section-2","Escolhendo o endpoint Anthropic ou OpenAI":"section-3","Perguntas frequentes":"section-4"}
---

<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>
O Cherry Studio é um cliente de chat de IA para desktop onde você pode adicionar a 1折AI como um provedor personalizado.

## Importação em um clique

No console, em **Chaves da API → Ferramentas → Cherry Studio**, selecione o protocolo Anthropic ou OpenAI e clique em **Abrir Cherry Studio**. Após confirmar a importação no aplicativo, busque os modelos, ative o provedor e faça um teste. Se já existir uma configuração com o mesmo nome, verifique o aviso de substituição. O link de importação contém a chave completa — não o encaminhe.

O navegador não pode confirmar se o aplicativo está instalado. Se ele não abrir, instale e inicie o cliente uma vez primeiro, ou use as etapas manuais abaixo. O formato do protocolo foi verificado em relação à implementação oficial, mas a inferência real ainda precisa ser verificada em relação à sua versão e modelo específicos.

## Configuração

<Steps>
<Step title="Adicionar provedor">

Configurações (ícone de engrenagem) → **Serviços de modelo** → **+ Adicionar provedor** na parte inferior da lista.

</Step>
<Step title="Preencher informações">

| Campo | O que inserir |
|---|---|
| Nome do provedor | `1折AI` |
| Chave da API | `sk-你的Key` |
| Endpoint | Selecione **Anthropic** (recomendado) ou **OpenAI** |
| Endereço da API | `https://1zheai.com` |

Insira apenas a URL base no campo Endereço da API; o Cherry Studio anexará automaticamente `/v1/...` com base no protocolo selecionado. Não cole caminhos completos como `/v1/messages` ou `/v1/chat/completions`, e não adicione `#` no final (um `#` final significa que nenhum caminho será anexado automaticamente).

</Step>
<Step title="Adicionar modelo">

Clique em **Obter lista de modelos** e adicione os modelos que deseja usar da lista retornada; ou clique em **+** para inserir manualmente um ID de modelo, como `claude-sonnet-5-5`. Apenas os modelos adicionados à lista aparecerão no seletor de modelos no chat.

</Step>
<Step title="Ativar e testar">

Ative a chave de ativação no canto superior direito da página do provedor, volte para a interface de chat e envie uma mensagem usando um modelo sob a 1折AI.

</Step>
</Steps>

## Escolhendo o endpoint Anthropic ou OpenAI

| Endpoint | Melhor para |
|---|---|
| Anthropic | Usar capacidades nativas do Claude, como pensamento estendido; consulte a versão atual para as restrições de protocolo do Agente |
| OpenAI | Estar acostumado ao formato OpenAI, ou gerenciar junto com outros serviços compatíveis com OpenAI |

Ambos os endpoints usam a mesma chave da API e o mesmo conjunto de IDs de modelos.

## Perguntas frequentes

<AccordionGroup>
<Accordion title="Falha ao obter lista de modelos?">

Primeiro verifique se a chave da API tem espaços extras; depois confirme se o endereço da API é `https://1zheai.com` sem nenhum caminho extra escrito. Se você não conseguir buscar a lista, isso não afeta o uso — inserir manualmente um ID de modelo também funciona.

</Accordion>
<Accordion title="Conversa retorna 404?">

O endereço da API foi inserido como um caminho completo, ou `#` foi adicionado no final. Altere de volta para a URL base `https://1zheai.com`.

</Accordion>
</AccordionGroup>