Démarrage rapide

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

Obtenez votre clé API

Rendez-vous dans vos paramètres d’API Venice et générez une nouvelle clé API.Pour un guide détaillé, consultez le guide sur les clés API.

Configurez votre clé API

Ajoutez votre clé API à votre environnement. Vous pouvez l’exporter dans votre shell :

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

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

VENICE_API_KEY=your-api-key-here

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.

pip install openai

npm install openai

Envoyez votre première requête

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?"}
    ]
  }'

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)

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

Voir tous les modèles

Parcourez la liste complète des modèles avec leurs tarifs, capacités et limites de contexte

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 :

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
    }
  }'

Consultez tous les paramètres disponibles.

Activez le streaming (optionnel)

Diffusez les réponses en temps réel à l’aide de 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
  }'

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 :

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
    }
  }'

Consultez la documentation Chat Completions pour plus d’informations sur tous les paramètres pris en charge.

Étapes suivantes

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

Parcourir les modèles

Comparez tous les modèles disponibles avec leurs capacités, tarifs et limites de contexte

Référence de l'API

Explorez la documentation détaillée de l’API avec tous les points de terminaison et paramètres

Réponses structurées

Apprenez à obtenir des réponses JSON avec des schémas garantis

Guide des agents IA

Construisez avec des applications d’agents, des agents de codage, des outils MCP, des compétences et des workflows crypto

Ressources supplémentaires

Limitation de débit

Comprenez les limites de débit et les bonnes pratiques pour une utilisation en production

Codes d'erreur

Référence pour gérer les erreurs de l’API et résoudre les problèmes

Collection Postman

Importez notre collection Postman complète pour des tests faciles

Confidentialité et sécurité

Découvrez l’architecture axée sur la confidentialité de Venice et la gestion des données

Besoin d’aide ?

Communauté Discord : Rejoignez notre serveur Discord pour du support et des discussions
Documentation : Parcourez notre référence complète de l’API
Page de statut : Vérifiez l’état du service sur veniceai-status.com
Twitter : Suivez @AskVenice pour les mises à jour

Documentation

Démarrage

Texte et chat

Image, vidéo et audio

Agents et intégrations

Outils de code

Outils pour agents

SDK et frameworks

Démarrage rapide