Tina AI 🤖

Assistente de IA conversacional powered by Gemini 2.5 Flash

Criar Nova Sessão

POST/api/tina/session/new

Cria uma nova sessão de conversa com a Tina AI.

Body (JSON)

Campo	Tipo	Obrigatório	Descrição
session_name	string	Não	Nome personalizado para a sessão

Exemplo de Requisição

bash

curl -X POST https://api.alauda.mz/api/tina/session/new \
  -H "X-API-Key: sua_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "session_name": "Conversa sobre programação"
  }'

Resposta

json

{
  "success": true,
  "message": "Sessão criada com sucesso",
  "data": {
    "session_id": "sess_abc123xyz",
    "session_name": "Conversa sobre programação",
    "created_at": "2024-01-15T10:30:00Z",
    "expires_at": "2024-01-15T12:30:00Z"
  }
}

Custo: Sem consumo de créditos

Enviar Mensagem

POST/api/tina/chat

Envia uma mensagem para a Tina AI e recebe a resposta.

Body (JSON)

Campo	Tipo	Obrigatório	Descrição
session_id	string	Sim	ID da sessão de conversa
message	string	Sim	Mensagem do usuário (máx. 10.000 caracteres)

Exemplo de Requisição

bash

curl -X POST https://api.alauda.mz/api/tina/chat \
  -H "X-API-Key: sua_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "session_id": "sess_abc123xyz",
    "message": "Como criar uma API REST com Node.js?"
  }'

Python (requests)

python

import requests

headers = {
    'X-API-Key': 'sua_api_key_aqui',
    'Content-Type': 'application/json'
}

data = {
    'session_id': 'sess_abc123xyz',
    'message': 'Como criar uma API REST com Node.js?'
}

response = requests.post(
    'https://api.alauda.mz/api/tina/chat',
    headers=headers,
    json=data
)

result = response.json()
print(result['data']['response'])

Resposta

json

{
  "success": true,
  "data": {
    "response": "Para criar uma API REST com Node.js, você pode usar o framework Express...",
    "session_id": "sess_abc123xyz",
    "message_count": 3,
    "credits_remaining": 4495
  }
}

Custo: 5 créditos por mensagem

Listar Sessões

GET/api/tina/sessions

Lista todas as sessões de conversa do usuário.

Exemplo de Requisição

bash

curl -X GET "https://api.alauda.mz/api/tina/sessions" \
  -H "X-API-Key: sua_api_key_aqui"

Resposta

json

{
  "success": true,
  "data": {
    "sessions": [
      {
        "session_id": "sess_abc123xyz",
        "session_name": "Conversa sobre programação",
        "message_count": 12,
        "created_at": "2024-01-15T10:30:00Z",
        "last_activity": "2024-01-15T11:45:00Z"
      },
      {
        "session_id": "sess_def456uvw",
        "session_name": "Ajuda com matemática",
        "message_count": 5,
        "created_at": "2024-01-14T09:00:00Z",
        "last_activity": "2024-01-14T09:30:00Z"
      }
    ],
    "total": 2
  }
}

Buscar Histórico

GET/api/tina/history/:session_id

Retorna o histórico de mensagens de uma sessão (últimas 20 mensagens).

Parâmetros

Campo	Tipo	Obrigatório	Descrição
session_id	string	Sim	ID da sessão (parâmetro na URL)

Exemplo de Requisição

bash

curl -X GET "https://api.alauda.mz/api/tina/history/sess_abc123xyz" \
  -H "X-API-Key: sua_api_key_aqui"

Resposta

json

{
  "success": true,
  "data": {
    "session_id": "sess_abc123xyz",
    "messages": [
      {
        "role": "user",
        "content": "Olá, Tina!",
        "timestamp": "2024-01-15T10:31:00Z"
      },
      {
        "role": "assistant",
        "content": "Olá! Como posso te ajudar hoje?",
        "timestamp": "2024-01-15T10:31:02Z"
      }
    ],
    "total_messages": 2
  }
}

Deletar Sessão

DELETE/api/tina/session/:session_id

Deleta uma sessão de conversa e todo o seu histórico.

Parâmetros

Campo	Tipo	Obrigatório	Descrição
session_id	string	Sim	ID da sessão (parâmetro na URL)

Exemplo de Requisição

bash

curl -X DELETE "https://api.alauda.mz/api/tina/session/sess_abc123xyz" \
  -H "X-API-Key: sua_api_key_aqui"

Resposta

json

{
  "success": true,
  "message": "Sessão deletada com sucesso"
}

Stats da Sessão

GET/api/tina/stats/:session_id

Retorna estatísticas detalhadas de uma sessão de conversa.

Exemplo de Requisição

bash

curl -X GET "https://api.alauda.mz/api/tina/stats/sess_abc123xyz" \
  -H "X-API-Key: sua_api_key_aqui"

Resposta

json

{
  "success": true,
  "data": {
    "session_id": "sess_abc123xyz",
    "session_name": "Conversa sobre programação",
    "total_messages": 12,
    "user_messages": 6,
    "assistant_messages": 6,
    "total_credits_used": 30,
    "created_at": "2024-01-15T10:30:00Z",
    "last_activity": "2024-01-15T11:45:00Z"
  }
}

Funcionalidades

✓
Conversas com Histórico
A Tina mantém o contexto da conversa usando as últimas 20 mensagens
✓
Múltiplas Sessões
Crie várias sessões para diferentes conversas ou temas
✓
Mensagens Longas
Suporte para mensagens de até 10.000 caracteres
✓
Limpeza Automática
Sessões inativas são removidas automaticamente após 2 horas

🤖

Powered by Gemini 2.5 Flash

A Tina AI utiliza o modelo Gemini 2.5 Flash do Google, oferecendo respostas rápidas e inteligentes para uma variedade de perguntas e tarefas.

⚠️

Limitações

• Máximo de 10.000 caracteres por mensagem
• Contexto baseado nas últimas 20 mensagens da sessão
• Sessões expiram após 2 horas de inatividade