Saltar para o conteúdo

AI Chats

As suas conversas com a IA.

Abrir AI Chats
Verificado com o painel em 20 de novembro de 2026

O AI Chats tem nove métodos públicos. Gerem conversas que já existem: o nome, a fixação, a marca de favorita, o arquivo e a eliminação, e a remoção de uma mensagem. Cada um atua em nome da conta cuja chave de API usa.

Iniciar uma conversa, enviar uma mensagem, ler as mensagens de uma conversa e escolher um plano faz-se no dashboard. Não têm hoje método público.

Envie um pedido a um método com a sua chave:

curl -s https://xuda.ai/cpi/rename_ai_chat \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","conversation_id":"YOUR_CONVERSATION_ID","title":"Quarterly numbers"}'
const res = await fetch('https://xuda.ai/cpi/rename_ai_chat', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    conversation_id: 'YOUR_CONVERSATION_ID',
    title: 'Quarterly numbers',
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/rename_ai_chat',
    json={
        'api_key': 'YOUR_API_KEY',
        'conversation_id': 'YOUR_CONVERSATION_ID',
        'title': 'Quarterly numbers',
    },
)

Uma boa resposta tem code 1. Uma recusada tem um code negativo e diz porquê em data.

Todos os métodos recebem o id da conversa como conversation_id, que é a última parte do endereço da conversa no dashboard. Cada um recebe também um workspace_id opcional, para atuar num espaço de trabalho que não o seu.

Dar nome a uma conversa e marcá-la

  • rename_ai_chat recebe conversation_id e title. O título é aparado e cortado aos 120 caracteres, e um título vazio é recusado. Uma conversa que foi partilhada consigo só é renomeada pelo seu proprietário, e uma conversa que não iniciou é recusada.
  • pin_ai_chat e unpin_ai_chat fixam uma conversa e retiram a fixação.
  • favorite_ai_chat e unfavorite_ai_chat definem e limpam a marca de favorita, o coração no cartão da conversa.

Arquivar e eliminar

  • archive_ai_chat tira uma conversa da lista Ativas e passa-a para Arquivadas. Só a pessoa que iniciou a conversa, ou o proprietário do espaço, a pode arquivar.
  • unarchive_ai_chat traz de volta uma conversa arquivada.
  • delete_ai_chat elimina uma conversa definitivamente. Só aceita uma conversa arquivada: arquive primeiro e elimine depois. Eliminar uma conversa que foi partilhada consigo termina antes a partilha.
  • delete_conversation_item remove uma mensagem de uma conversa. Recebe conversation_item_id, e só uma mensagem que escreveu você mesmo.
Eliminar não pode ser desfeito

Uma conversa eliminada com delete_ai_chat desaparece com todas as suas mensagens. Arquivar é o passo a usar quando só quer pôr uma conversa de lado.

Que tal está este guia?

Última atualização em 16 de novembro de 2026