API Qwen: primeira requisição em cinco minutos

URL base e autenticação

Nossa API segue o formato padrão da OpenAI, facilitando a alteração da configuração do seu cliente existente. A URL base para todas as requisições é https://api.qwenapis.com/v1. Você precisará de uma chave de API para autenticar suas requisições. Se você ainda não criou uma, visite a página Obter chave de API para gerar uma chave usando apenas seu e-mail e senha. Não é necessário cartão de crédito para começar com o crédito de teste.

Cada conta está limitada a uma chave ativa por vez. Você pode regenerar sua chave a qualquer momento, o que revoga imediatamente a anterior. Isso garante que, se sua chave for exposta, você possa proteger sua conta instantaneamente sem esperar pelo ciclo mensal. Mantenha sua chave segura em suas variáveis de ambiente ou gerenciador de segredos.

Faça sua primeira requisição

Verifique sua configuração enviando uma solicitação simples de conclusão de texto. O exemplo a seguir usa curl para enviar um prompt para o modelo sem censura. Substitua YOUR_API_KEY pela chave gerada na etapa anterior. O ID do modelo é definido como uncensored, que é ajustado para responder sem recusas de conteúdo para uso adulto lícito.

Copycurl https://api.qwenapis.com/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."}]
  }'

Se bem-sucedido, você receberá uma resposta JSON contendo o texto gerado. Se receber um erro 401, verifique se sua chave está correta. Um erro 402 indica que seu crédito pré-pago foi esgotado.

Integração com SDK Python

Para desenvolvedores Python, o SDK oficial da OpenAI funciona diretamente com nosso endpoint. Instale a biblioteca usando pip, em seguida, configure o client para apontar para nossa URL base. Isso permite que você use métodos familiares como chat.completions.create() sem alterar significativamente a lógica do seu aplicativo. O SDK cuida da serialização JSON e da lógica de retry para você.

Copyfrom openai import OpenAI

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

Lembre-se de definir corretamente o api_key e o base_url. O nome do modelo permanece uncensored. Esta abordagem garante compatibilidade com código escrito para outros provedores, facilitando a alternância ou teste de diferentes endpoints.

Uso do SDK Node.js

Desenvolvedores Node.js podem usar o pacote npm @anthropic-ai/sdk ou o oficial openai. Configure o cliente com nossa URL base e sua chave de API. A estrutura da requisição é idêntica à de outros serviços compatíveis com OpenAI. Isso permite integrar o Qwen sem censura em seus aplicativos Node.js existentes com mínimas alterações de código.

Copyimport OpenAI from "openai";

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

Certifique-se de lidar adequadamente com a resposta assíncrona. O SDK retornará o objeto de conclusão completo, incluindo estatísticas de uso de tokens. Isso ajuda você a monitorar o consumo de seu crédito pré-pago em tempo real.

Ativar streaming

Para menor latência e uma melhor experiência do usuário, ative o streaming nas suas requisições. O streaming envia o token da resposta conforme ele é gerado, permitindo que seu aplicativo exiba o output progressivamente. Defina o parâmetro stream como true na sua requisição. O SDK fornecerá um stream iterável de pedaços.

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)

Isso é particularmente útil para geração de conteúdo longo ou aplicativos interativos. Cada bloco contém texto parcial, que você pode adicionar ao seu buffer de exibição. O stream termina quando o modelo completa a resposta ou atinge o limite da janela de contexto.

Limites, erros e contexto

Nossa API tem limites específicos para garantir uso justo. Você tem permissão para 300 requisições por minuto por chave. O tamanho máximo do corpo da requisição é 8 MB. A janela de contexto é de 100.000 tokens, abrangendo tanto o prompt quanto a conclusão. Se você exceder o limite de requisições, receberá um erro 429. Se seu crédito for insuficiente, receberá um erro 402. Para chaves inválidas, receberá um erro 401. Esses erros ajudam você a gerenciar o fluxo do seu aplicativo e o uso de crédito de forma eficaz.