Guide de démarrage pour les utilisateurs de Qwen

Authentification et URL de base

Notre API utilise l'authentification standard par token Bearer. Vous recevez votre clé immédiatement après vous être connecté via Google ou e-mail. Conservez cette clé en sécurité ; elle donne accès à votre crédit prépayé. L'URL de base pour toutes les requêtes est https://api.qwenapi.cc/v1. Mettez à jour la configuration de votre client pour pointer vers cet endpoint au lieu de l'URL OpenAI par défaut.

L'authentification est gérée en passant l'en-tête Authorization avec chaque requête. Sans clé API, le modèle ne peut pas vérifier le solde de votre compte, ce qui entraîne une erreur 401. Aucun en-tête caché ni schéma d'authentification personnalisé n'est requis.

Première requête

Envoyez une requête standard de complétion de chat pour tester la connectivité. Remplacez YOUR_API_KEY par votre clé réelle. L'endpoint accepte des charges utiles JSON standard avec les champs model, messages et content.

• Identifiant du modèle : uncensored
• Endpoint : POST /v1/chat/completions
• Format : JSON

Cette requête consommera des tokens d'entrée de votre solde. Assurez-vous que votre client gère correctement la réponse JSON pour vérifier que la connexion fonctionne.

Intégration du SDK Python

Utilisez la bibliothèque Python officielle OpenAI. Elle nécessite une configuration minimale pour acheminer le trafic vers notre endpoint. Initialisez le client avec votre clé et la bonne URL de base. Cette approche exploite les bases de code existantes sans réécrire la logique des requêtes.

Transmettez l'identifiant du modèle uncensored lors de la création de la réponse. La bibliothèque gère automatiquement la sérialisation et la désérialisation. Cette méthode est recommandée pour la plupart des intégrations backend et des workflows basés sur des scripts.

Intégration du SDK Node.js

Pour les environnements JavaScript ou TypeScript, utilisez le package @anthropic-ai/sdk ou le package standard OpenAI Node. Configurez l'URL de base pour pointer vers notre API. Cela vous permet d'intégrer notre service dans les applications Node existantes sans refonte majeure.

Assurez-vous d'utiliser une version récente du SDK qui prend en charge les URL de base personnalisées. Transmettez l'identifiant du modèle uncensored pour sélectionner notre modèle sans censure. Cette configuration fonctionne parfaitement avec les routes Express ou les fonctions serverless.

Réponses en streaming

Activez le streaming en définissant stream: true dans votre requête. L'API renvoie des Server-Sent Events (SSE) lorsque le modèle génère du texte. Cela offre une latence plus faible pour les utilisateurs finaux et permet l'affichage en temps réel de la sortie.

Les statistiques d'utilisation des tokens sont incluses dans le dernier fragment du flux. Traitez chaque delta de manière incrémentale pour construire la réponse complète. Cette fonctionnalité est essentielle pour les interfaces de chat et les applications nécessitant une rétroaction immédiate.

Limites, erreurs et contexte

Respectez les limites de débit pour éviter les perturbations du service. L'API autorise 300 requêtes par minute et 8 requêtes simultanées par clé. La taille maximale du corps de la requête est de 8 Mo. Si vous dépassez ces limites, vous recevrez une erreur 429.

Les erreurs d'authentification renvoient 401, indiquant une clé invalide ou manquante. Les erreurs de solde renvoient 402, signifiant que votre crédit prépayé est épuisé. La fenêtre de contexte prend en charge 100 000 tokens au total, avec une sortie maximale de 32 000 tokens par requête. Les erreurs et les refus ne consomment pas de crédits.

cURL

Copycurl https://api.qwenapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.qwenapi.cc/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)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.qwenapi.cc/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);

Streaming

Copystream = 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)