Inicio rápido: API de texto sin censura para pipelines de imágenes

URL base y autenticación

Nuestra API sigue la estructura estándar de chat-completions de OpenAI. Para comenzar, ve a la página Obtener clave de API y regístrate con un correo electrónico y contraseña. La clave de API se muestra inmediatamente. No se requiere número de teléfono ni tarjeta de crédito para la prueba, aunque se necesita crédito prepago para un uso sostenido.

Configura tu URL base en https://api.imagegenapi.com/v1. Incluye tu clave de API en el encabezado Authorization como token Bearer. Esta configuración funciona con cualquier biblioteca cliente compatible con OpenAI. El identificador del modelo a usar es uncensored, un modelo de pesos abiertos ajustado para responder sin rechazos para uso adulto lícito.

Envío de un prompt

Envía una petición estándar chat.completions para generar texto. La API acepta una lista de mensajes en la matriz messages. Devuelve un objeto JSON que contiene la finalización. Esto es ideal para generación de prompts únicos o tareas de edición de metadatos donde no se requiere streaming.

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

El cuerpo de la petición incluye el campo model configurado en uncensored y tu historial de conversaciones. La respuesta contiene la respuesta del asistente, que luego puedes alimentar en tu pipeline de generación de imágenes o usar como pie de foto.

Integración con SDK de Python

Para desarrolladores de Python, usa la biblioteca oficial openai. Configura el base_url y el api_key para apuntar a nuestro servicio. Esto te permite aprovechar los idiomatismos familiares de Python mientras accedes a nuestro modelo sin censura.

Copyfrom openai import OpenAI

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

Inicializa el cliente con tu clave y la URL base correcta. Llama a chat.completions.create() con tus mensajes. Este enfoque es mejor para procesamiento por lotes o cuando necesitas analizar la respuesta JSON directamente en la lógica de tu aplicación. Recuerda que el ID del modelo debe ser uncensored.

Uso del SDK de Node.js

Los desarrolladores de Node.js pueden usar el paquete npm openai. Configura el baseURL a nuestro endpoint. Esto es útil para renderizado del lado del servidor o pasarelas API donde necesitas procesar respuestas de texto de forma asíncrona.

Copyimport OpenAI from "openai";

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

Crea la instancia del cliente con tu clave de API y URL base. Invoca chat.completions.create() para obtener la salida de texto. Este método es adecuado para generar scripts, pies de foto o extraer información de texto antes de que se use en tu pipeline de imágenes.

Respuestas en streaming

Para generar texto en tiempo real, activa el streaming estableciendo stream: true. La API devuelve un flujo de eventos enviados por el servidor (SSE), no un único objeto JSON. Debes procesar los fragmentos delta a medida que llegan para reconstruir el mensaje completo.

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)

Recorre el flujo para mostrar el texto de forma incremental. Esto es crítico para aplicaciones donde importa la latencia, como la edición de prompts en vivo o interfaces de chat interactivas. Cada fragmento contiene una parte de la respuesta, lo que te permite renderizar el texto a medida que se genera.

Límites de peticiones y restricciones

Cada clave de API está limitada a 300 peticiones por minuto. El cuerpo de la petición no debe exceder 8 MB. Si excedes el límite, recibirás un error 429. Regenera tu clave si es necesario, lo que revocará la antigua.

Si tu crédito prepago se agota, la API rechazará las peticiones. No hay un nivel gratuito ilimitado; debes recargar con crédito. El error 401 indica una clave de API no válida o ausente. Asegúrate de que tu clave esté configurada correctamente en el encabezado de autorización. La ventana de contexto es de 100,000 tokens para prompt más completion.