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

Autenticación

Accede a la API con una clave de API única generada en tu panel de cuenta. Incluye esta clave en el encabezado Authorization de cada petición usando el esquema Bearer. La URL base para todos los endpoints es https://api.embeddingapis.com/v1. Esta URL funciona con los SDK oficiales de OpenAI y cualquier cliente configurado para servicios compatibles con OpenAI. Asegúrate de mantener tu clave segura, ya que otorga acceso a tus créditos prepago.

Cada cuenta está limitada a una clave activa, la cual se puede regenerar en cualquier momento. Regenerar la clave revoca inmediatamente la anterior, así que actualiza tu configuración rápidamente.

El endpoint de Chat Completions

Envía prompts de texto al endpoint POST /v1/chat/completions. La API sirve un único modelo sin censura identificado por el ID uncensored. Este modelo es un LLM de pesos abiertos ajustado para responder sin rechazos de contenido para temas adultos, ficticios o de investigación de seguridad. Procesa texto y genera texto, lo que lo hace ideal para pasos de postprocesamiento, resumen o extracción en tu pipeline.

Estructura tu petición con un array messages que contenga tus prompts de sistema y usuario. La API devuelve una respuesta JSON que contiene el texto generado.

Copycurl https://api.embeddingapis.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 la API. Establece el base_url a nuestro endpoint y proporciona tu clave de API. Este enfoque te permite aprovechar el código de cliente existente con cambios mínimos. El cliente maneja la serialización y las peticiones de red, devolviendo respuestas estructuradas que puedes analizar para la lógica de tu aplicación.

Asegúrate de usar una versión reciente del SDK para admitir todas las funciones, incluido el streaming y las llamadas a funciones. El ID del modelo sigue siendo uncensored al invocar completions.

Copyfrom openai import OpenAI

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

Integración con SDK de Node.js

Para entornos JavaScript o TypeScript, usa el SDK de Node.js de OpenAI. Configura el cliente con la URL base y la clave de API correctas. Esta configuración garantiza la compatibilidad con tus pipelines existentes basados en Node. El SDK gestiona la conexión al endpoint POST /v1/chat/completions, permitiéndote enviar prompts y recibir completions de texto de manera eficiente.

Esta integración es adecuada para el procesamiento de texto en el lado del servidor, como generar subtítulos, guiones o extraer datos de bloques grandes de texto.

Copyimport OpenAI from "openai";

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

Para aplicaciones de baja latencia, habilita el streaming estableciendo stream: true en tu petición. La API devuelve un flujo de Server-Sent Events (SSE), entregando tokens a medida que se generan. Esto es especialmente útil para interfaces de usuario en tiempo real o al procesar textos largos donde el feedback inmediato es valioso.

Analiza el flujo SSE para manejar respuestas parciales. El modelo sin censura admite este modo, permitiéndote reaccionar al contenido a medida que se produce sin esperar a la finalización completa.

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 ventana de contexto

La ventana de contexto admite 100.000 tokens para prompt y completion combinados. Las peticiones que excedan el límite de cuerpo de 8 MB o el límite de peticiones de 300 por minuto fallarán. Los errores de autenticación devuelven un estado 401 si la clave no es válida. Cuando se agota el crédito prepago, las peticiones fallan porque no quedan créditos para cubrir el uso de tokens. Un estado 429 indica agotamiento del límite de peticiones.

Se aplica siempre un límite estricto de contenido: las peticiones que contengan contenido sexual que involucre a menores se bloquean, independientemente de otra configuración. Todo el contenido adulto legal se procesa sin rechazos.