Guía de integración de Dolphin AI

Prerrequisitos: configuración del SDK y la clave API

Instala el SDK oficial para tu lenguaje. Crea una cuenta mediante correo electrónico o inicio de sesión con Google en nuestro panel. Genera tu clave de API de inmediato. No se requiere número de teléfono. La clave aparece una vez en pantalla. Guárdala de forma segura. No almacenamos tu método de pago. Las recargas con criptomonedas usan USDT o USDC. El crédito nunca expira. Los errores no cuestan nada. Pagas solo por los tokens utilizados.

Configuración de la URL base y los encabezados

Apunta a nuestro cliente a la URL base. Establece el encabezado de autorización con tu clave. Usa el ID del modelo "uncensored". Esto asegura que accedas a nuestro modelo uncensored. No es GPT ni Claude. El endpoint acepta finalizaciones de chat estándar. Los encabezados deben incluir la clave de API. Otros campos son opcionales. Temperature y top_p funcionan como se espera. Soportamos parámetros estándar de OpenAI. Consulta la documentación para ver los límites.

Copycurl https://api.dolphinllmmodel.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the max token limit for this endpoint?"}]
  }'

Enviar tu primera solicitud de completado de chat

Envía una solicitud POST con tus mensajes. Incluye el prompt de sistema para el contexto. Define el contenido del mensaje del usuario. El modelo devuelve una respuesta de texto. Puedes especificar el máximo de tokens. La salida predeterminada es de 2,048 tokens. Establece límites más altos si es necesario. La ventana de contexto es de 100,000 tokens. La entrada y la salida comparten este límite. Asegúrate de que tu prompt quepa. Los errores devuelven códigos JSON estándar. Verifica el cuerpo de la respuesta para errores.

Copyfrom openai import OpenAI

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

Habilitar streaming para respuestas en tiempo real

Establece streaming en true en tu solicitud. La API devuelve fragmentos mediante SSE. Cada fragmento contiene texto parcial. Procesa los tokens a medida que llegan. Esto reduce la latencia percibida. Obtienes retroalimentación inmediata. El último fragmento incluye el uso de tokens. Monitorea el uso para el seguimiento de costos. El streaming funciona con todos los parámetros. Las herramientas y el modo JSON también se transmiten. Maneja las caídas de conexión con gracia. Reconecta si el flujo falla.

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)

Usando herramientas y llamada de funciones

Define esquemas de función en tu solicitud. Pásalos como herramientas a la API. El modelo devuelve llamadas a herramientas. Analiza los argumentos para su ejecución. Reenvía los resultados al modelo. Esto habilita flujos de trabajo complejos. El soporte es del formato estándar de OpenAI. La elección de herramientas puede ser automática. Puedes forzar herramientas específicas. El modo JSON funciona también con herramientas. Asegúrate de que tu esquema sea válido. Los esquemas inválidos causan errores. Prueba primero con funciones simples.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.dolphinllmmodel.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 límites de velocidad y errores

Aplicamos un límite de 300 solicitudes por minuto. Las solicitudes concurrentes están limitadas a ocho. Los cuerpos de las solicitudes deben tener menos de 8 MB. Un error 401 significa una clave no válida. Comprueba tu cabecera de autenticación. Un error 402 indica que no hay crédito. Recarga con cripto para continuar. 429 significa que has alcanzado el límite de velocidad. Espera y reintenta con retroceso exponencial. Los errores son gratuitos. Solo los tokens completados cuestan crédito. El contexto es de 100.000 tokens en total.