DOCUMENTAÇÃO DA API DA AGATHA AI

Visão Geral

Todos os endpoints requerem autenticação (exceto o login inicial), e o modelo de linguagem é fixo em agatha-v4b-2025.gguf, enquanto os modelos de imagem são limitados a Agatha_EpicRealism.safetensors e Agatha_Dreams_Shaper_XL.safetensors.

Base URL: https://agathaai.ai/api.php?endpoint=
Autenticação:
- Primeiro, faça login via POST /login.php para obter uma sessão e o cookie user_token.
- Todos os endpoints verificam a sessão e o login_token no banco de dados.
- Cabeçalhos: Inclua o cookie user_token em todas as requisições após o login.
Formatos de Requisição/Resposta: JSON ou multipart/form-data (para uploads de imagens). Respostas sempre em JSON.
Erros Comuns:
- 401: Não autorizado (faça login novamente).
- 400: Parâmetros inválidos ou ausentes.
- 403: Créditos insuficientes ou ação proibida.
- 405: Método HTTP incorreto.
- 404: Endpoint não encontrado.
- 500: Erro interno no servidor ou no endpoint chamado.
Consumo de Créditos: Gerenciado pelos endpoints PHP chamados (ex.: chat.php deduz créditos por mensagem/imagem/vídeo).
Modelos:
- Linguagem: Sempre agatha-v4b-2025.gguf (fixo, ignora seleções).
- Imagem: Apenas Agatha_EpicRealism.safetensors ou Agatha_Dreams_Shaper_XL.safetensors (validado; default para o primeiro se inválido).

ÍNDICE

1. Autenticação 2. Enviar Mensagem 3. Verificar Resposta (Polling) 4. Obter Histórico de Chats 5. Consultar Créditos 6. Coletar Créditos Diários 7. Excluir Chat 8. Atualizar Nome do Chat 9. Arquivar Chat 10. Criar Novo Chat 11. Atualizar Modelo de Linguagem 12. Atualizar Modelo de Imagem 13. Editar Mensagem 14. Treinar IA

1. AUTENTICAÇÃO

Realiza login e inicia sessão (não parte da api.php, mas essencial).

Método: POST
URL: /login.php
Descrição: Realiza login e inicia sessão.
Corpo da Requisição (application/x-www-form-urlencoded ou JSON):

{
    "email": "[email protected]",
    "password": "suasenha"
}

Resposta de Sucesso (200):

{
    "status": "success",
    "message": "Login realizado com sucesso!"
}

Define cookie: user_token (HttpOnly, expira em 30 dias).
Resposta de Erro (400):

{
    "status": "error",
    "message": "E-mail ou senha inválidos."
}

2. ENVIAR MENSAGEM

Envia mensagem de texto ou imagem para processamento.

Método: POST
URL: /api.php?endpoint=send_message
Descrição: Envia mensagem de texto ou imagem para processamento (usa chat.php ou chat_train.php dependendo do modo de chat na sessão). Suporta contexto adicional, request_id para polling, e upload de imagem. O processamento de créditos e resposta é delegado ao endpoint chamado.
Corpo da Requisição (multipart/form-data para imagem; JSON para texto):

{
    "message": "Conteúdo da mensagem",
    "message_search": "Contexto adicional",
    "chat_id": 123,
    "request_id": "1234567890abc",
    "image_model": "Agatha_EpicRealism.safetensors",
    "image": ""
}

Resposta de Sucesso (200):

{
    "status": "success",
    "request_id": "1234567890abc",
    "chat_id": 123,
    "message": "Mensagem enviada, aguardando processamento."
}

Resposta de Erro (403):

{
    "status": "error",
    "message": "Créditos insuficientes."
}

3. VERIFICAR RESPOSTA (POLLING)

Verifica o status de uma solicitação via polling.

Método: GET
URL: /api.php?endpoint=check_response&request_id=
Descrição: Verifica o status de uma solicitação (texto, imagem ou vídeo). Delega para check_response.php.
Parâmetros de Query:

{
    "request_id": "1234567890abc"
}

Resposta de Sucesso (200):

{
    "status": "completed",
    "reply": "Resposta do bot ou URL da imagem/vídeo",
    "progress": 100,
    "usage": {
        "total_tokens": 10
    }
}

Resposta em Processamento (200):

{
    "status": "processing",
    "progress": 50
}

Resposta de Erro (500):

{
    "status": "error",
    "message": "Erro ao processar a solicitação."
}

4. OBTER HISTÓRICO DE CHATS

Recupera histórico de chats e mensagens.

Método: GET
URL: /api.php?endpoint=get_chat_history
Descrição: Recupera histórico de chats e mensagens. Delega para load_chats.php.
Resposta de Sucesso (200):

{
    "success": true,
    "chats": [
        {
            "chat_id": 123,
            "name": "Chat 123",
            "created_at": "2025-10-04 12:04:00",
            "messages": [
                {
                    "id": 1,
                    "content": "Olá, como você está?",
                    "sender": "user",
                    "timestamp": "2025-10-04 12:04:00"
                }
            ]
        }
    ]
}

Resposta de Erro (500):

{
    "success": false,
    "message": "Erro ao carregar histórico."
}

5. CONSULTAR CRÉDITOS

Retorna o saldo de créditos do usuário.

Método: GET
URL: /api.php?endpoint=get_credits
Descrição: Retorna o saldo de créditos do usuário. Delega para get_credits.php.
Resposta de Sucesso (200):

{
    "credits": 10
}

Resposta de Erro (500):

{
    "success": false,
    "message": "Erro ao consultar créditos."
}

6. COLETAR CRÉDITOS DIÁRIOS

Coleta créditos diários (se disponível).

Método: POST
URL: /api.php?endpoint=collect_daily_credits
Descrição: Coleta créditos diários (se disponível). Delega para give_daily_tokens.php.
Resposta de Sucesso (200):

{
    "success": true,
    "message": "Créditos diários coletados.",
    "credits": 20
}

Resposta de Erro (403):

{
    "success": false,
    "message": "Créditos diários já coletados."
}

7. EXCLUIR CHAT

Exclui um chat.

Método: POST
URL: /api.php?endpoint=delete_chat
Descrição: Exclui um chat. Delega para delete_chat.php.
Corpo da Requisição (JSON):

{
    "chat_id": 123
}

Resposta de Sucesso (200):

{
    "success": true,
    "message": "Chat excluído com sucesso."
}

Resposta de Erro (500):

{
    "success": false,
    "message": "Erro ao excluir chat."
}

8. ATUALIZAR NOME DO CHAT

Atualiza o nome de um chat.

Método: POST
URL: /api.php?endpoint=update_chat_name
Descrição: Atualiza o nome de um chat. Delega para update_chat_name.php.
Corpo da Requisição (JSON):

{
    "chat_id": 123,
    "new_name": "Novo Nome"
}

Resposta de Sucesso (200):

{
    "success": true,
    "message": "Nome atualizado."
}

Resposta de Erro (500):

{
    "success": false,
    "message": "Erro ao atualizar nome."
}

9. ARQUIVAR CHAT

Arquiva um chat.

Método: POST
URL: /api.php?endpoint=archive_chat
Descrição: Arquiva um chat. Delega para archive_chat.php.
Corpo da Requisição (JSON):

{
    "chat_id": 123
}

Resposta de Sucesso (200):

{
    "success": true,
    "message": "Chat arquivado."
}

Resposta de Erro (500):

{
    "success": false,
    "message": "Erro ao arquivar chat."
}

10. CRIAR NOVO CHAT

Cria um novo chat.

Método: POST
URL: /api.php?endpoint=new_chat
Descrição: Cria um novo chat. Delega para novo_chat.php.
Resposta de Sucesso (200):

{
    "success": true,
    "chat_id": 124,
    "message": "Chat criado."
}

Resposta de Erro (500):

{
    "success": false,
    "message": "Erro ao criar chat."
}

11. ATUALIZAR MODELO DE LINGUAGEM

Força o modelo fixo agatha-v4b-2025.gguf.

Método: POST
URL: /api.php?endpoint=update_model
Descrição: Força o modelo fixo agatha-v4b-2025.gguf. Delega para update_model.php.
Corpo da Requisição (JSON):

{
    "model": "agatha-v4b-2025.gguf"
}

Resposta de Sucesso (200):

{
    "success": true,
    "message": "Modelo atualizado."
}

12. ATUALIZAR MODELO DE IMAGEM

Atualiza o modelo de imagem (validado).

Método: POST
URL: /api.php?endpoint=update_model_image
Descrição: Atualiza o modelo de imagem (validado). Delega para update_model_image.php.
Corpo da Requisição (JSON):

{
    "model_image": "Agatha_EpicRealism.safetensors"
}

Resposta de Sucesso (200):

{
    "success": true,
    "message": "Modelo de imagem atualizado."
}

13. EDITAR MENSAGEM

Edita uma mensagem.

Método: POST
URL: /api.php?endpoint=edit_message
Descrição: Edita uma mensagem. Delega para edit_message.php.
Corpo da Requisição (JSON):

{
    "message_id": 1,
    "chat_id": 123,
    "content": "Mensagem editada",
    "timestamp": "2025-10-04T12:04:00Z"
}

Resposta de Sucesso (200):

{
    "success": true,
    "message": "Mensagem editada."
}

Resposta de Erro (500):

{
    "success": false,
    "message": "Erro ao editar mensagem."
}

14. TREINAR IA

Treina a IA com pergunta e resposta.

Método: POST
URL: /api.php?endpoint=train_ai
Descrição: Treina a IA com pergunta e resposta. Delega para train_ai.php.
Corpo da Requisição (JSON):

{
    "question": "O que é IA?",
    "answer": "Inteligência Artificial é..."
}

Resposta de Sucesso (200):

{
    "success": true,
    "message": "Treinamento concluído."
}

Resposta de Erro (500):

{
    "success": false,
    "message": "Erro ao treinar IA."
}

Considerações Adicionais

Polling para Respostas: Após enviar uma mensagem, use o request_id para polling no endpoint check_response a cada 1-14 segundos, dependendo do tipo (texto, imagem ou vídeo).
Modo de Chat: Armazenado na sessão (chat_mode = 'default' ou 'train'); afeta o endpoint de chat usado.

AGATHA AI API DOCUMENTATION

Overview

All endpoints require authentication (except the initial login), and the language model is fixed at agatha-v4b-2025.gguf, while image models are limited to Agatha_EpicRealism.safetensors and Agatha_Dreams_Shaper_XL.safetensors.

Base URL: https://agathaai.ai/api.php?endpoint=
Authentication:
- First, log in via POST /login.php to obtain a session and the user_token cookie.
- All endpoints verify the session and login_token in the database.
- Headers: Include the user_token cookie in all requests after login.
Request/Response Formats: JSON or multipart/form-data (for image uploads). Responses always in JSON.
Common Errors:
- 401: Unauthorized (log in again).
- 400: Invalid or missing parameters.
- 403: Insufficient credits or forbidden action.
- 405: Incorrect HTTP method.
- 404: Endpoint not found.
- 500: Internal server error or endpoint failure.
Credit Consumption: Managed by the called PHP endpoints (e.g., chat.php deducts credits per message/image/video).
Models:
- Language: Always agatha-v4b-2025.gguf (fixed, ignores selections).
- Image: Only Agatha_EpicRealism.safetensors or Agatha_Dreams_Shaper_XL.safetensors (validated; defaults to the first if invalid).

INDEX

1. Authentication 2. Send Message 3. Check Response (Polling) 4. Get Chat History 5. Check Credits 6. Collect Daily Credits 7. Delete Chat 8. Update Chat Name 9. Archive Chat 10. Create New Chat 11. Update Language Model 12. Update Image Model 13. Edit Message 14. Train AI

1. AUTHENTICATION

Performs login and initiates session (not part of api.php, but essential).

Method: POST
URL: /login.php
Description: Performs login and initiates session.
Request Body (application/x-www-form-urlencoded or JSON):

{
    "email": "[email protected]",
    "password": "yourpassword"
}

Success Response (200):

{
    "status": "success",
    "message": "Login successful!"
}

Sets cookie: user_token (HttpOnly, expires in 30 days).
Error Response (400):

{
    "status": "error",
    "message": "Invalid email or password."
}

2. SEND MESSAGE

Sends a text or image message for processing.

Method: POST
URL: /api.php?endpoint=send_message
Description: Sends a text or image message for processing (uses chat.php or chat_train.php depending on the chat mode in the session). Supports additional context, request_id for polling, and image upload. Credit processing and response are delegated to the called endpoint.
Request Body (multipart/form-data for image; JSON for text):

{
    "message": "Message content",
    "message_search": "Additional context",
    "chat_id": 123,
    "request_id": "1234567890abc",
    "image_model": "Agatha_EpicRealism.safetensors",
    "image": ""
}

Success Response (200):

{
    "status": "success",
    "request_id": "1234567890abc",
    "chat_id": 123,
    "message": "Message sent, awaiting processing."
}

Error Response (403):

{
    "status": "error",
    "message": "Insufficient credits."
}

3. CHECK RESPONSE (POLLING)

Checks the status of a request via polling.

Method: GET
URL: /api.php?endpoint=check_response&request_id=
Description: Checks the status of a request (text, image, or video). Delegated to check_response.php.
Query Parameters:

{
    "request_id": "1234567890abc"
}

Success Response (200):

{
    "status": "completed",
    "reply": "Bot response or image/video URL",
    "progress": 100,
    "usage": {
        "total_tokens": 10
    }
}

Processing Response (200):

{
    "status": "processing",
    "progress": 50
}

Error Response (500):

{
    "status": "error",
    "message": "Error processing request."
}

4. GET CHAT HISTORY

Retrieves chat history and messages.

Method: GET
URL: /api.php?endpoint=get_chat_history
Description: Retrieves chat history and messages. Delegated to load_chats.php.
Success Response (200):

{
    "success": true,
    "chats": [
        {
            "chat_id": 123,
            "name": "Chat 123",
            "created_at": "2025-10-04 12:04:00",
            "messages": [
                {
                    "id": 1,
                    "content": "Hello, how are you?",
                    "sender": "user",
                    "timestamp": "2025-10-04 12:04:00"
                }
            ]
        }
    ]
}

Error Response (500):

{
    "success": false,
    "message": "Error loading history."
}

5. CHECK CREDITS

Returns the user's credit balance.

Method: GET
URL: /api.php?endpoint=get_credits
Description: Returns the user's credit balance. Delegated to get_credits.php.
Success Response (200):

{
    "credits": 10
}

Error Response (500):

{
    "success": false,
    "message": "Error checking credits."
}

6. COLLECT DAILY CREDITS

Collects daily credits (if available).

Method: POST
URL: /api.php?endpoint=collect_daily_credits
Description: Collects daily credits (if available). Delegated to give_daily_tokens.php.
Success Response (200):

{
    "success": true,
    "message": "Daily credits collected.",
    "credits": 20
}

Error Response (403):

{
    "success": false,
    "message": "Daily credits already collected."
}

7. DELETE CHAT

Deletes a chat.

Method: POST
URL: /api.php?endpoint=delete_chat
Description: Deletes a chat. Delegated to delete_chat.php.
Request Body (JSON):

{
    "chat_id": 123
}

Success Response (200):

{
    "success": true,
    "message": "Chat deleted successfully."
}

Error Response (500):

{
    "success": false,
    "message": "Error deleting chat."
}

8. UPDATE CHAT NAME

Updates the name of a chat.

Method: POST
URL: /api.php?endpoint=update_chat_name
Description: Updates the name of a chat. Delegated to update_chat_name.php.
Request Body (JSON):

{
    "chat_id": 123,
    "new_name": "New Name"
}

Success Response (200):

{
    "success": true,
    "message": "Name updated."
}

Error Response (500):

{
    "success": false,
    "message": "Error updating name."
}

9. ARCHIVE CHAT

Archives a chat.

Method: POST
URL: /api.php?endpoint=archive_chat
Description: Archives a chat. Delegated to archive_chat.php.
Request Body (JSON):

{
    "chat_id": 123
}

Success Response (200):

{
    "success": true,
    "message": "Chat archived."
}

Error Response (500):

{
    "success": false,
    "message": "Error archiving chat."
}

10. CREATE NEW CHAT

Creates a new chat.

Method: POST
URL: /api.php?endpoint=new_chat
Description: Creates a new chat. Delegated to novo_chat.php.
Success Response (200):

{
    "success": true,
    "chat_id": 124,
    "message": "Chat created."
}

Error Response (500):

{
    "success": false,
    "message": "Error creating chat."
}

11. UPDATE LANGUAGE MODEL

Forces the fixed model agatha-v4b-2025.gguf.

Method: POST
URL: /api.php?endpoint=update_model
Description: Forces the fixed model agatha-v4b-2025.gguf. Delegated to update_model.php.
Request Body (JSON):

{
    "model": "agatha-v4b-2025.gguf"
}

Success Response (200):

{
    "success": true,
    "message": "Model updated."
}

12. UPDATE IMAGE MODEL

Updates the image model (validated).

Method: POST
URL: /api.php?endpoint=update_model_image
Description: Updates the image model (validated). Delegated to update_model_image.php.
Request Body (JSON):

{
    "model_image": "Agatha_EpicRealism.safetensors"
}

Success Response (200):

{
    "success": true,
    "message": "Image model updated."
}

13. EDIT MESSAGE

Edits a message.

Method: POST
URL: /api.php?endpoint=edit_message
Description: Edits a message. Delegated to edit_message.php.
Request Body (JSON):

{
    "message_id": 1,
    "chat_id": 123,
    "content": "Edited message",
    "timestamp": "2025-10-04T12:04:00Z"
}

Success Response (200):

{
    "success": true,
    "message": "Message edited."
}

Error Response (500):

{
    "success": false,
    "message": "Error editing message."
}

14. TRAIN AI

Trains the AI with a question and answer.

Method: POST
URL: /api.php?endpoint=train_ai
Description: Trains the AI with a question and answer. Delegated to train_ai.php.
Request Body (JSON):

{
    "question": "What is AI?",
    "answer": "Artificial Intelligence is..."
}

Success Response (200):

{
    "success": true,
    "message": "Training completed."
}

Error Response (500):

{
    "success": false,
    "message": "Error training AI."
}

Additional Considerations

Polling for Responses: After sending a message, use the request_id for polling on the check_response endpoint every 1-14 seconds, depending on the type (text, image, or video).
Chat Mode: Stored in the session (chat_mode = 'default' or 'train'); affects the chat endpoint used.