Guía de integración

Inicio rápido: Tu primera solicitud

La API es una API compatible con openai que refleja la estructura de Chat Completions. Envías texto, recibes texto. Sin endpoints adicionales para incrustaciones o audio que saturen tu flujo de trabajo. Comienza apuntando tu cliente a nuestra URL base.

• URL Base: HTTPS://api.filtrosemia.com/v1
• ID del Modelo: "uncensored"

Reemplace la URL base existente en la configuración de su SDK. El endpoint se encarga de todo, desde roleplay hasta traducción, sin los filtros habituales.

Copycurl https://api.filtrosemia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "check balance"}]
  }'

Autenticación y encabezados

Pasa tu clave de API en el encabezado Authorization estándar. Usamos una única clave activa por cuenta para simplificar. Si necesitas una nueva, génerala desde tu panel de control.

• Encabezado: Authorization: Bearer YOUR_API_KEY
• Sin flujos OAuth ni tokens de actualización que gestionar.

Mantén tu clave segura. Otorga acceso directo a tus créditos prepagados. Errores como 401 Unauthorized significan que falta la clave o es inválida.

Copyfrom openai import OpenAI

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

Endpoint Chat Completions

Envía mensajes a POST /v1/chat/completions. El modelo admite parámetros estándar como temperature, top_p, y stop secuencias. Es un modelo sin censura ajustado para contenido adulto y creativo.

• Compatible json_object formato de respuesta.
• Acepta definiciones de herramientas para llamadas a funciones.

Las solicitudes se procesan secuencialmente dentro de sus límites de velocidad. Asegúrese de que su carga útil sea inferior a 8 MB.

Copyimport OpenAI from "openai";

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

Utiliza Eventos Enviados por Servidor para la entrega de tokens en tiempo real. Esto reduce la latencia percibida para salidas largas. El último fragmento contiene las estadísticas completas de uso de tokens.

• Establecer stream: true en tu solicitud.
• Analiza el flujo SSE en tu cliente.

El streaming funciona de manera idéntica al comportamiento estándar del SDK de OpenAI. Manejas los fragmentos a medida que llegan.

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)

Ventana de Contexto y Límites

El modelo admite una ventana de contexto de 100,000 tokens. Esto permite cargas de trabajo intensas con historiales largos. La salida máxima es de 16,000 tokens por solicitud.

• Salida máxima predeterminada: 2,048 tokens.
• Límite de velocidad: 300 solicitudes por minuto.

Superar los límites activa un 429 Too Many Requests error. Ajusta tu concurrencia para mantenerte dentro de los límites. Se permiten 8 solicitudes concurrentes por clave.

Gestión de errores y tokens

Maneja errores HTTP estándar. 402 Payment Required significa que tu crédito prepagado se ha agotado. 429 indica limitación de velocidad. 401 señalan problemas de autenticación.

• Los errores son gratuitos. Solo pagas por el uso exitoso de tokens.
• Las denegaciones por política de contenido también son gratuitas.

Comprueba el cuerpo de la respuesta para ver mensajes de error detallados. Utilízalos para ajustar tu lógica de reintento o la frecuencia de recarga de créditos.