Início rápido da API Mukenetsu AI

Configuração básica e URL base

A Mukenetsu AI é projetada como uma API REST compatível com OpenAI. Isso permite que você use clientes e SDKs OpenAI existentes com mínimas alterações. Para se comunicar com a API, use as URLs base a seguir.

https://api.mukenetsuapi.com/v1

Ao contrário de outros serviços LLM, não há necessidade de escolher endpoints complexos ou fazer configurações adicionais. Apenas um endpoint de conclusão de chat e um endpoint de listagem de modelos são fornecidos. Essa estrutura simples permite que o desenvolvimento avance rapidamente.

A chave de API é obtida imediatamente após o cadastro, na página Get API key, usando e-mail e senha. Não é necessário operar no painel. Além disso, priorizamos sua privacidade: os dados do prompt não são usados para treinar o modelo.

Autenticação e chave de API

O acesso à API requer autenticação por meio do cabeçalho Authorization: Bearer <API_KEY>. Use a chave de API gerada ao criar a conta na Mukenetsu AI. Uma chave de API é atribuída por conta, mas você pode regenerá-la a qualquer momento conforme necessário. Ao regenerar a chave, a chave anterior será invalidada, portanto, tome cuidado.

Se ocorrer um erro de autenticação, geralmente será retornada uma resposta 401 (Não autorizado) ou 402 (Pagamento necessário). 401 indica que a chave está incorreta ou foi invalidada; 402 significa que o saldo de crédito da sua conta está insuficiente. O crédito é pré-pago e pode ser recarregado a partir de US$ 10 usando criptomoedas (USDT e USDC).

Endpoint de conclusão de chat

O endpoint principal para geração de texto é POST /v1/chat/completions. Ao enviar uma requisição para este endpoint, você pode gerar texto incluindo histórico de conversas e prompts de sistema. Especifique o ID do modelo como uncensored. Este é um modelo de pesos abertos proprietário, diferente dos modelos GPT da OpenAI ou de outros fornecedores.

O exemplo abaixo mostra como realizar uma geração de texto básica usando curl. Os parâmetros necessários são o ID do modelo, as mensagens e, opcionalmente, a ativação do streaming.

コピーcurl https://api.mukenetsuapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Neste endpoint, não são fornecidas funcionalidades como embeddings, geração de imagens ou conversão de áudio. O foco é exclusivamente na conclusão e geração de texto.

Streaming (SSE)

Se você deseja obter o texto gerado em tempo real, pode usar o modo de streaming. Ao incluir "stream": true na requisição, o servidor retorna dados sequencialmente no formato Server-Sent Events (SSE). Isso permite que o usuário exiba parte do texto antes que a geração seja concluída.

Se você estiver usando a SDK OpenAI para Python ou a biblioteca cliente para Node.js, o processamento de streaming será realizado automaticamente ao especificar a opção stream=True. O manipulador de eventos receberá chunks por token.

コピーfrom openai import OpenAI

client = OpenAI(base_url="https://api.mukenetsuapi.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

O streaming é uma funcionalidade importante para melhorar a experiência do usuário em respostas longas ou aplicativos interativos. No entanto, se a conexão for interrompida durante o streaming, você não poderá receber eventos subsequentes.

Ferramentas/chamada de funções

A API Mukenetsu AI suporta chamada de funções (ferramentas). Isso facilita a integração com APIs externas ou bancos de dados. Ao incluir o campo tools e o parâmetro tool_choice no corpo da requisição, você pode fazer com que o modelo execute uma função específica.

O modelo decide se deve chamar uma função ou retornar texto normal conforme necessário. Após a conclusão da chamada, você pode obter uma resposta mais detalhada adicionando o resultado da função a messages e passando-o ao modelo.

コピーimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.mukenetsuapi.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Esta funcionalidade é particularmente útil para aplicativos do tipo agente ou automação de tarefas complexas. Como adotamos o formato compatível com OpenAI, você pode reutilizar diretamente a lógica existente de chamada de funções.

Limite de requisições e restrições

O uso da API está sujeito às seguintes limitações: máximo de 300 requisições por minuto e tamanho máximo do corpo da requisição de 8 MB. Ao exceder esses limites, será retornado o erro 429 (Too Many Requests). A janela de contexto é de 100.000 tokens (total de prompt + texto gerado). Conversas ou documentos longos que excedam esse limite devem ser divididos adequadamente antes do envio.

Ao receber respostas de streaming, siga o fluxo de eventos abaixo.

コピーstream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Além disso, o conteúdo sexual envolvendo menores é estritamente limitado devido ao cumprimento das leis. Outros conteúdos adultos legais, ficção, pesquisa de segurança e tópicos controversos são gerados sem censura.