Migrate from OpenAI | Venice API Docs

Venice AI es un sustituto drop-in para OpenAI. El mismo SDK, el mismo código: solo cambia dos líneas. Obtén inferencia centrada en la privacidad, modelos sin censura y precios competitivos.

La migración de 2 líneas

# Antes (OpenAI)
from openai import OpenAI
client = OpenAI()

# Después (Venice) — cambia api_key y base_url
from openai import OpenAI
client = OpenAI(
    api_key="your-venice-api-key",           # ← Cambio 1
    base_url="https://api.venice.ai/api/v1",  # ← Cambio 2
)

// Antes (OpenAI)
import OpenAI from "openai";
const client = new OpenAI();

// Después (Venice)
import OpenAI from "openai";
const client = new OpenAI({
  apiKey: "your-venice-api-key",
  baseURL: "https://api.venice.ai/api/v1",
});

# Antes
curl https://api.openai.com/v1/chat/completions ...

# Después — solo cambia la URL y la clave
curl https://api.venice.ai/api/v1/chat/completions ...

Genera una clave desde venice.ai/settings/api o sigue la guía de claves de API.

Variables de entorno

# Antes
OPENAI_API_KEY=sk-...
OPENAI_BASE_URL=https://api.openai.com/v1

# Después
OPENAI_API_KEY=your-venice-api-key
OPENAI_BASE_URL=https://api.venice.ai/api/v1

Muchas librerías y herramientas leen OPENAI_API_KEY y OPENAI_BASE_URL automáticamente. Actualizar estas variables de entorno puede ser todo lo que necesitas. Algunas herramientas todavía usan OPENAI_API_BASE para la misma URL.

Modelos

Pasa un ID de modelo de Venice, un rasgo como default o most_uncensored o, para modelos de chat y de embeddings, un nombre familiar al estilo de OpenAI. Venice mapea los nombres de modelos de chat y de embeddings de OpenAI mediante el mapeo de compatibilidad; otros endpoints, incluido el de audio, necesitan IDs de modelo de Venice. Los rasgos siempre se resuelven al modelo actual para ese rol; consulta los rasgos de modelo. Explora el catálogo en vivo en Modelos de texto y Precios. Para un recorrido por la primera solicitud, consulta la Guía rápida.

Compatibilidad de funciones

Función	OpenAI	Venice	Notas
Chat Completions	✅	✅	Compatible. Los campos de nivel superior desconocidos, incluidos los exclusivos de OpenAI como `logit_bias` y `service_tier`, devuelven HTTP 400
Streaming	✅	✅	Mismo formato SSE, más un chunk final de uso; consulta Formato de streaming
Function Calling	✅	✅	Mismo parámetro `tools`
Salida estructurada	✅	✅	Mismo `response_format`
Visión	✅	✅	Mismo formato de array de contenido
Embeddings	✅	✅	Solo texto; los arreglos de tokens devuelven HTTP 400
Generación de imágenes	✅	✅	Compatible con OpenAI mediante `/images/generations`
Edición de imágenes	✅	❌	No hay endpoint `/images/edits`. Usa el endpoint nativo `/image/edit`
TTS	✅	✅	Formato de solicitud compatible; usa IDs de modelo de Venice (los nombres de modelos de audio de OpenAI devuelven HTTP 400)
STT	✅	✅	Formato de solicitud compatible; usa IDs de modelo de Venice. `response_format` solo admite `json` o `text`. No hay `/audio/translations`
Responses API	✅	✅	Nativa para modelos de OpenAI, traducida para los demás; consulta las limitaciones
Assistants API	✅	❌	Usa Personajes o function calling
Batch API	✅	❌	Aún no disponible
Fine-tuning	✅	❌	No disponible

Para opciones de imagen nativas más allá del endpoint compatible con OpenAI, consulta Generación de imágenes.

Formato de streaming

Los streams de Chat Completions usan el formato de chunks de OpenAI y terminan con data: [DONE]. Hay dos diferencias:

Chunk de uso. Todos los streams terminan con un chunk de uso antes de [DONE], incluso cuando stream_options.include_usage es false. Su array choices está vacío y contiene usage y un objeto cost. Los clientes que leen choices[0] en cada chunk deben omitir los chunks sin choices.
Errores después de que empiece el stream. El estado HTTP ya es 200, así que el error llega como un evento data: con un objeto error (message, type, code), seguido de data: [DONE]. Cuando el modelo está sobrecargado, el objeto también incluye retry_after en segundos.

data: {"error":{"message":"...","type":"server_error","code":"...","param":null}}

data: [DONE]

Funciones exclusivas de Venice

Pasa opciones específicas de Venice a través de extra_body como venice_parameters. La búsqueda web integrada suele ser el primer extra:

response = client.chat.completions.create(
    model="default",
    messages=[{"role": "user", "content": "Últimas noticias de IA hoy"}],
    extra_body={
        "venice_parameters": {
            "enable_web_search": "auto"
        }
    },
)

Las claves desconocidas dentro de venice_parameters se ignoran en lugar de rechazarse, así que comprueba la ortografía de cada clave en la referencia de la API. El mismo patrón cubre el web scraping, las citas y los Personajes. Si un cliente no puede cambiar el cuerpo de la solicitud, añade un sufijo de función de modelo como default:enable_web_search=auto. Venice también dispone de APIs nativas de vídeo, música, recuperación web y x402 junto a la superficie compatible con OpenAI.

Frameworks

La mayoría de los frameworks de IA funcionan con Venice cambiando la URL base:

LangChain

base_url en ChatOpenAI; check_embedding_ctx_length=False en OpenAIEmbeddings

Vercel AI SDK

baseURL en createOpenAI

LlamaIndex

api_base en el cliente compatible con OpenAI

CrewAI

Variable de entorno OPENAI_API_BASE

PydanticAI

Modelo compatible con OpenAI con URL base de Venice

Cursor

Endpoint de API personalizado en la configuración

Claude Code

Enruta Claude Code a través de Venice

Codex CLI

Proveedor de modelo en config.toml

Aider

Variable de entorno OPENAI_API_BASE

Encontrarás más agentes de código y herramientas en Agentes de IA.

Modelos sin censura

Los modelos privados sin censura de Venice no aplican filtrado de contenido, lo que los hace adecuados para:

Escritura creativa sin restricciones
Investigación de seguridad y red teaming
Análisis honesto sin patrones de rechazo
Información médica y legal sin descargos de responsabilidad adicionales

Usa el rasgo most_uncensored o el ID de un modelo sin censura actual de Modelos de texto.

Obtén tu clave de API

Genera una clave de API de Venice y comienza a migrar en minutos

Documentación

Primeros pasos

Texto y chat

Imagen

Vídeo

Audio

Búsqueda y RAG

Agentes e integraciones

Herramientas de código

Herramientas para agentes

SDK y frameworks

Migrar desde OpenAI

La migración de 2 líneas

Variables de entorno

Modelos

Compatibilidad de funciones

Formato de streaming

Funciones exclusivas de Venice

Frameworks

LangChain

Vercel AI SDK

LlamaIndex

CrewAI

PydanticAI

Cursor

Claude Code

Codex CLI

Aider

Modelos sin censura

Obtén tu clave de API

​La migración de 2 líneas

​Variables de entorno

​Modelos

​Compatibilidad de funciones

​Formato de streaming

​Funciones exclusivas de Venice

​Frameworks

LangChain

Vercel AI SDK

LlamaIndex

CrewAI

PydanticAI

Cursor

Claude Code

Codex CLI

Aider

​Modelos sin censura

Obtén tu clave de API

La migración de 2 líneas

Variables de entorno

Modelos

Compatibilidad de funciones

Formato de streaming

Funciones exclusivas de Venice

Frameworks

Modelos sin censura