fr ▾
Essayez avec un crédit d'essai
Essayez avec un crédit d'essai

Documentation de l'API et Prise en main

Ce guide de démarrage rapide vous aide à intégrer notre API LLM sans censure en utilisant des points de terminaison compatibles avec OpenAI. Vous apprendrez l'URL de base, l'authentification et comment gérer le streaming, l'appel de fonctions et les limites de débit sans friction d'abonnement.

URL de base et authentification

L'URL de base pour toutes les requêtes est https://api.veniceaiapipricing.com/v1. Vous vous authentifiez en transmettant votre clé API dans le Authorization header en tant que jeton Bearer. Cette configuration fonctionne avec n'importe quel SDK OpenAI standard. Remplacez YOUR_API_KEY avec la clé générée depuis le tableau de bord de votre compte.

  • Point de terminaison : POST /v1/chat/completions
  • En-tête : Authorization: Bearer YOUR_API_KEY
curl https://api.veniceaiapipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return server status code 200"}]
  }'

Le point de terminaison /v1/chat/completions

Envoyez votre historique de conversation à /v1/chat/completions en utilisant le uncensored ID du modèle. L'API accepte des objets de message standard avec role et content champs. Les tokens d'entrée coûtent 0,15 $ par million, et les tokens de sortie coûtent 0,50 $ par million. Les erreurs et les refus ne consomment pas de crédit.

Ce point de terminaison prend en charge la génération de texte uniquement. Il ne gère pas les images, l'audio ou les embeddings. Vous pouvez diffuser les réponses ou récupérer le texte complet dans un seul objet JSON.

from openai import OpenAI

client = OpenAI(base_url="https://api.veniceaiapipricing.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Réponses en streaming (SSE)

Activez le streaming en définissant stream: true dans le corps de votre requête. L'API renvoie des événements envoyés par le serveur (SSE) pour chaque jeton généré. Le dernier fragment contient les statistiques totales d'utilisation des jetons. Cette méthode réduit la latence perçue pour les réponses longues.

La gestion des flux est essentielle pour les applications en temps réel. Vous pouvez traiter les tokens à mesure qu'ils arrivent au lieu d'attendre la complétion complète.

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Appel de fonction et mode JSON

L'API prend en charge les sorties structurées et les définitions d'outils. Utilisez response_format: {"type": "json_object"} pour forcer la sortie JSON. Vous pouvez également passer tools pour l'appel de fonction, permettant au modèle de retourner des données structurées pour la logique de votre application.

Cette fonctionnalité est utile pour extraire des données ou déclencher des actions. Le modèle renvoie des appels d'outils dans un format standardisé. Vous pouvez ensuite exécuter vos fonctions et renvoyer les résultats dans la conversation.

Paramètres : Température, Top P et Seeds

Contrôlez la créativité avec temperature et top_p. Le seed parameter garantit des sorties déterministes pour les tests. Ces paramètres suivent les conventions standard d'OpenAI. Leur ajustement affecte l'aléatoire du texte généré.

Définir temperature vers 0,7 pour un équilibre entre créativité. Utilisez seed pour des résultats reproductibles. L'API ignore gracieusement les paramètres non pris en charge.

Limites de débit et contraintes

Vous êtes limité à 300 requêtes par minute par clé. Un maximum de 8 requêtes simultanées est autorisé par clé. La taille du corps de la requête est plafonnée à 8 Mo. La fenêtre de contexte est de 100 000 tokens pour l'entrée et la sortie combinées. La sortie maximale par requête est de 16 000 tokens.

Le dépassement de ces limites renvoie une erreur 429. Assurez-vous que votre client gère les tentatives correctement. La clé API est unique par compte ; générer une nouvelle clé remplace l'ancienne.

Node.js

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.veniceaiapipricing.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Questions fréquentes

Quel est le prix de l'API Venice AI pour les tokens d'entrée et de sortie ?

Les tokens d'entrée coûtent 0,15 $ par million de tokens, et les tokens de sortie coûtent 0,50 $ par million de tokens. Vous ne payez que pour la consommation réelle, les erreurs et les refus étant gratuits.

Comment gérer les erreurs d'authentification comme les 401 ou 402 ?

Une erreur 401 indique une clé API invalide ou manquante. Une erreur 402 signifie que le solde de vos crédits prépayés est insuffisant. Rechargez en crypto pour restaurer l'accès.

Que se passe-t-il lorsque je dépasse la limite de débit ?

L'API renvoie une erreur 429 lorsque vous dépassez 300 requêtes par minute ou 8 connexions simultanées. Attendez brièvement avant de réessayer ou réduisez la fréquence de vos requêtes.

Obtenez votre clé API

Inscrivez-vous, récupérez votre clé, mettez à jour l'URL de base. C'est tout.