Avvio rapido API Mukenetsu AI

Configurazione base e URL di base

Mukenetsu AI è progettato come API REST compatibile con OpenAI. Puoi usare client e SDK OpenAI esistenti con modifiche minime. Usa il seguente URL di base per comunicare con l'API.

https://api.mukenetsuapi.com/v1

A differenza di altri servizi LLM, non devi scegliere tra endpoint complessi o configurare aggiuntivamente. Vengono forniti solo un endpoint di completamento chat e un endpoint per l'elenco dei modelli. Questa struttura semplice permette di sviluppare rapidamente.

La chiave API si ottiene immediatamente durante la registrazione con email e password nella pagina Get API key. Non serve il dashboard. Inoltre, valorizziamo la privacy: i dati del prompt non vengono utilizzati per l'addestramento del modello.

Autenticazione e chiave API

L'accesso all'API richiede l'autenticazione tramite l'intestazione Authorization: Bearer <API_KEY>. Usa la chiave generata alla creazione dell'account. Ogni account ha una sola chiave, ma puoi rigenerarla in qualsiasi momento. Rigenerando la chiave, quella precedente diventa invalida.

In caso di errore di autenticazione, ricevi solitamente 401 (Unauthorized) o 402 (Payment Required). 401 indica chiave errata o invalidata; 402 significa credito insufficiente. Il credito è prepagato e può essere ricaricato con criptovalute (USDT, USDC) da $10 in su.

Endpoint chat completions

L'endpoint principale per la generazione di testo è POST /v1/chat/completions. Inviando una richiesta a questo endpoint puoi generare testo includendo la cronologia delle conversazioni e il prompt di sistema. Specifica uncensored come ID del modello. Si tratta di un modello a pesi aperti unico, diverso dai modelli GPT di OpenAI o di altri fornitori.

L'esempio seguente mostra come generare testo di base usando curl. I parametri necessari sono l'ID del modello, i messaggi e opzionalmente l'attivazione dello 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."}]
  }'

Questo endpoint non offre embedding, generazione di immagini o conversione vocale. È specializzato esclusivamente nel completamento e nella generazione di testo.

Streaming (SSE)

Se desideri ricevere il testo generato in tempo reale, puoi utilizzare la modalità streaming. Includendo "stream": true nella richiesta, il server restituisce i dati in sequenza in formato Server-Sent Events (SSE). In questo modo l'utente può visualizzare parte del testo prima che la generazione sia completa.

Se usi l'SDK Python di OpenAI o la libreria client Node.js, specifica semplicemente stream=True per abilitare automaticamente lo streaming. Il gestore degli eventi riceverà chunk per 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)

Lo streaming migliora l'esperienza utente per risposte lunghe o applicazioni interattive. Tuttavia, se la connessione si interrompe durante lo streaming, non riceverai più eventi.

Strumenti / Chiamate di funzioni

L'API Mukenetsu AI supporta le chiamate di funzioni (strumenti). Ciò facilita l'integrazione con API esterne o database. Aggiungi il campo tools e il parametro tool_choice al corpo della richiesta per far eseguire al modello una funzione specifica.

Il modello decide se chiamare una funzione o restituire testo normale. Una volta completata la chiamata, aggiungi il risultato della funzione a messages e passalo al modello per ottenere risposte più dettagliate.

コピー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);

Questa funzione è utile per applicazioni di tipo agente o automazione di compiti complessi. Grazie alla compatibilità con OpenAI, puoi riutilizzare direttamente la logica esistente per le chiamate di strumenti.

Limiti di richiesta e vincoli

L'uso dell'API è soggetto ai seguenti limiti: massimo 300 richieste al minuto e dimensione massima del corpo della richiesta di 8 MB. Superati questi limiti, riceverai un errore 429 (Too Many Requests). La finestra di contesto è di 100.000 token (totale prompt + testo generato). Per conversazioni o documenti più lunghi, suddividili correttamente.

Per ricevere le risposte in streaming, segui questo flusso di eventi.

コピー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)

I contenuti sessuali con minori sono rigorosamente limitati per conformità legale. Altri contenuti per adulti legali, finzione, ricerca sulla sicurezza e argomenti controversi sono generati senza censura.