​

Editar Avatar

Edita um sub-avatar existente para um host específico, permitindo atualizar suas características e configurações.

Endpoint: POST /api/externalAPIs/public/tolkyReasoning/editAvatarHelper

Parâmetros:

• avatar_id (string, UUID, obrigatório): Identificador único do avatar a ser editado
• host_id (string, UUID, obrigatório): Identificador único do host
• avatar_name (string, opcional): Nome do sub-avatar, usado para identificação
• avatar_picture (string, opcional): URL da imagem de perfil personalizada do sub-avatar
• prompt_envelop (string, opcional): Texto de prompt que define o comportamento e a personalidade do sub-avatar
• model (string, opcional): Modelo de IA a ser utilizado pelo sub-avatar

Exemplo cURL:

curl -X POST \
  '{BASE_URL}/api/externalAPIs/public/tolkyReasoning/editAvatarHelper' \
  -H 'Content-Type: application/json' \
  -d '{
    "avatar_id": "uuid-do-avatar",
    "host_id": "uuid-do-host",
    "avatar_name": "Novo Nome do Avatar",
    "avatar_picture": "nova-url-da-imagem",
    "prompt_envelop": "novo-prompt-personalizado",
    "model": "gpt-4"
  }'

Resposta de Exemplo:

{
  "code": 200,
  "message": "Success",
  "data": {
    "avatar_id": "uuid-do-avatar",
    "sub_slug": "slug-do-avatar",
    "avatar_picture": "nova-url-da-imagem",
    "avatar_name": "Novo Nome do Avatar",
    "prompt_envelop": "novo-prompt-personalizado",
    "model": "gpt-4"
  }
}

Códigos de Erro:

• 400: Campos obrigatórios ausentes ou inválidos
• 403: Credenciais inválidas ou sem permissão de acesso
• 408: A requisição excedeu o limite de tempo de 60 segundos
• 409: Sub-avatar com este ID não existe
• 500: Erro interno do servidor ao processar a requisição

Notas:

• A resposta é cacheada por 30 minutos para melhor performance
• Apenas os campos fornecidos serão atualizados, os demais permanecerão inalterados
• Requer autenticação válida através do tolkyAuthMiddleware