> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-mintlify-5ac44112.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Inicio rápido

> Inicio rápido para la API de Venice: genera una clave de API, envía tu primera finalización de chat y explora los endpoints de imagen, video y audio en minutos.

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

## Inicio rápido

<Steps>
  <Step title="Obtén tu clave de API">
    Ve a la [configuración de la API de Venice](https://venice.ai/settings/api) y genera una nueva clave de API.

    Para ver un tutorial detallado, consulta la [guía de claves de API](/guides/getting-started/generating-api-key).
  </Step>

  <Step title="Configura tu clave de API">
    Añade tu clave de API a tu entorno. Puedes exportarla en tu shell:

    ```bash theme={"system"}
    export VENICE_API_KEY='your-api-key-here'
    ```

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

    ```bash theme={"system"}
    VENICE_API_KEY=your-api-key-here
    ```
  </Step>

  <Step title="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.

    <CodeGroup>
      ```bash Python theme={"system"}
      pip install openai
      ```

      ```bash Node.js theme={"system"}
      npm install openai
      ```
    </CodeGroup>
  </Step>

  <Step title="Envía tu primera solicitud">
    <CodeGroup>
      ```python Python theme={"system"}
      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)
      ```

      ```javascript Node.js theme={"system"}
      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);
      ```

      ```bash cURL theme={"system"}
      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?"}
          ]
        }'
      ```
    </CodeGroup>

    **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)
  </Step>

  <Step title="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

    <Card title="Ver todos los modelos" icon="database" href="/overview/models">
      Explora la lista completa de modelos con precios, capacidades y límites de contexto
    </Card>
  </Step>

  <Step title="Usa los parámetros de Venice">
    Puedes optar por habilitar funciones específicas de Venice, como la búsqueda web, mediante `venice_parameters`:

    <CodeGroup>
      ```python Python theme={"system"}
      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)
      ```

      ```javascript Node.js theme={"system"}
      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);
      ```

      ```bash cURL theme={"system"}
      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
          }
        }'
      ```
    </CodeGroup>

    Consulta todos los [parámetros disponibles](https://docs.venice.ai/api-reference/api-spec#venice-parameters).
  </Step>

  <Step title="Habilita el streaming (opcional)">
    Transmite las respuestas en tiempo real usando `stream=True`:

    <CodeGroup>
      ```python Python theme={"system"}
      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="")
      ```

      ```javascript Node.js theme={"system"}
      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);
          }
      }
      ```

      ```bash cURL theme={"system"}
      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
        }'
      ```
    </CodeGroup>
  </Step>

  <Step title="Personaliza el comportamiento de las respuestas (opcional)">
    Controla cómo responde el modelo con parámetros como temperature, max tokens y más:

    <CodeGroup>
      ```python Python theme={"system"}
      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)
      ```

      ```javascript Node.js theme={"system"}
      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);
      ```

      ```bash cURL theme={"system"}
      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
          }
        }'
      ```
    </CodeGroup>

    Consulta la [documentación de Chat Completions](/api-reference/endpoint/chat/completions) para más información sobre todos los parámetros compatibles.
  </Step>
</Steps>

***

## Próximos pasos

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

<CardGroup cols={2}>
  <Card title="Explorar modelos" icon="database" href="/overview/models">
    Compara todos los modelos disponibles con sus capacidades, precios y límites de contexto
  </Card>

  <Card title="Referencia de la API" icon="code" href="/api-reference/api-spec">
    Explora la documentación detallada de la API con todos los endpoints y parámetros
  </Card>

  <Card title="Respuestas estructuradas" icon="brackets-curly" href="/guides/features/structured-responses">
    Aprende a obtener respuestas JSON con esquemas garantizados
  </Card>

  <Card title="Guía de agentes de IA" icon="robot" href="/guides/integrations/ai-agents">
    Construye con aplicaciones de agentes, agentes de codificación, herramientas MCP, habilidades y flujos de trabajo de criptomonedas
  </Card>
</CardGroup>

### Recursos adicionales

<CardGroup cols={2}>
  <Card title="Límite de velocidad" icon="gauge" href="/api-reference/rate-limiting">
    Comprende los límites de velocidad y las mejores prácticas para el uso en producción
  </Card>

  <Card title="Códigos de error" icon="triangle-exclamation" href="/api-reference/error-codes">
    Referencia para gestionar errores de la API y solucionar problemas
  </Card>

  <Card title="Colección de Postman" icon="bolt" href="/guides/getting-started/postman">
    Importa nuestra colección completa de Postman para pruebas sencillas
  </Card>

  <Card title="Privacidad y seguridad" icon="shield" href="/overview/privacy">
    Conoce la arquitectura centrada en la privacidad de Venice y el manejo de datos
  </Card>
</CardGroup>

***

## ¿Necesitas ayuda?

* **Comunidad de Discord**: Únete a nuestro [servidor de Discord](https://discord.gg/askvenice) para obtener soporte y participar en discusiones
* **Documentación**: Explora nuestra [referencia completa de la API](/api-reference/api-spec)
* **Página de estado**: Consulta el estado del servicio en [veniceai-status.com](https://veniceai-status.com)
* **Twitter**: Sigue a [@AskVenice](https://x.com/AskVenice) para recibir actualizaciones

<Resources />