Una API: Guía de inicio rápido

URL base y autenticación

Empieza apuntando tu cliente a nuestro endpoint dedicado. Esta API compatible con OpenAI usa cabeceras de autenticación estándar, así que solo necesitas cambiar dos valores en tu configuración.

La URL base es https://api.onekeyllmapi.com/v1. Genera tu clave de API única en la página de registro. No se requiere tarjeta para empezar y la clave se muestra inmediatamente tras el registro. Mantén esta clave segura; autentica todas las peticiones al servicio.

Completado básico

Envía un prompt de texto simple para recibir una respuesta directa. Esta es la base de nuestra oferta de API de IA para desarrolladores. El modelo devuelve texto sin rechazos por contenido para uso adulto lícito, lo que lo hace ideal para tareas creativas o sin restricciones.

• ID del modelo: uncensored
• Endpoint: POST /v1/chat/completions
• Contexto: 100.000 tokens

Realiza tu primera petición con este ejemplo:

Copycurl https://api.onekeyllmapi.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."}]
  }'

Integración con SDK de Python

Usa la biblioteca oficial de OpenAI para Python para interactuar con nuestro servicio. Los únicos cambios necesarios son base_url y api_key. Esto asegura que tu lógica existente funcione sin modificaciones.

• Instala mediante pip install openai
• Establece variables de entorno o pásalas directamente en la inicialización del cliente
• Llama a chat.completions.create() como de costumbre

Configura el cliente así:

Copyfrom openai import OpenAI

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

Uso del SDK de Node.js

Integra con proyectos en JavaScript o TypeScript usando el paquete estándar de OpenAI para Node. Apunta el cliente a nuestra URL y proporciona tu clave. Este enfoque mantiene la compatibilidad con cualquier estructura de cliente compatible con OpenAI.

• Instala mediante npm install openai
• Inicializa con URL base personalizada
• Usa patrones estándar de async/await

Ejemplo de inicialización:

Copyimport OpenAI from "openai";

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

Respuestas en streaming

Recibe respuestas token a token para reducir la latencia percibida. Nuestra API de streaming soporta Server-Sent Events (SSE), lo que te permite mostrar la salida a medida que se genera. Esto es útil para interfaces de chat o aplicaciones en tiempo real.

• Establece stream: true en tu petición
• Analiza el flujo SSE en el cliente
• Gestiona tokens parciales de forma eficiente

Habilita el streaming en tu código:

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)

Límites, errores y contexto

Comprende las limitaciones para crear integraciones robustas. La API admite una ventana de contexto de 100k, lo que permite procesar documentos o conversaciones largas. Las peticiones están limitadas a un tamaño de cuerpo de 8 MB.

Los errores comunes incluyen 401 para claves inválidas, 402 cuando se agota el crédito prepago y 429 por exceder 300 peticiones por minuto. El crédito de pago por uso no caduca y puedes recargar desde $10. Se admiten llamadas a funciones para la ejecución de funciones.