Tencent: Hunyuan Role

O Hunyuan Role é adaptado para diálogos baseados em personagens. Use-o para personas fictícias, histórias interativas e experiências conversacionais onde manter um papel e tom definidos é central para a interação.

Comparar modelos

hunyuan-role

DisponívelTencentChat

Entrada / Saída: $0.3529 / $1.41
Contexto: 29K
Saída máxima: 4K
Modalidades: Chat

Sobre o Hunyuan Role

Hunyuan Role é o modelo de chat do Tencent Hunyuan ajustado para interpretação de papéis (role-play): avatares digitais, chat de personagens e aplicativos de companhia. A Tencent treinou-o adicionalmente em grandes conjuntos de diálogos de personagens para que ele mantenha a configuração e a voz de uma persona ao longo de muitos turnos e quebre o personagem com menos frequência. Ao contrário dos modelos gerais Hy3 e Hy4 Preview, ele foi criado para manter o personagem, não para codificação, análise ou trabalho de agente.

Pontos fortes

Mantém o histórico, o tom e os hábitos de fala de um personagem ao longo de longas conversas de vários turnos, em vez de retornar a uma voz de assistente neutra.
A Tencent treinou-o com dados de diálogo de personagens em larga escala, especificamente para eliminar respostas fora do personagem.
Mantém o contexto coerente entre os turnos, para que pontos anteriores da trama e detalhes de uma cena sejam preservados ao longo da conversa.
Ajustado para um chat animado e imersivo; a Tencent cita avatares digitais, interpretação de papéis e companhia emocional como seus cenários pretendidos.

Quando usar outro modelo

Apenas texto: ele não lê imagens, portanto, chats de personagens que dependem de fotos compartilhadas precisam de um modelo diferente.
Sem chamada de ferramentas e sem saída com restrição de esquema, o que o exclui como backend de agente ou etapa de extração de dados.
Seus limites de contexto e saída são pequenos em comparação com os modelos de chat gerais atuais, portanto, histórias de longa duração precisam de um histórico resumido.

Primeiros passos

Criar chave de API
Crie uma chave no Console e use com qualquer modelo da plataforma.

Envie sua primeira requisição

Copie o exemplo para sua linguagem e execute-o no endpoint.

Texto para textoMessages API

POST/v1/messages

Formato da API:

curl https://api.tokenlab.sh/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-xxx" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "hunyuan-role",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

Preço

O preço Verified vale para o Verified, que custa menos na maioria dos modelos. O preço Official é o preço publicado pelo fabricante do modelo e vale para a rota Official, mais confiável. O Auto cobra pela rota que conclui a solicitação.

Preço

Por 1M Token

Preço Verified: —
Preço Official: Entrada$0.3529Por 1M TokenSaída$1.41Por 1M Token

	Preço OfficialPor 1M Token	Preço VerifiedPor 1M Token	Desconto
Entrada	$0.3529	—	—
Saída	$1.41	—	—

Uso e atividade

A taxa de sucesso é a proporção de requisições concluídas. A latência é quanto tempo uma resposta completa leva; P95 significa que 95% das requisições terminaram dentro desse tempo.

Uso e disponibilidade

Últimas 24 horas

Requisições
Taxa de sucesso
Latência P95
Total de tokens

Desempenho do modelo

Última atualização 1 de nov. de 2026, 08:16 UTC

As métricas aparecerão assim que os limites de privacidade e volume de dados forem atingidos.

Os dados baseiam-se em solicitações agregadas de usuários, excluindo verificações de status.

Abrir no Console

Abra Hunyuan Role no Console com um prompt pronto para editar ou enviar.

Ajude-me a testar hunyuan-role com uma mensagem em /v1/messages. Exiba a resposta, latência e custo.

Casos de uso

Aplicativos de companhia e personagens
Execute uma persona nomeada com um histórico e estilo de fala fixos para conversas diárias, mantendo a mesma personalidade da primeira à centésima mensagem.
Ficção interativa
Interprete personagens não jogáveis ou um narrador em aventuras de texto e visual novels, onde cada resposta deve se adequar à cena e aos motivos do personagem.
Avatares digitais
Dê a um mascote de marca, anfitrião virtual ou ao dublê digital de um criador uma voz consistente para conversas com fãs.
Rascunhos de diálogo para escritores
Rascunhe falas de personagem para um roteiro ou jogo para ouvir como um personagem responderia antes de escrever o diálogo final.

Exemplos de prompt

Você é Lin Wan, uma dona de casa de chá na Xangai dos anos 1930: calorosa, de língua afiada e apreciadora de provérbios antigos. Mantenha o personagem. Um estranho entra da chuva e pergunta se você viu o irmão dele.

Interprete o Capitão Ortiz, um engenheiro de nave estelar cansado que desconfia do computador da nave. Eu sou um novo recruta em meu primeiro turno. Abra a cena na sala de máquinas e mantenha cada resposta com menos de quatro frases.

Você é Xiaoman, minha parceira de estudos otimista que me provoca, mas nunca desiste de mim. Quero encerrar a sessão de vocabulário desta noite mais cedo. Convença-me a ficar mais vinte minutos, com sua própria voz.

Calculadora de custo

Tokens de entrada por mês1M tokens

Tokens de saída por mês0.5M tokens

Custo mensal estimado$1.058823

FAQ

Para que o Hunyuan Role é usado?

Conversa de personagens. A Tencent lista avatares digitais de IA, interpretação de papéis e companhia emocional como seus cenários. Ele é adequado para produtos onde uma persona com histórico e voz definidos conversa com usuários ao longo de muitos turnos, como aplicativos de companhia, histórias interativas e anfitriões virtuais. Para perguntas e respostas gerais, codificação ou análise, escolha um modelo de chat geral.

Como o Hunyuan Role é diferente do Hy3 ou Hy4 Preview?

Hy3 e Hy4 Preview são os modelos gerais da Tencent para codificação, trabalho de escritório e tarefas de agente, e ambos podem chamar ferramentas. O Hunyuan Role foi treinado adicionalmente em diálogos de personagens para manter uma persona estável. Ele não pode chamar ferramentas e seu contexto é muito menor, portanto, use-o para chat de persona e use os outros para todo o resto.

O Hunyuan Role suporta imagens ou chamada de ferramentas?

Não. Ele recebe texto e retorna texto. Ele não aceita entrada de imagem, não chama ferramentas e não retorna saída com restrição de esquema. Se um personagem precisar olhar para uma imagem ou acionar uma ação, delegue essa etapa a outro modelo ou escolha um modelo de chat multimodal para toda a conversa.

Como mantenho um personagem consistente em uma conversa longa?

Coloque o histórico, a personalidade, o estilo de fala e os limites do personagem na mensagem do sistema e envie-a com cada solicitação. Como o contexto é limitado, substitua turnos mais antigos por um breve resumo da trama e do relacionamento até o momento. O modelo é treinado para manter uma persona, mas só pode seguir o que ainda está na solicitação.

Quais modelos são mais próximos do Hunyuan Role?

Os outros modelos de chat ajustados para persona: Doubao-Seed-Character da ByteDance, e Qwen Plus Character e Qwen Flash Character da Alibaba. Todos eles visam o diálogo orientado a personagens, mas vêm de fabricantes e dados de treinamento diferentes, portanto, execute o mesmo cartão de personagem em cada um antes de escolher.

Quanto custa o Hunyuan Role?

No TokenLab, Hunyuan Role custa Entrada $0.3529 / Saída $1.41 Por 1M Token. A tabela de preços acima mostra o detalhamento completo.

Qual a janela de contexto e o limite de saída do Hunyuan Role?

O Hunyuan Role aceita até 28.672 tokens de contexto e gera até 4.096 tokens por resposta.

Qual endpoint o Hunyuan Role deve usar?

Use https://api.tokenlab.sh/v1/messages para Hunyuan Role. O exemplo de requisição abaixo mostra o formato de código correspondente.

Quais operações o Hunyuan Role suporta?

Hunyuan Role suporta Texto para texto. Selecione uma operação acima para ver seu endpoint e exemplo de requisição.