Documentação da API

Minhas API Keys

Tokens disponíveis: 0 Tokens

#	API Key	Criado em	Ações

Introdução

A API da Explika Ai permite que você envie mensagens para processamento inteligente e obtenha respostas contextuais.

URL da API: https://explika.ao/api.php

Modelo: explika_ai #O modelo varia de acordo a entidade (orienta, sobahost, etc).

Estrutura da Requisição

Método: POST

Parâmetros esperados (via application/x-www-form-urlencoded):

api_key - sua chave de autenticação
instruct - instruções gerais
message - mensagem do usuário
model - modelo solicitado: orienta
version - versão do modelo
history - histórico da conversa (string json). Exempo: {"sender":"user","type":"text","value":"O meu nome de registo é Nuno Daniel, mas as pessoas tratam-me por ARAGAMI"},{"sender":"model","type":"text","value":"Aragami soa mais legal, então vou passar a tratar-te por Aragami"}. Obs: apenas os 4 últimos itens no histórico são considerados, o resto é ignorado.

Estrutura da Resposta

Retorno em JSON com os seguintes campos:

request_id: ID da requisição
response: resposta gerada
context: intenção identificada
msg_type: tipo da mensagem (fixo: 1)
content_type: tipo de conteúdo (fixo: texto_padrao)
origem: origem do conteúdo (ex: Response Files)
similarity: grau de similaridade

Exemplos de Uso

cURL


                    history='{"sender":"user","type":"text","value":"string"},{"sender":"model","type":"text","value":"string"}'
                    curl -X POST https://orienta.ao/api.php\
                    -d "api_key=SUA_API_KEY"\
                    -d "instruct=Responda como especialista"\
                    -d "message=O que é o Orienta?"\
                    -d "model=gpt"\
                    -d "version=1.0"\
                    -d "$history"

PHP


                    $history = '{"sender":"user","type":"text","value":"string"},{"sender":"model","type":"text","value":"string"}';
                    $data = [
                      'api_key' => 'SUA_API_KEY',
                      'instruct' => 'Responda como especialista',
                      'message' => 'O que é o Orienta?',
                      'model' => 'orienta',
                      'version' => '1.0',
                      'history' => $history
                    ];
                    $ch = curl_init('https://orienta.ao/api.php');
                    curl_setopt($ch, CURLOPT_POST, true);
                    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
                    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
                    $response = curl_exec($ch);
                    curl_close($ch);
                    echo $response;

JAVASCRIPT


                    const history = '{"sender":"user","type":"text","value":"string"},{"sender":"model","type":"text","value":"string"}';
                    const formData = new URLSearchParams();
                    formData.append("api_key", "SUA_API_KEY");
                    formData.append("instruct", "Responda como especialista");
                    formData.append("message", "O que é o Orienta?");
                    formData.append("model", "orienta");
                    formData.append("version", "1.0");
                    formData.append(history);
            
                    fetch("https://orienta.ao/api.php", {
                      method: "POST",
                      headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
                      body: formData.toString()
                    })
                    .then(res => res.json())
                    .then(data => console.log(data));

PYTHON


                    import requests
                    history_string = '{"sender":"user","type":"text","value":"string"},{"sender":"model","type":"text","value":"string"}'
                    payload = {
                        "api_key": "SUA_API_KEY",
                        "instruct": "Responda como especialista",
                        "message": "O que é o Orienta?",
                        "model": "orienta",
                        "version": "1.0",
                        "history": history_string
                    }
            
                    response = requests.post("https://orienta.ao/api.php", data=payload)
                    print(response.json())

LARAVEL


                    use Illuminate\Support\Facades\Http;
                    $history = '{"sender":"user","type":"text","value":"string"},{"sender":"model","type":"text","value":"string"}';
                    $response = Http::asForm()->post('https://orienta.ao/api.php', [
                        'api_key' => 'SUA_API_KEY',
                        'instruct' => 'Responda como especialista',
                        'message' => 'O que é o Orienta?',
                        'model' => 'orienta',
                        'version' => '1.0',
                        'history' => $history
                    ]);
            
                    dd($response->json());