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

# Démarrage rapide

> Générez une clé API Venice, installez le SDK compatible OpenAI et envoyez votre première requête de chat completion à api.venice.ai en quelques minutes.

Prenez en main l'API Venice en quelques minutes. Générez une clé API, effectuez votre première requête et commencez à construire.

## Démarrage rapide

<Steps>
  <Step title="Obtenez votre clé API">
    Rendez-vous dans vos [paramètres d'API Venice](https://venice.ai/settings/api?utm_source=venice-api-documentation) et générez une nouvelle clé API.

    Pour un guide détaillé, consultez le [guide sur les clés API](/guides/getting-started/generating-api-key).
  </Step>

  <Step title="Configurez votre clé API">
    Ajoutez votre clé API à votre environnement. Vous pouvez l'exporter dans votre shell :

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

    Ou l'ajouter à un fichier `.env` dans votre projet :

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

  <Step title="Installez le SDK">
    Venice est compatible avec OpenAI, vous pouvez donc utiliser le SDK OpenAI. Si vous préférez utiliser cURL ou des requêtes HTTP brutes, vous pouvez ignorer cette étape.

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

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

  <Step title="Envoyez votre première requête">
    <CodeGroup>
      ```python Python theme={null}
      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={null}
      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={null}
      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>

    **Rôles des messages :**

    * `system` - Instructions sur la façon dont le modèle doit se comporter
    * `user` - Vos invites ou questions
    * `assistant` - Réponses précédentes du modèle (pour les conversations à plusieurs tours)
    * `tool` - Résultats d'appels de fonctions (lors de l'utilisation d'outils)
  </Step>

  <Step title="Changez de modèle en modifiant l'ID du modèle">
    Chaque requête inclut un ID `model`. Pour utiliser un modèle différent, modifiez la valeur `model` dans votre requête. Choix populaires :

    * `zai-org-glm-5` - Modèle par défaut pour la plupart des cas d'usage
    * `kimi-k2-6` - Raisonnement solide pour des tâches plus complexes
    * `claude-opus-4-8` - Modèle de haute intelligence pour les tâches complexes
    * `venice-uncensored-1-2` - Le modèle non censuré de Venice

    <Card title="Voir tous les modèles" icon="database" href="/overview/models">
      Parcourez la liste complète des modèles avec leurs tarifs, capacités et limites de contexte
    </Card>
  </Step>

  <Step title="Utilisez les paramètres Venice">
    Vous pouvez choisir d'activer des fonctionnalités spécifiques à Venice comme la recherche web à l'aide de `venice_parameters` :

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

    Consultez tous les [paramètres disponibles](https://docs.venice.ai/api-reference/api-spec#venice-parameters).
  </Step>

  <Step title="Activez le streaming (optionnel)">
    Diffusez les réponses en temps réel à l'aide de `stream=True` :

    <CodeGroup>
      ```python Python theme={null}
      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={null}
      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={null}
      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="Personnalisez le comportement des réponses (optionnel)">
    Contrôlez la façon dont le modèle répond avec des paramètres comme la température, le nombre maximal de tokens, et plus encore :

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

    Consultez la [documentation Chat Completions](/api-reference/endpoint/chat/completions) pour plus d'informations sur tous les paramètres pris en charge.
  </Step>
</Steps>

***

## Étapes suivantes

Maintenant que vous avez effectué vos premières requêtes, explorez davantage ce que l'API Venice a à offrir :

<CardGroup cols={2}>
  <Card title="Parcourir les modèles" icon="database" href="/overview/models">
    Comparez tous les modèles disponibles avec leurs capacités, tarifs et limites de contexte
  </Card>

  <Card title="Référence de l'API" icon="code" href="/api-reference/api-spec">
    Explorez la documentation détaillée de l'API avec tous les points de terminaison et paramètres
  </Card>

  <Card title="Réponses structurées" icon="brackets-curly" href="/guides/features/structured-responses">
    Apprenez à obtenir des réponses JSON avec des schémas garantis
  </Card>

  <Card title="Guide des agents IA" icon="robot" href="/guides/integrations/ai-agents">
    Construisez avec des applications d'agents, des agents de codage, des outils MCP, des compétences et des workflows crypto
  </Card>
</CardGroup>

### Ressources supplémentaires

<CardGroup cols={2}>
  <Card title="Limitation de débit" icon="gauge" href="/api-reference/rate-limiting">
    Comprenez les limites de débit et les bonnes pratiques pour une utilisation en production
  </Card>

  <Card title="Codes d'erreur" icon="triangle-exclamation" href="/api-reference/error-codes">
    Référence pour gérer les erreurs de l'API et résoudre les problèmes
  </Card>

  <Card title="Collection Postman" icon="bolt" href="/guides/getting-started/postman">
    Importez notre collection Postman complète pour des tests faciles
  </Card>

  <Card title="Confidentialité et sécurité" icon="shield" href="/overview/privacy">
    Découvrez l'architecture axée sur la confidentialité de Venice et la gestion des données
  </Card>
</CardGroup>

***

## Besoin d'aide ?

* **Communauté Discord** : Rejoignez notre [serveur Discord](https://discord.gg/askvenice) pour du support et des discussions
* **Documentation** : Parcourez notre [référence complète de l'API](/api-reference/api-spec)
* **Page de statut** : Vérifiez l'état du service sur [veniceai-status.com](https://veniceai-status.com)
* **Twitter** : Suivez [@AskVenice](https://x.com/AskVenice) pour les mises à jour

<Resources />