Dolphin sin censura API Documentación

Prerrequisitos y configuración del entorno

Comienza asegurándote de que tu entorno tenga las dependencias necesarias instaladas antes de realizar cualquier solicitud. Necesitarás una clave API activa de nuestro panel y un entorno de ejecución compatible como Python o Node.js. Nuestra API requiere que envíes solicitudes a una URL base específica en lugar del endpoint predeterminado de OpenAI.

Mantén tu clave API segura y almacénala en una variable de entorno. Esto evita la exposición accidental en tu repositorio de código. Puedes generar una nueva clave al instante después de registrarte con Google o correo electrónico.

No necesitas configurar enrutamiento complejo ni seleccionar modelos específicos. El endpoint sirve un único modelo de lenguaje grande sin censura diseñado para la salida directa de texto.

Instalación del SDK oficial de OpenAI

Instala el paquete SDK oficial para manejar la autenticación y el formato de solicitudes automáticamente. Esta biblioteca soporta entornos de Python y Node.js con interfaces consistentes.

Para usuarios de Python, ejecuta el comando estándar pip install para añadir la biblioteca a tu entorno virtual. Los desarrolladores de Node.js deben usar npm para instalar el paquete equivalente.

El SDK gestiona la estructura del payload JSON por ti, por lo que solo necesitas centrarte en el contenido del prompt y parámetros como la temperatura o top_p.

Puedes verificar la instalación importando la biblioteca en tu script o módulo. Esto asegura que el cliente esté listo para conectarse a nuestros servidores.

Configurando URL base y clave API

Apunta tu cliente SDK a nuestra URL base específica para enrutar solicitudes a nuestra infraestructura sin censura. Usa https://api.dolphinuncensored.com/v1 como tu punto final.

Configura tu clave de API en la cabecera de autorización o en el objeto de configuración del cliente. El cliente adjuntará esta clave a cada solicitud automáticamente.

Asegúrate de especificar el ID de modelo como "uncensored" en tu configuración. Esto le dice al servidor qué versión del modelo usar para tu generación.

Realizando tu primera completación de chat

Envía un mensaje simple para verificar la conectividad y recibir una respuesta. Esto confirma que tu clave es válida y que el extremo es accesible.

Utiliza el endpoint chat-completions con un prompt de sistema y un mensaje de usuario. La respuesta contendrá el texto generado en el campo content.

Comprender la transmisión y el uso de tokens

Habilita el streaming para recibir tokens a medida que se generan en lugar de esperar la respuesta completa. Esto mejora la latencia percibida para salidas largas.

La API devuelve estadísticas de uso en el último fragmento del stream. Puedes rastrear los recuentos de tokens de entrada y salida para una facturación transparente.

Establece el parámetro stream a true en el cuerpo de tu solicitud. Itera a través de los fragmentos para construir tu texto final o procesarlo en tiempo real.

Manejo de errores y rechazos

Gestiona los errores HTTP 401 verificando que tu clave API sea correcta y no haya expirado. Un error 402 indica que falta crédito prepagado; recarga mediante criptomonedas para continuar.

Un estado 429 significa que has alcanzado el límite de velocidad de 300 solicitudes por minuto. Espera un momento antes de reintentar o reduce tu concurrencia.

El modelo rechaza solicitudes que involucren contenido sexual con menores, que es un límite estricto. Otros temas controversiales o adultos se permiten generalmente. Los errores y rechazos no consumen tu crédito de tokens.

cURL

Copycurl https://api.dolphinuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the list of installed python packages"}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.dolphinuncensored.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)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.dolphinuncensored.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);

Transmisión

Copystream = 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)