Documentación de la API de Dolphin ai

Configuración de autenticación y URL base

Las claves API autentican tus solicitudes prepagadas al instante. Recibes una clave activa por cuenta, reemplazando cualquier clave anterior al generarse. La URL base apunta al servicio alojado.

• URL Base: HTTPS://api.aidolphin.cc/v1
• Encabezado: Authorization: Bearer YOUR_API_KEY

Copycurl https://api.aidolphin.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five open source inference engines"}]
  }'

Enviar una solicitud básica de completado de chat

Envía cargas útiles JSON estándar al punto de conexión de finalización de chat. El ID del modelo es siempre "sin censura" para una salida de texto consistente. Los tokens de entrada cuestan $0.15 por millón, mientras que los tokens de salida cuestan $0.50 por millón.

• Modelo: uncensored
• Salida máxima: 16.000 tokens

Copyfrom openai import OpenAI

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

Respuestas en streaming con Server-Sent Events

Habilita la transmisión estableciendo stream: true en tu solicitud. La API devuelve datos mediante Eventos Enviados por Servidor (SSE) para la entrega de tokens en tiempo real. Los detalles de uso de tokens aparecen en el último fragmento del flujo.

Copyimport OpenAI from "openai";

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

Imposición del modo JSON para datos estructurados

Usar response_format establecido a {"type": "json_object"} para forzar una salida estructurada. Esto garantiza que el modelo devuelva JSON válido sin formato de markdown adicional. La llamada de funciones y las definiciones de herramientas también dependen de esta estructura JSON.

Configurando temperature, top_p y secuencias de parada

Ajustar los parámetros de muestreo para controlar la aleatoriedad y la longitud de la salida. Establecer temperature para la creatividad, top_p para muestreo por núcleo, y stop secuencias para truncar la salida temprano. Las penalizaciones de presencia y frecuencia ayudan a reducir la repetición de frases.

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 los límites de tasa y las cuotas

Cada clave de API permite 300 solicitudes por minuto y 8 solicitudes concurrentes. El tamaño máximo del cuerpo de la solicitud es de 8 MB. Los errores y rechazos no consumen tu crédito prepagado. Si excedes los límites, recibirás un código de estado 429.