ES ▾

Alternativa de API de IA sin censura para desarrolladores

https://api.veniceapialternative.com/v1

veniceapialternative.com

Endpoint de API de Venice AI: Cambia a otra URL base

Si tu código apunta a un endpoint de API de Venice AI y quieres probar otro proveedor, el cambio es pequeño: una URL base, una clave y un ID de modelo. Esta página lista qué editar, qué probar y qué se comporta diferente después.

Actualizado

Un enchufe de cable moviéndose entre dos bloques de servidor, ilustrando un cambio de URL base

Puntos clave

  • Cuatro ediciones cubren la mayoría de las migraciones: URL base, clave de API, ID del modelo, manejo del saldo.
  • La nueva URL base es https://api.veniceapialternative.com/v1 y el ID del modelo es uncensored.
  • Se admiten tres endpoints: chat completions, responses y models.
  • Prueba con el crédito de prueba de $0,50 antes de mover el tráfico real.

La respuesta corta: cuatro ediciones

Cualquier cliente que hable el formato de chat de OpenAI solo necesita cambios de configuración para llegar a otro proveedor. Para un endpoint de API de Venice AI, lo mismo aplica a la inversa: estás reemplazando cuatro valores, no reescribiendo tu integración.

  1. URL base: establécela en https://api.veniceapialternative.com/v1.
  2. Clave de API: crea una en la página de clave de API y envíala como Authorization: Bearer <key>.
  3. ID del modelo: usa uncensored. Hay un solo modelo, así que no hay lista de modelos que mapear.
  4. Verificaciones de saldo: lee el encabezado X-Balance-USD o llama a GET /v1/balance.

Este es un servicio independiente, no gestionado por ni afiliado con Venice ni ningún otro proveedor. Aloja un único modelo de pesos abiertos, por lo que cualquier nombre de modelo que usara tu código antes debe ser reemplazado.

Antes de editar: encuentra cada lugar donde vive el endpoint

La URL base rara vez está en solo un archivo. Busca en tu repositorio el nombre de host antiguo, la cadena de modelo antigua y la variable de entorno que contiene la clave. Los lugares típicos son constructores de SDK, archivos .env, secretos de Docker o CI, configuración del front-end y trabajadores en segundo plano que se escribieron por separado de la aplicación principal.

Un hábito útil es mover primero los tres valores a variables de entorno y luego migrar. Eso convierte el cambio en una modificación en tiempo de despliegue y te da una reversión de una línea.

export LLM_BASE_URL="https://api.veniceapialternative.com/v1"
export LLM_API_KEY="YOUR_KEY"
export LLM_MODEL="uncensored"

Código para Python, Node y curl

Python (SDK openai)

import os
from openai import OpenAI

client = OpenAI(
    base_url=os.environ.get("LLM_BASE_URL", "https://api.veniceapialternative.com/v1"),
    api_key=os.environ["LLM_API_KEY"],
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Say hello in five words."}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.veniceapialternative.com/v1",
  apiKey: process.env.LLM_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Say hello in five words." }],
});
console.log(resp.choices[0].message.content);

curl

curl -i https://api.veniceapialternative.com/v1/chat/completions \
  -H "Authorization: Bearer $LLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'

La bandera -i imprime los encabezados de respuesta, que es cómo ves X-Request-Id y X-Balance-USD en la primera llamada.

Lo que permanece igual y lo que no

La forma de la petición es la habitual: messages con roles, stream, tools, tool_choice, response_format para modo JSON, y los parámetros de muestreo temperature, top_p, stop, seed y las penalizaciones. El streaming usa SSE con uso al final, y los resultados de las herramientas vuelven como mensajes role: "tool".

ÍtemAquí
EndpointsPOST /v1/chat/completions, POST /v1/responses, GET /v1/models
ID del modelouncensored (un modelo)
Ventana de contexto100.000 tokens, prompt más completación
Cuerpo de petición máximo8 MB
ModalidadesSolo texto: sin imágenes, audio, video, embeddings ni ajuste fino

La última fila es la que rompe las migraciones. Si tu aplicación llama a una ruta de imagen, voz o incrustación en el proveedor antiguo, esas llamadas no tienen equivalente aquí. Mantén esa parte en su proveedor actual y mueve solo las llamadas de texto.

Maneja los límites y errores de forma diferente

Una clave completa permite 8 peticiones simultáneas y 300 peticiones por minuto. Una clave de prueba permite 2 simultáneas y 60 por minuto. Al superar cualquiera de estos límites obtienes HTTP 429, con código de error rate_limited para peticiones por minuto o concurrency por exceso de concurrencia. Un 429 con un encabezado Retry-After: 5 indica sobrecarga temporal: espera y reintenta.

Ten en cuenta que una petición fragmentada ocupa su plaza de concurrencia hasta que finalice el streaming. Si tu integración antigua disparaba docenas de llamadas simultáneas, coloca un semáforo de 8 o menos delante del cliente.

import time, random
from openai import OpenAI, RateLimitError

client = OpenAI(base_url="https://api.veniceapialternative.com/v1", api_key="YOUR_KEY")

def ask(prompt, tries=4):
    for i in range(tries):
        try:
            r = client.chat.completions.create(
                model="uncensored",
                messages=[{"role": "user", "content": prompt}],
            )
            return r.choices[0].message.content
        except RateLimitError:
            time.sleep(5 + random.random() * i)
    raise RuntimeError("still rate limited")

Las peticiones fallidas o rechazadas no se cobran, por lo que los reintentos por errores no te cuestan crédito.

Streaming y llamadas a herramientas tras el cambio

Si tu aplicación transmite tokens a una interfaz, nada cambia en el cliente: establece stream: true y lee eventos enviados por el servidor. El bloque de uso llega al final del streaming, lo cual es útil para registrar el costo de cada respuesta.

from openai import OpenAI

client = OpenAI(base_url="https://api.veniceapialternative.com/v1", api_key="YOUR_KEY")

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "List three uses of a message queue."}],
    stream=True,
    stream_options={"include_usage": True},
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")
    if chunk.usage:
        print("\n", chunk.usage)

Las llamadas a funciones siguen el mismo flujo que ya conoces. Pasas tools y opcionalmente tool_choice, el modelo devuelve tool_calls (fragmentado cuando hay streaming), ejecutas la función y envías el resultado de vuelta como un mensaje role: "tool". El modo JSON funciona con response_format: {"type": "json_object"}. Valida siempre el JSON analizado en tu código, porque ningún modelo garantiza un esquema.

Problemas comunes después del cambio

  • Errores de autenticación. Verifica que la clave se envíe como token Bearer y que hayas copiado la cadena completa. Una clave del proveedor antiguo no funcionará aquí.
  • Errores de no encontrado. La URL base debe terminar en /v1. Si pegas la ruta completa /chat/completions en un SDK que la añade de nuevo, la ruta será incorrecta.
  • Modelo desconocido. Cualquier cadena de modelo distinta a uncensored es incorrecta. Busca nombres codificados en la configuración y las pruebas.
  • Ráfagas de 429. Limita la paralelización a la concurrencia de tu tipo de clave y respeta Retry-After.
  • Costo inesperado. Los historiales de chat largos se facturan como entrada en cada turno. Recórtalos.

Si algo sigue pareciendo incorrecto, envía el valor X-Request-Id de la respuesta al contacto de la página de soporte. Identifica la petición exacta y ahorra tiempo en ambos lados.

Lista de verificación de migración y pruebas

Trabaja a través de esto en orden. Cada paso es un cambio pequeño y reversible.

  1. Reclama el crédito de prueba de $0,50 desde la página de claves de API. No necesita tarjeta y dura 7 días.
  2. Ejecuta la llamada curl anterior y confirma la respuesta y los encabezados.
  3. Cambia una ruta de código no crítica a la nueva URL base y clave.
  4. Reproduce una muestra de prompts reales y compara la calidad, longitud y latencia de la salida a simple vista.
  5. Revisa usage en las respuestas y multiplica por tu volumen a $0.15 por 1M de tokens de entrada y $0.50 por 1M de tokens de salida.
  6. Añade una alerta de saldo en X-Balance-USD.
  7. Recarga (desde $20, con bonificaciones a partir de $50) y traslada el resto del tráfico.

Los prompts que dependían de las peculiaridades de otro modelo pueden necesitar pequeñas ediciones, como un prompt de sistema diferente. Eso es normal al cambiar modelos, así que juzga por tu propio conjunto de pruebas, no por una sola respuesta. Este modelo está ajustado para responder sin rechazos de contenido para uso adulto legal, y no se permite contenido sexual que involucre a menores de edad.

La documentación docs describe cada endpoint y cabecera. Nuestra página sobre la alternativa a la API de Venice explica cómo se compara el producto, y la página de precios muestra los importes de recarga, bonificaciones y métodos de pago. Los prompts enviados a la API no se utilizan para entrenamiento, y el crédito no caduca, por lo que una pequeña recarga de prueba no tiene fecha de vencimiento.

Preguntas y respuestas

¿Cuál es la URL base?

Usa https://api.veniceapialternative.com/v1 con cualquier cliente compatible con OpenAI, y envía tu clave como token Bearer.

¿Qué ID de modelo debo enviar?

Envía uncensored. Solo hay un modelo, así que no hace falta mapear tus nombres de modelo antiguos.

¿Cómo verifico mi saldo?

Lee la cabecera de respuesta X-Balance-USD, llama a GET /v1/balance o usa GET /v1/dashboard/billing/credit_grants estilo OpenAI.

¿Puedo llamar a endpoints de imágenes o embeddings?

No. La API es solo de texto, sin endpoints de imágenes, audio, vídeo, embeddings ni fine-tuning.

Tu clave está a un formulario de distancia

Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.

Obtener clave de API