Guía de inicio rápido de la API Opensfw

Autenticación y URL base

Empieza por generar tu clave en el panel de control. Usa la https://api.opensfw.com/v1 URL base y establece tu clave API en el Authorization header. Esta configuración funciona con cualquier cliente SDK estándar de OpenAI.

Realizando tu primera solicitud de completación de chat

Envía una solicitud POST a /v1/chat/completions con tu ID del modelo y los mensajes. El modelo sin censura procesa tu entrada y devuelve el texto generado. Usa el ejemplo de curl a continuación para verificar la conectividad.

Copycurl https://api.opensfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current release version of the model?"}]
  }'

Respuestas en streaming y uso de tokens

Habilita la transmisión estableciendo stream: true en tu solicitud. Recibes fragmentos de texto a medida que se generan. El último fragmento contiene las estadísticas completas de uso de tokens para la facturación. Utiliza el ejemplo de Python para manejar el flujo.

Copyfrom openai import OpenAI

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

Llamada a funciones y modo JSON

Define las herramientas en tu solicitud para salidas estructuradas. Utiliza response_format: {"type": "json_object"} para respuestas JSON estrictas. Esto funciona sin problemas con los parámetros estándar de llamada de funciones.

Copyimport OpenAI from "openai";

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

Verifica la presencia de 401 si tu clave no es válida, 402 por crédito insuficiente, y 429 para los límites de velocidad. Obtienes 300 solicitudes por minuto y 8 solicitudes concurrentes por clave. Los errores no consumen tokens.

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 las ventanas de contexto y los límites

El modelo uncensored admite una ventana de contexto de 100.000 tokens. La salida máxima es de 16.000 tokens por solicitud. Mantén el cuerpo de la solicitud por debajo de 8 MB. Esto garantiza un rendimiento constante para entradas grandes.