Dolphin AI API Quickstart

Autenticación y URL base

Tu clave de API autentica cada solicitud. Usa la URL base https://api.dolphinaimodels.com/v1 para todos los endpoints. El sistema requiere una clave válida en el Authorization header. Sin él, las solicitudes fallan inmediatamente.

Genera tu clave a través del panel de control. Recibes una clave activa por cuenta. Reemplaza tu clave antigua si generas una nueva. La clave otorga acceso inmediato al modelo sin censura.

Enviar una Solicitud de Completación de Chat

Envía una solicitud POST a /v1/chat/completions. El ID del modelo es uncensored. Este endpoint maneja entrada de texto y devuelve salida de texto. Puedes ajustar parámetros como la temperatura y el top_p.

Aquí tienes un ejemplo básico de cURL para comenzar:

Copycurl https://api.dolphinaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summit elevation is 29032 feet."}]
  }'

Integración del SDK de Python

Usa la biblioteca oficial de Python de OpenAI. Señálala a nuestra URL base. Pasa tu clave de API. La estructura del código refleja el uso estándar de OpenAI. Esto asegura una migración fácil para proyectos existentes.

Configura el cliente con estos valores:

Copyfrom openai import OpenAI

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

Configuración del SDK Node

Inicializa el cliente de Node.js de manera similar. Establece la URL base y la clave de API. El SDK maneja la serialización automáticamente. Este enfoque funciona tanto para aplicaciones del lado del servidor como del lado del cliente.

Configuración de ejemplo:

Copyimport OpenAI from "openai";

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

Gestión de respuestas en streaming

Habilita la transmisión estableciendo stream: true. La API devuelve Eventos Enviados por Servidor (SSE). Cada fragmento contiene texto parcial. El último fragmento incluye datos de uso de tokens. Esto reduce la latencia percibida para los usuarios.

Transmite la respuesta:

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)

Comprender límites y errores

La ventana de contexto es de 100.000 tokens. Esto incluye el prompt y la respuesta. La salida máxima es de 16.000 tokens por solicitud. Los errores devuelven códigos HTTP estándar. 401 indica una clave inválida. 402 significa crédito insuficiente. 429 indica limitación de velocidad.

Estás limitado a 300 solicitudes por minuto. La concurrencia está limitada a 8 solicitudes simultáneas. Mantén los cuerpos de las solicitudes por debajo de 8 MB. Estos límites garantizan un rendimiento estable para tu carga de trabajo.