# Importar personagens

> Trazer um card do SillyTavern ou do CharacterHub para a Reverie.

Source: https://reverie.im/pt/docs/characters/import-characters
Language: pt

A Reverie lê cards de personagem nos formatos V1, V2 e V3 — os que o SillyTavern, o CharacterHub e a maioria dos sites de cards exportam. O importador preenche um rascunho editável; nada é salvo até você mesmo apertar salvar.

## Importar um card \[#import-a-card]

### Abra um personagem novo \[#open-a-new-character]

Vá para `/app/characters/create` e aperte **Importar cartão de personagem** no cabeçalho. O botão só existe enquanto você está criando um personagem — não dá para importar dentro de um personagem que já existe.

### Solte o arquivo \[#drop-the-file]

**PNG ou JSON · até 10 MB.** O card é analisado no seu navegador, não enviado para ser lido. Cards PNG carregam o JSON dentro da imagem; cards JSON são lidos direto.

Registros de conversa e arquivos avulsos de livro de mundo são formatos diferentes, com ferramentas próprias — veja [importar seu histórico](https://reverie.im/pt/docs/getting-started/importing-your-history) e [livros de mundo](https://reverie.im/pt/docs/writing/world-books).

### Revise o que ele vai preencher \[#review-what-it-will-fill]

O diálogo mostra a versão de card detectada, o avatar e uma lista **Pronto para preencher** com todos os campos que ele vai escrever, com os valores. Nada muda até você confirmar.

Se você já digitou algo no formulário, escolhe também entre **Preencher apenas campos vazios** (mantém suas edições e acrescenta o que falta) e **Substituir campos correspondentes** (o card ganha onde quer que tenha um valor).

### Se quiser, deixe a IA arrumar \[#optionally-let-ai-tidy-it-up]

**Usar IA para organizar e enriquecer o rascunho** passa uma faxina pelo resultado. A maioria dos cards põe tudo numa única descrição longa, então a passada divide a descrição, o cenário e as instruções em trechos e move cada um, palavra por palavra, para o campo a que pertence: a aparência vai para **Descrição da Aparência**, quem você é para o personagem vai para **Relacionamento com o Jogador**, as regras fixas vão para **Prompt do Sistema**. O texto que passa do limite da descrição fica guardado no World Book do card. Depois ela escreve só o que falta ao card, como uma biografia, respostas sugeridas e uns dois cenários extras. A importação crua é aplicada primeiro e sobrevive caso essa passada falhe, então você nunca perde o conteúdo do card por ter pedido isso. Pode consumir créditos.

### Confira e salve \[#check-and-save]

Você cai de volta no editor com o rascunho preenchido. Acrescente as partes obrigatórias que o card não carrega — as **Categorias do Personagem** são obrigatórias e nenhum formato de card as tem — e salve.

## O que vira o quê \[#what-maps-to-what]

| Do card                                                                              | Vira                                                                                                                                                                                              |
| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `nickname`, senão `name`                                                             | **Nome do Personagem**, cortado em 50 caracteres                                                                                                                                                  |
| `description`, senão `char_persona`                                                  | **Descrição Detalhada**, cortada em 10.000 caracteres                                                                                                                                             |
| `tagline`, senão a descrição ou a personalidade                                      | **Biografia do Personagem**, resumida em 500 caracteres                                                                                                                                           |
| `personality`                                                                        | **Personalidade do Personagem**                                                                                                                                                                   |
| `appearance`                                                                         | **Descrição da Aparência**                                                                                                                                                                        |
| `player_relationship`                                                                | **Relacionamento com o Jogador**                                                                                                                                                                  |
| `first_mes` / `char_greeting`, depois `alternate_greetings` e `group_only_greetings` | Um **Diálogo Inicial** por saudação, em ordem, sem respostas sugeridas                                                                                                                            |
| `mes_example` / `example_dialogue`                                                   | **Conversas de Exemplo**, analisadas em pares usuário/personagem                                                                                                                                  |
| `scenario` / `world_scenario`                                                        | Acrescentado ao final da **Descrição Detalhada**, depois de "Scenario:". Todas as conversas do card começam nessa situação, e um cenário do Reverie só chega às conversas iniciadas a partir dele |
| `system_prompt`, `post_history_instructions` e `depth_prompt`                        | **Prompt do Sistema**, emendados nessa ordem. Em geral trazem fatos do personagem e regras fixas, e um **Prompt de Formato de Resposta** substitui as regras de formatação do próprio Reverie     |
| `nsfw_prompt`                                                                        | **Prompt NSFW**                                                                                                                                                                                   |
| `tags`                                                                               | **Tags**, sem repetidas, ficam as 20 primeiras                                                                                                                                                    |
| `gender`, `age`                                                                      | **Gênero do Personagem**, **Idade do Personagem**                                                                                                                                                 |
| Marcações NSFW                                                                       | A chave **Conteúdo NSFW**                                                                                                                                                                         |
| `creator_notes`                                                                      | **Notas do criador**                                                                                                                                                                              |
| Entradas de `character_book`                                                         | Um **World Book** separado, com o nome do personagem e anexado a ele                                                                                                                              |

Imagens embutidas e linkadas são copiadas para o armazenamento da Reverie. O que não der para buscar continua apontando para o site original, e o diálogo diz a quantas imagens isso se aplica.

**Não atravessa:** histórico de conversa, memórias por usuário e qualquer dado de extensão específico de outra plataforma além dos campos acima.

## Macros no texto importado \[#macros-in-imported-text]

* `{{char}}` é trocado pelo nome do personagem na hora em que o card é analisado.
* `{{original}}` é retirado dos campos de prompt.
* `{{user}}` fica como está — a Reverie o suporta como macro viva. Veja [a lista de macros](https://reverie.im/pt/docs/characters/advanced-settings#macros).

## Mensagens que você pode ver \[#messages-you-might-see]

| Mensagem                                                                     | O que aconteceu                                                                                                                   |
| ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| O nome excedia o limite de 50 caracteres do Reverie e foi encurtado          | O nome do card era mais longo do que a Reverie permite                                                                            |
| A descrição excedia o limite de 10 000 caracteres do Reverie e foi encurtada | O mesmo, para a descrição. O card original fica intocado                                                                          |
| A idade de origem está fora do intervalo suportado e não foi importada       | A Reverie só aceita idades de 18 para cima                                                                                        |
| O cartão contém diálogos de exemplo num formato não reconhecido              | O analisador de exemplos não conseguiu separá-los. Ligue a organização com IA para recuperá-los, ou redigite depois da importação |
| Este ficheiro está vazio / Os cartões devem ter no máximo 10 MB              | O arquivo foi recusado antes da análise                                                                                           |

## Importar de qualquer outro lugar \[#importing-from-anywhere-else]

Formatos de card são uma coisa; uma exportação do Character.AI, uma captura de tela ou uma descrição solta são outra. Essas passam pela **Skill de Importação de Personagens** no Labs (`/app/labs/character-importer`), que roda dentro do seu próprio cliente Claude e envia o personagem pronto pela API da Reverie.

A página te dá uma mensagem prontinha para colar no Claude Code, no Claude Desktop ou em qualquer outro cliente: ela instala a skill e guarda a sua chave de API da Reverie. Depois disso, solte um arquivo, uma captura ou uma descrição nessa mesma conversa e diga "Importe este personagem para o Reverie." Personagens novos aparecem em **Meus personagens**.

> Essa mensagem preparada contém uma chave de API pessoal. Trate-a como uma senha
> e rode ou revogue em **Configurações → Chaves de API** se vazar. Veja [chaves de
> API](https://reverie.im/pt/docs/integrations/api-keys).

## Veja também \[#related]

* [Início rápido de personagem](https://reverie.im/pt/docs/characters/quick-start)
* [World Books](https://reverie.im/pt/docs/writing/world-books)
* [Configurações Avançadas](https://reverie.im/pt/docs/characters/advanced-settings)
* [Publicar um personagem](https://reverie.im/pt/docs/characters/publishing)
* [Traga seus personagens com você →](https://reverie.im/pt/blog/bring-your-characters)
