Inicio rápido: API de Finalizaciones de Chat

Prerrequisitos y URL base

Nuestra API es totalmente compatible con la interfaz estándar de completados de chat de OpenAI. Solo necesitas una URL base y una clave de API para comenzar a enviar solicitudes. La URL base es HTTPS://api.howmuchisanapikey.com/v1. Este único endpoint maneja toda la generación de texto sin requerir que gestiones múltiples URL de servicio o configuraciones de proxy.

La autenticación es clara. Debes incluir un encabezado Authorization con el esquema Bearer seguido de tu clave única. Cada solicitud al endpoint de completado de chat requiere este encabezado para validar tu cuenta y rastrear el uso de tokens contra tu saldo de crédito prepagado.

Autenticación y encabezados

Incluye el encabezado Authorization en cada solicitud para verificar tu identidad. El formato del encabezado es Authorization: Bearer YOUR_API_KEY. Si la clave no es válida o ha expirado, la API devuelve un error 401 inmediatamente. Esto asegura que solo las cuentas autorizadas puedan consumir tu crédito prepagado.

No necesitas pasar encabezados adicionales para la generación básica de texto. Sin embargo, si usas características específicas como el modo JSON o la llamada de funciones, debes establecer el encabezado Content-Type a application/json. Esto indica al servidor cómo analizar correctamente el cuerpo de tu solicitud.

Enviar tu primera completación de chat

Envía una solicitud POST a /v1/chat/completions con tu historial de mensajes e identificador del modelo. El id del modelo es "uncensored". Este modelo está ajustado para responder sin rechazos para contenido adulto lícito, ficción o temas controvertidos. No filtra basándose en normas políticas o sociales estándar.

Aquí tienes un ejemplo básico de curl para empezar:

Copycurl https://api.howmuchisanapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a simple hello world function in python"}]
  }'

La respuesta contendrá el texto generado en el array de choices. Puedes analizar esto directamente en la lógica de tu aplicación. Cada solicitud consume tokens de entrada para tu prompt y tokens de salida para la respuesta del modelo.

Respuestas en streaming y uso de tokens

Utiliza Eventos Enviados por Servidor (SSE) para recibir tokens a medida que se generan. Esto reduce la latencia percibida para salidas largas. Establece el parámetro stream en true en el cuerpo de tu solicitud. El servidor enviará múltiples fragmentos, cada uno conteniendo un delta parcial de la respuesta.

El último fragmento incluye los datos de uso. Este objeto contiene los tokens de entrada y salida totales consumidos por la solicitud. Puedes usar estos datos para actualizar tu saldo de crédito local o monitorear tus gastos en tiempo real. El streaming es ideal para interfaces de chat donde los usuarios esperan retroalimentación instantánea.

Llamada a funciones y modo JSON

La API admite salidas estructuradas mediante modo JSON y llamada de funciones. Establece response_format a {"type": "json_object"} para forzar al modelo a devolver JSON válido. Esto es útil para extraer datos o generar configuraciones estructuradas sin errores de análisis.

Para la llamada de funciones, proporciona un array de tools en tu solicitud. El modelo responderá con tool_calls si determina que se necesita una función. Luego puedes ejecutar la función y enviar el resultado de vuelta al modelo. Esto habilita flujos de trabajo complejos de múltiples pasos sin lógica de análisis externa.

Gestión de límites y errores

Está limitado a 300 solicitudes por minuto por clave y 8 solicitudes concurrentes. Si excede estos límites, recibirá un error 429 Too Many Requests. El cuerpo de la respuesta incluirá detalles de retry-after. Ajuste la limitación de velocidad en el lado del cliente para evitar reintentos innecesarios.

Si tu crédito prepagado se agota, la API devuelve un error 402 Payment Required. Puedes recargar mediante criptomonedas en cualquier momento. Los errores y rechazos son gratuitos, así que solo pagas por la generación de tokens exitosa. La ventana de contexto es de 100,000 tokens para prompt y finalización combinados.

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Transmisión

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)