Documentação da API Danki Mind

Integre a inteligência artificial Danki Mind em seus aplicativos e serviços

Endpoints

Autenticação

Todas as chamadas à API pública do Danki Mind exigem autenticação usando uma chave de API (API key). Esta chave deve ser incluída em todas as requisições para identificar e autorizar o seu acesso.

Como obter uma API key

Para obter sua API key, entre em contato com nossa equipe através do email api@dankimind.com.br ou acesse sua conta no Portal do Desenvolvedor.

Como usar sua API key

Existem duas maneiras de incluir sua API key nas requisições:

1. Header de Autenticação (Recomendado)
Authorization: Bearer SUA_API_KEY_AQUI
2. Parâmetro na Requisição
{
  "api_key": "SUA_API_KEY_AQUI",
  "message": "Olá, Danki Mind!"
}

Limites de Uso

Plano Requisições/minuto Requisições/dia
Desenvolvedor 10 1.000
Profissional 60 10.000
Empresarial 300 100.000

Tipos de Rotas

O Danki Mind possui dois tipos de rotas para diferentes casos de uso:

1. Rotas da API Pública

As rotas com prefixo /api/ são destinadas à integração externa e exigem autenticação com API key. Use estas rotas para integrar o Danki Mind em seus próprios aplicativos e serviços.

Rota Descrição Requer API Key
/api/chat Chat simples em formato JSON Sim
/api/chat/stream Chat com streaming de resposta Sim
/api/benchmark Dados de benchmark Sim
/api/conversation_summary Resumo de conversas Sim
/api/web_search Busca na web Sim

2. Rotas Específicas do Site

As rotas com prefixo /site/ são destinadas exclusivamente ao uso pela interface web do Danki Mind e não exigem autenticação externa. Estas rotas não devem ser utilizadas para integração externa.

Rota Descrição Uso
/site/chat Chat simples para interface web Apenas para o site
/site/chat/stream Chat com streaming para interface web Apenas para o site
/site/conversation_summary Resumo de conversas para interface web Apenas para o site
/site/web_search Busca na web para interface web Apenas para o site

POST Chat

/api/chat
Envia uma mensagem para o Danki Mind e recebe uma resposta. Este endpoint é recomendado para interações simples e rápidas.

Parâmetros (JSON)

Nome Tipo Descrição Obrigatório
message String A mensagem a ser enviada para o Danki Mind Sim

Exemplo de Requisição

{
  "api_key": "SUA_API_KEY_AQUI",
  "message": "Quais são as vantagens de usar TypeScript?"
}

Exemplo de Resposta

{
  "response": "TypeScript oferece várias vantagens como tipagem estática, melhor autocomplete nos IDEs, detecção de erros em tempo de compilação, interfaces e tipos personalizados, melhor documentação do código, e compatibilidade total com JavaScript. Estas características tornam o desenvolvimento mais robusto, especialmente em projetos maiores com múltiplos desenvolvedores."
}

POST Chat Stream

/api/chat/stream
Envia uma mensagem para o Danki Mind e recebe a resposta de forma progressiva (streaming). Este endpoint é recomendado para criar uma experiência mais interativa, onde a resposta aparece gradualmente.

Parâmetros (JSON)

Nome Tipo Descrição Obrigatório
message String A mensagem a ser enviada para o Danki Mind Sim
debug_mode Boolean Se verdadeiro, inclui informações detalhadas sobre tokens na resposta Não

Exemplo de Requisição

{
  "api_key": "SUA_API_KEY_AQUI",
  "message": "Como criar uma API REST com Node.js?",
  "debug_mode": false
}

Formato da Resposta (Server-Sent Events)

// Evento inicial
data: {"start": true, "input_tokens": 8, "debug_mode": false, "user_tokens": null}

// Chunks de texto (podem ser múltiplos)
data: {"chunk": "Para criar uma API REST com Node.js, você pode seguir estes passos:"}
data: {"chunk": "\n\n1. Instale o Node.js e npm"}
data: {"chunk": "\n2. Crie um novo projeto com `npm init`"}
// ... mais chunks ...

// Evento final
data: {"done": true, "input_tokens": 8, "output_tokens": 120, "total_tokens": 128, "response_tokens": null}

GET Benchmark

/api/benchmark
Retorna dados de benchmark comparativos entre o Danki Mind e outros modelos de IA disponíveis no mercado.

Parâmetros

Este endpoint não requer parâmetros.

Exemplo de Resposta

{
  "models": ["Danki Mind", "GPT-4", "Claude 3", "DeepSeek"],
  "categories": ["Raciocínio", "Conhecimento", "Criatividade", "Programação", "Velocidade"],
  "data": [
    [87, 85, 92, 88, 90], // Danki Mind
    [95, 92, 88, 94, 75], // GPT-4
    [93, 90, 86, 91, 80], // Claude 3
    [78, 77, 72, 81, 85] // DeepSeek
  ]
}

POST Resumo de Conversa

/api/conversation_summary
Gera um resumo conciso de uma conversa entre o usuário e o Danki Mind.

Parâmetros (JSON)

Nome Tipo Descrição Obrigatório
conversation Array Array de objetos representando a conversa, com propriedades "role" e "content" Sim

Exemplo de Requisição

{
  "api_key": "SUA_API_KEY_AQUI",
  "conversation": [
    {"role": "user", "content": "Como posso melhorar a performance do meu site?"},
    {"role": "assistant", "content": "Existem várias maneiras de melhorar a performance do seu site..."},
    {"role": "user", "content": "E quanto à otimização de imagens?"}
  ]
}

Exemplo de Resposta

{
  "summary": "Conversa sobre técnicas para melhorar a performance de um site, com foco em otimização de imagens."
}