Inicio rápido

Empieza a usar la API de Venice en minutos. Genera una clave de API, realiza tu primera solicitud y comienza a construir.

Obtén tu clave de API

Ve a la configuración de la API de Venice y genera una nueva clave de API.Para ver un tutorial detallado, consulta la guía de claves de API.

Configura tu clave de API

Añade tu clave de API a tu entorno. Puedes exportarla en tu shell:

export VENICE_API_KEY='your-api-key-here'

O añadirla a un archivo .env en tu proyecto:

VENICE_API_KEY=your-api-key-here

Instala el SDK

Venice es compatible con OpenAI, por lo que puedes usar el SDK de OpenAI. Si prefieres usar cURL o solicitudes HTTP sin procesar, puedes omitir este paso.

pip install openai

npm install openai

Envía tu primera solicitud

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("VENICE_API_KEY"),
    base_url="https://api.venice.ai/api/v1"
)

completion = client.chat.completions.create(
    model="zai-org-glm-5",
    messages=[
        {"role": "system", "content": "You are a helpful AI assistant"},
        {"role": "user", "content": "Why is privacy important?"}
    ]
)

print(completion.choices[0].message.content)

import OpenAI from 'openai';

const client = new OpenAI({
    apiKey: process.env.VENICE_API_KEY,
    baseURL: 'https://api.venice.ai/api/v1'
});

const completion = await client.chat.completions.create({
    model: 'zai-org-glm-5',
    messages: [
        { role: 'system', content: 'You are a helpful AI assistant' },
        { role: 'user', content: 'Why is privacy important?' }
    ]
});

console.log(completion.choices[0].message.content);

curl https://api.venice.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "zai-org-glm-5",
    "messages": [
      {"role": "system", "content": "You are a helpful AI assistant"},
      {"role": "user", "content": "Why is privacy important?"}
    ]
  }'

Roles de los mensajes:

system - Instrucciones sobre cómo debe comportarse el modelo
user - Tus indicaciones o preguntas
assistant - Respuestas previas del modelo (para conversaciones de varios turnos)
tool - Resultados de llamadas a funciones (cuando se usan herramientas)

Cambia de modelo modificando el ID del modelo

Cada solicitud incluye un ID de model. Para usar un modelo diferente, cambia el valor de model en tu solicitud. Opciones populares:

zai-org-glm-5 - Modelo predeterminado para la mayoría de los casos de uso
kimi-k2-6 - Razonamiento sólido para tareas más complejas
claude-opus-4-8 - Modelo de alta inteligencia para tareas complejas
venice-uncensored-1-2 - El modelo sin censura de Venice

Ver todos los modelos

Explora la lista completa de modelos con precios, capacidades y límites de contexto

Usa los parámetros de Venice

Puedes optar por habilitar funciones específicas de Venice, como la búsqueda web, mediante venice_parameters:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("VENICE_API_KEY"),
    base_url="https://api.venice.ai/api/v1"
)

completion = client.chat.completions.create(
    model="zai-org-glm-5",
    messages=[
        {"role": "user", "content": "What are the latest developments in AI?"}
    ],
    extra_body={
        "venice_parameters": {
            "enable_web_search": "auto",
            "include_venice_system_prompt": True
        }
    }
)

print(completion.choices[0].message.content)

import OpenAI from 'openai';

const client = new OpenAI({
    apiKey: process.env.VENICE_API_KEY,
    baseURL: 'https://api.venice.ai/api/v1'
});

const completion = await client.chat.completions.create({
    model: 'zai-org-glm-5',
    messages: [
        { role: 'user', content: 'What are the latest developments in AI?' }
    ],
    venice_parameters: {
        enable_web_search: 'auto',
        include_venice_system_prompt: true
    }
});

console.log(completion.choices[0].message.content);

curl https://api.venice.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "zai-org-glm-5",
    "messages": [
      {"role": "user", "content": "What are the latest developments in AI?"}
    ],
    "venice_parameters": {
      "enable_web_search": "auto",
      "include_venice_system_prompt": true
    }
  }'

Consulta todos los parámetros disponibles.

Habilita el streaming (opcional)

Transmite las respuestas en tiempo real usando stream=True:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("VENICE_API_KEY"),
    base_url="https://api.venice.ai/api/v1"
)

stream = client.chat.completions.create(
    model="zai-org-glm-5",
    messages=[{"role": "user", "content": "Write a short story about AI"}],
    stream=True
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content is not None:
        print(chunk.choices[0].delta.content, end="")

import OpenAI from 'openai';

const client = new OpenAI({
    apiKey: process.env.VENICE_API_KEY,
    baseURL: 'https://api.venice.ai/api/v1'
});

const stream = await client.chat.completions.create({
    model: 'zai-org-glm-5',
    messages: [{ role: 'user', content: 'Write a short story about AI' }],
    stream: true
});

for await (const chunk of stream) {
    if (chunk.choices && chunk.choices[0]?.delta?.content) {
        process.stdout.write(chunk.choices[0].delta.content);
    }
}

curl https://api.venice.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "zai-org-glm-5",
    "messages": [
      {"role": "user", "content": "Write a short story about AI"}
    ],
    "stream": true
  }'

Personaliza el comportamiento de las respuestas (opcional)

Controla cómo responde el modelo con parámetros como temperature, max tokens y más:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("VENICE_API_KEY"),
    base_url="https://api.venice.ai/api/v1"
)

completion = client.chat.completions.create(
    model="zai-org-glm-5",
    messages=[
        {"role": "system", "content": "You are a creative storyteller"},
        {"role": "user", "content": "Tell me a creative story"}
    ],
    temperature=0.8,
    max_tokens=500,
    top_p=0.9,
    frequency_penalty=0.5,
    presence_penalty=0.5,
    extra_body={
        "venice_parameters": {
            "include_venice_system_prompt": False
        }
    }
)

print(completion.choices[0].message.content)

import OpenAI from 'openai';

const client = new OpenAI({
    apiKey: process.env.VENICE_API_KEY,
    baseURL: 'https://api.venice.ai/api/v1'
});

const completion = await client.chat.completions.create({
    model: 'zai-org-glm-5',
    messages: [
        { role: 'system', content: 'You are a creative storyteller' },
        { role: 'user', content: 'Tell me a creative story' }
    ],
    temperature: 0.8,
    max_tokens: 500,
    top_p: 0.9,
    frequency_penalty: 0.5,
    presence_penalty: 0.5,
    venice_parameters: {
        include_venice_system_prompt: false
    }
});

console.log(completion.choices[0].message.content);

curl https://api.venice.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "zai-org-glm-5",
    "messages": [
      {"role": "system", "content": "You are a creative storyteller"},
      {"role": "user", "content": "Tell me a creative story"}
    ],
    "temperature": 0.8,
    "max_tokens": 500,
    "top_p": 0.9,
    "frequency_penalty": 0.5,
    "presence_penalty": 0.5,
    "stream": false,
    "venice_parameters": {
      "include_venice_system_prompt": false
    }
  }'

Consulta la documentación de Chat Completions para más información sobre todos los parámetros compatibles.

Próximos pasos

Ahora que has realizado tus primeras solicitudes, explora más de lo que la API de Venice tiene para ofrecer:

Explorar modelos

Compara todos los modelos disponibles con sus capacidades, precios y límites de contexto

Referencia de la API

Explora la documentación detallada de la API con todos los endpoints y parámetros

Respuestas estructuradas

Aprende a obtener respuestas JSON con esquemas garantizados

Guía de agentes de IA

Construye con aplicaciones de agentes, agentes de codificación, herramientas MCP, habilidades y flujos de trabajo de criptomonedas

Recursos adicionales

Límite de velocidad

Comprende los límites de velocidad y las mejores prácticas para el uso en producción

Códigos de error

Referencia para gestionar errores de la API y solucionar problemas

Colección de Postman

Importa nuestra colección completa de Postman para pruebas sencillas

Privacidad y seguridad

Conoce la arquitectura centrada en la privacidad de Venice y el manejo de datos

¿Necesitas ayuda?

Comunidad de Discord: Únete a nuestro servidor de Discord para obtener soporte y participar en discusiones
Documentación: Explora nuestra referencia completa de la API
Página de estado: Consulta el estado del servicio en veniceai-status.com
Twitter: Sigue a @AskVenice para recibir actualizaciones

Documentación

Primeros pasos

Texto y chat

Imagen, vídeo y audio

Agentes e integraciones

Herramientas de código

Herramientas para agentes

SDK y frameworks

Inicio rápido

Inicio rápido

Ver todos los modelos

Próximos pasos

Explorar modelos

Referencia de la API

Respuestas estructuradas

Guía de agentes de IA

Recursos adicionales

Límite de velocidad

Códigos de error

Colección de Postman

Privacidad y seguridad

¿Necesitas ayuda?

​Inicio rápido

Ver todos los modelos

​Próximos pasos

Explorar modelos

Referencia de la API

Respuestas estructuradas

Guía de agentes de IA

​Recursos adicionales

Límite de velocidad

Códigos de error

Colección de Postman

Privacidad y seguridad

​¿Necesitas ayuda?

Inicio rápido

Próximos pasos

Recursos adicionales

¿Necesitas ayuda?