URL Base e Autenticação
Use o URL base fornecido e uma chave de API válida para conectar seu cliente. O endpoint é https://api.qwencodeapikey.com/v1. Você deve incluir sua chave no Authorization cabeçalho de cada solicitação. Isso garante que o serviço identifique corretamente sua conta de crédito pré-pago.
curl https://api.qwencodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Check my api key validity status"}]
}'
Você pode gerar uma chave via Google ou e-mail na página de cadastro. A chave aparece imediatamente. Mantenha-a segura, pois ela controla seus gastos.
Endpoint Chat Completions
Envie mensagens para o /v1/chat/completions endpoint para obter respostas de texto. Esta é a interface padrão para a maioria dos SDKs da OpenAI. Você define o model como uncensored e forneça uma lista de mensagens no messages array. A API processa sua entrada e retorna uma conclusão gerada.
from openai import OpenAI
client = OpenAI(base_url="https://api.qwencodeapikey.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)
Garanta que a biblioteca do cliente aponte para a URL base correta. O ID do modelo uncensored aciona o modelo de peso aberto ajustado para menos recusas. Ele lida com turnos de conversa como qualquer outra API de chat.
Endpoint Models
Consulta GET /v1/models para verificar os modelos disponíveis e seus detalhes. Este endpoint retorna uma lista de modelos acessíveis à sua chave. Isso ajuda você a confirmar o uncensored modelo está ativo e pronto para solicitações. Use isso para depurar configurações de cliente antes de enviar payloads completos.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.qwencodeapikey.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);
Verifique a estrutura da resposta para garantir que seu SDK analise a lista de modelos corretamente. Este endpoint não consome crédito, tornando-o seguro para verificações de inicialização.
Parâmetros de Solicitação e Streaming
Suporta parâmetros padrão como temperature, top_p, stop, e seed. Habilite o streaming definindo stream: true. A API envia tokens via Eventos Enviados pelo Servidor (SSE). As estatísticas de uso de tokens aparecem no último fragmento do fluxo. Isso permite a exibição em tempo real do texto gerado.
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)
Definir max_tokens para controlar o comprimento da saída. O padrão é 2.048 tokens. Você pode aumentar isso até 16.000 tokens por solicitação. Ajuste os parâmetros para equilibrar criatividade e precisão nas suas respostas.
Limites de Taxa e Restrições
Cada chave permite 300 solicitações por minuto e 8 solicitações simultâneas. O tamanho máximo do corpo da solicitação é de 8 MB. Esses limites previnem abusos e garantem desempenho estável. Se você exceder a taxa, receberá um erro 429. Ajuste a lógica do seu cliente para lidar com novas tentativas usando backoff exponencial.
A janela de contexto suporta 100.000 tokens no total. Isso inclui prompt e conclusão. Contextos grandes exigem gerenciamento cuidadoso de tokens para permanecer dentro dos limites.
Modo JSON e Chamada de Funções
Usar response_format: {"type": "json_object"} para saída estruturada. Isso garante que o modelo retorne JSON válido, útil para integração programática. Chamada de funções funciona via tools parâmetro. Defina ferramentas no formato padrão da OpenAI. O modelo chamará funções conforme necessário.
Erros e recusas não consomem crédito. Isso se aplica mesmo se o modelo recusar uma solicitação devido ao limite rígido de conteúdo. Você paga apenas pelo uso real de tokens. O crédito nunca expira, então você pode recarregar quando for conveniente.
Tratamento de Erros e Uso
Trate erros HTTP gracefulmente. Um erro 401 indica uma chave de API inválida ou expirada. Um erro 402 significa que seu crédito pré-pago está esgotado. Um erro 429 sinaliza limite de taxa excedido. Verifique o corpo da resposta para mensagens de erro detalhadas.
O uso é rastreado por chave. Uma chave ativa por conta simplifica a cobrança. Se você cometer um erro, como uma cobrança dupla, use a página de Suporte. O crédito não é reembolsado, mas permanece válido. Erros são gratuitos, então solicitações falhas não drenam seu saldo.
Resumo e Melhores Práticas
Comece com a URL base e uma chave válida. Use o uncensored ID do modelo para menos recusas. Transmita respostas para melhor experiência do usuário. Monitore os limites de taxa para evitar interrupções. Use o modo JSON para dados estruturados. Lidere com erros para manter a confiabilidade. O crédito é pré-pago e nunca expira. Recarregue com cripto quando necessário. Esta API se encaixa perfeitamente em codebases OpenAI existentes. Nenhum novo SDK necessário. Basta alterar a URL base e a chave.
