Guida rapida per gli utenti Qwen

Autenticazione e URL di base

La nostra API utilizza l'autenticazione standard con token Bearer. Ricevi la tua chiave immediatamente dopo esserti registrato tramite Google o email. Conserva questa chiave in modo sicuro; garantisce l'accesso al tuo credito prepagato. L'URL di base per tutte le richieste è https://api.qwenapi.cc/v1. Aggiorna la configurazione del tuo client per puntare a questo endpoint invece dell'URL predefinito di OpenAI.

L'autenticazione viene gestita passando l'intestazione Authorization con ogni richiesta. Senza una chiave API, il modello non può verificare il saldo del tuo account, risultando in un errore 401. Non sono necessarie intestazioni nascoste o schemi di autenticazione personalizzati.

Prima richiesta

Invia una richiesta standard di completamento chat per testare la connettività. Sostituisci YOUR_API_KEY con la tua chiave effettiva. L'endpoint accetta payload JSON standard con i campi model, messages e content.

• Identificatore del modello: uncensored
• Endpoint: POST /v1/chat/completions
• Formato: JSON

Questa richiesta consumerà token di input dal tuo saldo. Assicurati che il tuo client gestisca correttamente la risposta JSON per verificare che la connessione funzioni.

Integrazione SDK Python

Utilizza la libreria ufficiale Python di OpenAI. Richiede una configurazione minima per instradare il traffico verso il nostro endpoint. Inizializza il client con la tua chiave e l'URL di base corretto. Questo approccio sfrutta le codebase esistenti senza riscrivere la logica delle richieste.

Passa l'ID del modello uncensored quando crei la risposta. La libreria gestisce automaticamente la serializzazione e la deserializzazione. Questo metodo è consigliato per la maggior parte delle integrazioni backend e dei flussi di lavoro basati su script.

Integrazione SDK Node.js

Per gli ambienti JavaScript o TypeScript, utilizza il pacchetto @anthropic-ai/sdk o quello standard di OpenAI per Node. Configura l'URL di base per puntare alla nostra API. Questo ti permette di integrare il nostro servizio nelle applicazioni Node esistenti senza un importante refactoring.

Assicurati di utilizzare una versione recente dell'SDK che supporti gli URL di base personalizzati. Passa l'identificatore del modello uncensored per selezionare il nostro modello senza censura. Questa configurazione funziona perfettamente con le route Express o le funzioni serverless.

Risposte in streaming

Abilita lo streaming impostando stream: true nella tua richiesta. L'API restituisce Server-Sent Events (SSE) mentre il modello genera testo. Questo fornisce una latenza inferiore per gli utenti finali e consente la visualizzazione in tempo reale dell'output.

Le statistiche sull'utilizzo dei token sono incluse nell'ultimo chunk dello streaming. Elabora ogni delta in modo incrementale per costruire la risposta completa. Questa funzione è essenziale per le interfacce chat e le applicazioni che richiedono feedback immediato.

Limiti, errori e contesto

Rispetta i limiti di richiesta per evitare interruzioni del servizio. L'API consente 300 richieste al minuto e 8 richieste parallele per chiave. La dimensione massima del corpo della richiesta è di 8 MB. Se superi questi limiti, riceverai un errore 429.

Gli errori di autenticazione restituiscono 401, indicando una chiave non valida o mancante. Gli errori di saldo restituiscono 402, il che significa che il tuo credito prepagato è esaurito. La finestra di contesto supporta 100.000 token in totale, con un output massimo di 32.000 token per richiesta. Errori e rifiuti non consumano crediti.

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)