Documentación de la API de API queen

URL Base y Autenticación

La autenticación utiliza un token Bearer estándar pasado en el Authorization header. Este enfoque garantiza la compatibilidad con los SDK existentes de OpenAI sin requerir lógica personalizada. Tu API_KEY se genera al instante al registrarse mediante Google o correo electrónico. Todas las solicitudes deben apuntar a la URL base específica proporcionada para el servicio.

• URL base: https://api.apiqueen.cc/v1
• Encabezado: Authorization: Bearer API_KEY

Copycurl https://api.apiqueen.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return current status for service api queen"}]
  }'

Enviar solicitudes a /v1/chat/completions

Envía datos de texto al punto de conexión para recibir respuestas directas del modelo. El ID del modelo es siempre uncensored, que maneja temas diversos sin las negaciones estándar. Puedes especificar parámetros como temperature y top_p para controlar la creatividad. El sistema espera una lista de mensajes en el formato de chat estándar.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

Parámetros del Modelo: Temperatura, Top-P y Stop

Controla la generación de respuestas usando parámetros LLM estándar. Configura temperature entre 0 y 2 para variar la aleatoriedad. Usa top_p para filtrar palabras de baja probabilidad. Define stop secuencias para detener la salida en activadores específicos. Estos ajustes permiten un ajuste preciso para tareas de escritura creativa o recuperación de datos factuales.

La API ignora los parámetros no compatibles de forma elegante. Concéntrate en temperature, top_p, y stop para resultados óptimos. Ajusta estos valores según la tolerancia al ruido de tu aplicación.

Respuestas en streaming y uso de tokens

Habilita la transmisión estableciendo stream: true en tu solicitud. La API devuelve fragmentos de datos mediante Eventos Enviados por Servidor (SSE). Los detalles de uso de tokens aparecen solo en el último fragmento del flujo. Esto permite la renderización en tiempo real de las respuestas en tu interfaz de usuario.

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)

Maneja las respuestas parciales con cuidado. Asegúrate de que tu cliente almacene en búfer los datos hasta que se cierre la transmisión.

Llamada de Función y Modo JSON

Usa la llamada a funciones para la extracción de datos estructurados. Define las herramientas en la tools parámetro. El modelo devuelve JSON válido cuando response_format se establece en {"type": "json_object"}. Esto asegura un análisis consistente en aplicaciones posteriores.

Establecer tool_choice para forzar llamadas de funciones específicas. Esto es útil para flujos de trabajo automatizados que requieren formatos de salida estrictos.

Gestión de errores y límites de velocidad

Monitoriza los códigos de estado HTTP para problemas comunes. Un error 401 significa que tu clave API es inválida. Un error 402 indica crédito prepagado insuficiente. Los errores no consumen tu saldo de tokens. Los límites de velocidad imponen 300 solicitudes por minuto por clave. Las solicitudes concurrentes están limitadas a 8. La ventana de contexto admite 100.000 tokens en total.

Maneja los reintentos con retroceso exponencial. Comprueba el error objeto en las respuestas JSON para más detalles.