> ## Documentation Index
> Fetch the complete documentation index at: https://docs.venice.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Démarrage rapide

> Démarrage rapide pour l'API Venice — générez une clé API, envoyez votre première complétion de chat et explorez les points de terminaison d'image, de vidéo et d'audio 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) 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={"system"}
    export VENICE_API_KEY='your-api-key-here'
    ```

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

    ```bash theme={"system"}
    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={"system"}
      pip install openai
      ```

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

  <Step title="Envoyez votre première requête">
    <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>

    **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={"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>

    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={"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="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={"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>

    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 />