Inicio rápido para pipelines de Acestep

Requisitos previos: Obtén tu clave de API

Antes de hacer peticiones, necesitas una clave de API válida. Visita la página Obtener clave de API en acestep.cc. Puedes registrarte usando Continuar con Google o creando una cuenta con correo electrónico y contraseña. No se requiere número de teléfono. Una vez registrado, tu clave de API se muestra inmediatamente. Copia esta clave; la usarás para autenticar todas las peticiones subsiguientes. Si no tienes crédito, necesitarás recargar. Solo aceptamos pagos con cripto (USDT en TRC20 o USDC en Base) para montos entre $10 y $500. Las cuentas nuevas reciben $0,50 de crédito de prueba válido por 7 días, sin necesidad de tarjeta para comenzar. Mantén tu clave segura, ya que autentica tu uso contra los límites de peticiones y el consumo de tokens.

Instalación

La API utiliza el protocolo estándar compatible con OpenAI. Puedes interactuar con ella mediante los SDK oficiales de OpenAI para tu lenguaje preferido o cualquier cliente HTTP. Para Python, instala el paquete openai. Para Node.js, instala openai. Asegúrate de usar una versión reciente del SDK que admita URLs base personalizadas. La URL base de nuestro servicio es https://api.acestep.cc/v1. Esto te permite reutilizar código de flujo de trabajo existente que espera endpoints de OpenAI, simplemente cambiando la URL base y la clave de API. El ID del modelo que debes especificar en tus peticiones es uncensored. Este modelo es un LLM de pesos abiertos ajustado para minimizar las negativas en temas adultos, ficticios o controversos, lo que lo hace ideal para flujos de trabajo creativos donde los filtros de contenido podrían bloquear resultados válidos.

Petición básica: Generar texto

Envía una petición POST a /v1/chat/completions con tu prompt del sistema y los mensajes del usuario. El modelo devolverá texto generado. Asegúrate de establecer el parámetro model en uncensored. Puedes controlar la creatividad con temperature y top_p. La ventana de contexto admite hasta 100.000 tokens en total (prompt + respuesta). La salida máxima por petición es de 32.000 tokens, o 2.048 si no especificas max_tokens. Los errores y las negativas no consumen crédito, pero la generación exitosa de tokens sí. Usa este endpoint para generar scripts, pies de foto o procesar datos de texto antes de pasarlos a otras APIs de modalidades como generación de voz o imagen.

Respuestas en streaming

Para actualizaciones en tiempo real, establece stream: true en tu petición. La API devuelve Server-Sent Events (SSE). Cada fragmento contiene texto parcial. Los detalles de uso de tokens se proporcionan en el último fragmento del streaming. Esto es útil para aplicaciones que muestran texto a medida que se genera, mejorando la latencia percibida para los usuarios. Asegúrate de que tu cliente maneje correctamente los SSE. El streaming te permite procesar tokens a medida que llegan, lo cual es beneficioso para la generación de contenido extenso en tu flujo de trabajo. Recuerda que el streaming no cambia los precios ni los límites de tokens; se te cobra por el total de tokens generados.

Llamadas a funciones

La API admite llamadas a funciones, lo que permite al modelo generar datos estructurados basados en tus herramientas definidas. Define tus funciones en el parámetro tools. Establece tool_choice en auto o en el nombre de una función específica. El modelo responderá con un objeto de llamada a función si procede. Esto es valioso para extraer datos estructurados de texto o preparar entradas para llamadas a APIs posteriores. También puedes forzar una salida JSON estableciendo response_format en {"type": "json_object"}. Esto asegura que el modelo devuelva JSON válido, lo cual es crítico para una integración fiable en tu flujo de trabajo automatizado. Usa estas funciones para mejorar la fiabilidad de tus pasos de procesamiento de texto.

Precios y límites

Los precios son $0,25 por 1M de tokens de entrada y $1,00 por 1M de tokens de salida. El crédito es prepago y no caduca. Los errores son gratuitos. Los límites de peticiones son de 300 peticiones por minuto por clave y 8 peticiones simultáneas al mismo tiempo por clave. El tamaño máximo del cuerpo de la petición es de 8 MB. Si superas el límite de peticiones, recibirás un error 429. Un error 401 indica una clave no válida o caducada. Un error 402 significa que tienes crédito insuficiente. No se emiten reembolsos para el crédito; las disputas se gestionan a través de la página de Soporte. Se permite una clave activa por cuenta; generar una nueva clave reemplaza a la anterior. Ten estos límites en cuenta al diseñar la lógica de reintento de tu flujo de trabajo.

cURL

Copycurl https://api.acestep.cc/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."}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Streaming

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)