PT ▾
Obter chave de API

Chave de API do Character AI: Como Obter e Usar

Se você pesquisou por uma chave de API do character ai, a primeira coisa a saber é que este site não é o Character.ai e não emite suas chaves. Ele oferece uma chave para uma API de texto independente e compatível com OpenAI que funciona como um backend pronto para usar para apps de chat de personagens.

Uma chave brilhante acima dos painéis de chat conectados a um cubo de servidor, ilustrando o acesso à chave de API

Pontos principais

  1. Você obtém uma chave após entrar com Google ou e-mail e senha, depois abrindo a página da chave de API.
  2. Novos usuários podem resgatar $0,50 de crédito de teste com um clique, sem necessidade de cartão, válido por 7 dias.
  3. Use a base URL https://api.characteraiapi.com/v1 e o ID do modelo uncensored com qualquer SDK OpenAI.
  4. Mantenha a chave em um servidor ou em uma variável de ambiente, nunca em código front-end público.

O que você está realmente recebendo

Character.ai é um produto de chat para consumidores. As pessoas que procuram uma chave de API do character ai geralmente querem uma das duas coisas: uma maneira de chamar um chatbot de personagem do próprio código, ou um backend para um app de persona que não é limitado pelas regras de um produto hospedado. Este site cobre a segunda necessidade. Você entra, recebe uma chave e envia requisições para um endpoint compatível com OpenAI. Nada aqui se conecta ao Character.ai ou reutiliza seus personagens.

O serviço é uma API de texto hospedada na frente de um único modelo de pesos abertos, executado por um provedor independente e ajustado para responder sem recusas de conteúdo para uso adulto legal. Não é a API oficial de nenhum fornecedor de modelo e não é um roteador entre fornecedores. O ID do modelo é uncensored, e a base URL é https://api.characteraiapi.com/v1. Existem dois métodos: POST /v1/chat/completions e GET /v1/models.

Como a interface é compatível com a da OpenAI, o trabalho de criar um personagem fica por sua conta. Você escreve a persona como uma mensagem de sistema, mantém o histórico da conversa e envia junto com cada requisição. Isso lhe dá controle sobre a voz, a memória e o ritmo que um produto fechado raramente oferece. O limite rígido é o mesmo para todos os usuários: sem conteúdo sexual envolvendo menores de idade, nunca.

Obtenha sua chave em cinco etapas

O caminho inteiro leva alguns minutos. Você não precisa de um cartão para começar.

  1. Entrar. Use o Google ou registre-se com um e-mail e senha.
  2. Abra a página da chave. Vá para a página da chave de API, onde a chave da sua conta é exibida.
  3. Resgate o teste. Um clique nessa página adiciona $0,50 de crédito de teste. É limitado a um por pessoa e é válido por 7 dias.
  4. Copie a chave. Armazene-a em um gerenciador de senhas ou em um arquivo de segredos imediatamente.
  5. Envie uma requisição de teste. Use o comando curl abaixo antes de tocar em qualquer código de app.

Trate a chave como uma senha. Qualquer pessoa que a tiver pode gastar seu saldo. Se você acha que ela vazou, pare de usá-la imediatamente, remova-a de todos os apps e verifique seu saldo para gastos inesperados.

Teste a chave com curl

Defina a chave como uma variável de ambiente para que ela nunca apareça no histórico do shell como texto puro dentro de um script. Em seguida, liste os modelos. Isso confirma que a chave funciona e que você alcança o host correto.

export API_KEY="paste-your-key-here"

curl https://api.characteraiapi.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

Você deve obter uma lista JSON que inclui uncensored. Agora envie uma primeira requisição de chat com uma persona pequena. A mensagem de sistema define o personagem, a mensagem do usuário inicia a cena.

curl https://api.characteraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are Mara, a dry-witted ship engineer in a space opera. Stay in character."},
      {"role": "user", "content": "The reactor is humming wrong again. What do you do?"}
    ],
    "temperature": 0.9
  }'

A resposta segue o formato padrão de conclusões de chat. O texto da resposta está em choices[0].message.content. Os cabeçalhos de resposta também carregam X-Request-Id, X-Balance-USD e os cabeçalhos de limite de requisições, o que é útil quando você deseja mostrar o saldo restante na sua própria interface.

Use a chave do Python ou Node

Qualquer SDK OpenAI funciona depois que você altera dois valores: a base URL e a chave. Aqui está a versão Python com o pacote oficial openai.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.characteraiapi.com/v1",
    api_key=os.environ["API_KEY"],
)

reply = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are Mara, a ship engineer. Stay in character."},
        {"role": "user", "content": "Status report?"},
    ],
)
print(reply.choices[0].message.content)

E a mesma chamada em Node:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.characteraiapi.com/v1",
  apiKey: process.env.API_KEY,
});

const reply = await client.chat.completions.create({
  model: "uncensored",
  messages: [
    { role: "system", content: "You are Mara, a ship engineer. Stay in character." },
    { role: "user", content: "Status report?" },
  ],
});
console.log(reply.choices[0].message.content);

Muitos front-ends de chat têm um campo para um endpoint compatível com OpenAI personalizado. Nessas ferramentas, você cola a base URL, cola a chave e digita uncensored como o nome do modelo. Nada mais precisa ser alterado. A página de documentação lista os parâmetros suportados, incluindo streaming, chamada de funções e modo JSON.

Problemas comuns com chaves e correções rápidas

A maioria das falhas na primeira tentativa vem de alguns pequenos erros. Verifique-os nesta ordem antes de suspeitar de algo maior.

  • Espaços em branco extras ou aspas na chave. Uma nova linha final copiada de um arquivo é suficiente para fazer a autenticação falhar. Imprima o comprimento da variável e compare com o que você copiou.
  • Base URL errada. A base URL termina em /v1, e o SDK anexa /chat/completions automaticamente. Se você também adicionar /chat/completions à base URL, o caminho duplica e a requisição falha.
  • Nome do modelo errado. O ID do modelo é uncensored. Nomes emprestados de outros serviços não corresponderão. Faça GET /v1/models para ver o que o servidor informa.
  • Cabeçalho ausente. Chamadas HTTP brutas precisam de Authorization: Bearer seguido por um espaço e a chave, além de Content-Type: application/json em requisições POST.
  • Saldo vazio. O cabeçalho de resposta X-Balance-USD mostra o que resta. Quando o crédito de teste é gasto ou ultrapassa 7 dias, recarregue ou as requisições deixarão de ter sucesso.
  • Limites de requisições. Uma chave de teste permite 2 requisições simultâneas e 60 por minuto. Duas streams abertas já usam ambas as vagas.

Uma chave ruim geralmente produz um erro de autenticação em vez de uma resposta do modelo. Um limite produz HTTP 429 com o código rate_limited ou concurrency. Ler o corpo do erro, não apenas o código de status, economiza tempo porque o código informa qual limite você atingiu. Cada resposta carrega um X-Request-Id; mantenha-o nos seus logs para que você possa corresponder uma chamada falhada a uma requisição específica mais tarde.

Limites de teste e o que o teste compra

Uma chave de teste tem limites menores que uma completa: 2 requisições simultâneas e 60 requisições por minuto. Uma chave completa permite 8 requisições simultâneas e 300 requisições por minuto. Para testar uma única persona, isso é mais do que suficiente. Se você executar vários chats ao mesmo tempo a partir de um script de teste, verá HTTP 429 com o código de erro concurrency ou rate_limited. Uma solicitação de streaming mantém sua vaga de concorrência até que o stream termine, então duas streams abertas em uma chave de teste a preenchem.

O quanto $0,50 rende? Os preços são $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída. Considere uma rodada de chat típica com 1.500 tokens de histórico e persona entrando e 300 tokens saindo:

  • Entrada: 1.500 tokens x $0,15 / 1.000.000 = $0,000225
  • Saída: 300 tokens x $0,50 / 1.000.000 = $0,00015
  • Uma rodada: $0,000375
  • $0,50 / $0,000375 é cerca de 1.333 rodadas

Isso é suficiente para testar vários personagens adequadamente. Requisições falhas ou recusadas não são cobradas, então uma requisição que falha não consome seu crédito. O teste expira após 7 dias; o crédito que você compra depois nunca expira.

Configurações que fazem uma persona parecer adequada

Uma chave garante a conexão; a qualidade de um personagem vem do prompt e das configurações de amostragem. Alguns hábitos ajudam mais do que truques engenhosos.

Escreva a mensagem do sistema como uma ficha de personagem curta em frases simples: quem é o personagem, como ele fala, o que ele quer e qual deve ser o tamanho das respostas. Forneça uma ou duas linhas de diálogo de exemplo se a voz for importante. Os modelos seguem exemplos concretos melhor do que adjetivos, então uma linha como "Mara responde em frases curtas e secas e brinca quando está nervosa" funciona melhor do que "Mara é espirituosa e encantadora".

Use temperature para definir a vivacidade. Valores próximos de 0,9 dão mais variação de frase, enquanto valores próximos de 0,5 mantêm o personagem mais estável. Adicione uma sequência stop se seu aplicativo usar um rótulo de falante como "Usuário:" e você quiser impedir que o modelo escreva o outro lado da conversa. As penalidades de frequência e presença podem reduzir frases repetidas em chats longos, mas aumente-as com cuidado, pois valores altos podem tornar o diálogo estranho.

Lembre-se de que o modelo só sabe o que está na requisição. Se o personagem deve lembrar o nome do jogador de 200 mensagens atrás, mantenha essa mensagem na janela ou armazene fatos-chave na mensagem do sistema. É por isso que uma lista de memória que você atualiza manualmente geralmente é melhor do que enviar um histórico enorme.

Recarregar quando o crédito de teste acabar

Não há assinatura. Você pré-paga e gasta por token. As recargas aceitam qualquer valor inteiro de $20 a $500, e valores maiores trazem um bônus: +5% a partir de $50, +10% a partir de $100 e +15% a partir de $200. Assim, $50 se tornam $52,50 de crédito, $100 se tornam $110 e $200 se tornam $230. Você pode pagar com cripto (USDT na TRC20, USDC na Base). Cartão não é mais aceito.

A página de preços tem a tabela completa. Para planejamento, uma rodada de 1.500 tokens de entrada e 300 de saída custa $0,000375, então $20 cobrem aproximadamente 53.000 dessas rodadas. Roleplay de longa duração custa mais por rodada porque o histórico cresce, então limite quanto disso você reenvia. A janela de contexto é de 100.000 tokens, prompt mais conclusão, mas você raramente quer preenchê-la.

Mantendo a chave segura em um aplicativo real

O erro mais comum com um projeto de chat é chamar a API diretamente do código do navegador. Tudo enviado para o navegador pode ser lido por todos os visitantes, incluindo a chave. Coloque um pequeno servidor entre seu front-end e a API. O navegador fala com sua rota, sua rota adiciona o cabeçalho Authorization: Bearer e encaminha a requisição.

  • Armazene a chave em uma variável de ambiente ou em um gerenciador de segredos, não no repositório.
  • Adicione uma entrada .env ao .gitignore antes do seu primeiro commit.
  • Use uma chave por ambiente para que um vazamento no desenvolvimento não afete a produção.
  • Monitore o cabeçalho X-Balance-USD para detectar loops descontrolados cedo.
  • Retente em HTTP 429 com uma espera curta. Uma resposta de sobrecarga temporária inclui Retry-After: 5.

Os prompts enviados para a API não são usados para treinamento. Mesmo assim, evite enviar dados que você não gostaria que fossem armazenados em um log do seu lado. Se você quiser uma análise mais aprofundada do que uma API assim faz e não faz, o artigo mitos e fatos cobre mal-entendidos comuns.

Perguntas e respostas

Isso me dá uma chave de API do Character.ai?

Não. Este é um serviço separado e independente. Você obtém uma chave para um endpoint compatível com OpenAI com o ID do modelo uncensored, que você pode usar como backend para seus próprios aplicativos de personagens.

Preciso de um cartão para obter uma chave?

Não. Você entra com Google ou e-mail e senha, depois resgata $0,50 de crédito de teste com um clique na página da chave de API. O crédito de teste é válido por 7 dias.

Posso usar a chave no SillyTavern ou em outros front-ends de chat?

Ferramentas que aceitam um endpoint compatível com OpenAI podem usá-lo. Insira a base URL, sua chave e o nome do modelo uncensored.

O que acontece quando atingo o limite de requisições?

A API retorna HTTP 429 com o código rate_limited ou concurrency. Aguarde um momento e tente novamente. Uma chave de teste permite 2 requisições simultâneas e 60 por minuto.

O crédito expira?

O crédito comprado nunca expira. Apenas o crédito de teste de $0,50 tem uma janela de 7 dias.

Sua chave está a um formulário de distância

Crie uma conta, copie a chave e altere a base URL. Essa é toda a configuração.

Obter chave de API