Guía de integración para desarrolladores

Configuración de autenticación y URL base

Empieza por generar tu clave API en el panel de control. La URL base es HTTPS://api.apiaicheap.com/v1. Envía tu clave en el encabezado Authorization como un token bearer.

• Haz clic en "Obtener clave API" e inicia sesión con Google o correo electrónico.
• Copia la clave inmediatamente; se muestra solo una vez.

Esta clave autentica todas las solicitudes al endpoint de finalización de chat.

Encabezado de ejemplo

Autorización: Bearer YOUR_API_KEY

Primera solicitud con cURL

Envía una solicitud básica de chat completion para probar tu configuración. Utiliza el endpoint POST /v1/chat/completions con el modelo "uncensored".

Esto confirma tu saldo de créditos y la latencia.

• Establece el role a "user".
• Mantén el mensaje simple para la primera prueba.

Comprueba la respuesta para ver un campo de texto generado.

• Busca el valor "content".

Si obtienes un 200 OK, tu integración está funcionando.

Copycurl https://api.apiaicheap.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the null pointer in the login handler"}]
  }'

Integración del SDK de Python

Utiliza la biblioteca oficial de Python de OpenAI para una integración sencilla. Señálala hacia nuestra URL base y establece tu clave API.

Este enfoque maneja los reintentos y el análisis de JSON automáticamente.

• Instala la biblioteca mediante pip.
• Establece el parámetro base_url a nuestro punto final.

Llama al método chat.completions.create.

Pasa tu lista de mensajes como un argumento.

• Incluye el nombre del modelo "uncensored".

Accede al texto de la respuesta a través de los atributos del objeto.

Este método es limpio y legible para scripts de producción.

Copyfrom openai import OpenAI

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

Configuración del SDK de Node.js

El SDK de Node.js funciona de manera similar a la versión de Python. Inicializa el cliente con tu clave y nuestra URL base.

Esto te permite usar patrones asíncronos familiares (async/await).

• Importa el paquete OpenAI.
• Configura la URL base en el constructor.

Crea una solicitud de finalización con tus mensajes.

Maneja la promesa para obtener el resultado.

• Extrae el contenido del mensaje de la respuesta.

Registra la salida para verificar que el modelo responda correctamente.

Esta configuración es ideal para servidores web y servicios backend.

Copyimport OpenAI from "openai";

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

Activa la transmisión estableciendo stream en true en tu solicitud. La API devuelve fragmentos a medida que se generan mediante Eventos Enviados por Servidor.

Esto reduce la latencia percibida para los usuarios en aplicaciones de chat.

• Establece stream: true en la carga útil.
• Procesa cada fragmento a medida que llega.

Combina los fragmentos para formar la respuesta final.

Los detalles de uso de tokens aparecen en el último fragmento.

• Verifica el campo "usage" en el último fragmento.

Este enfoque mantiene la interfaz de usuario receptiva durante generaciones largas.

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

Tu cuenta tiene un límite de 300 solicitudes por minuto por clave. La ventana de contexto admite 100,000 tokens en total para prompt y completado.

Los errores se manejan con códigos de estado HTTP estándar.

• 401 indica una clave API inválida o faltante.
• 402 significa que tu crédito prepagado se ha agotado.
• 429 señala que has excedido el límite de velocidad.

Las negativas no cuestan crédito. Los errores también son gratuitos.

La salida máxima es de 16,000 tokens por solicitud. Establece max_tokens si necesitas menos.

Esta estructura garantiza una facturación y un rendimiento predecibles.