Uma API: Guia de início rápido
Integre nossa API de LLM sem censura com uma única alteração de configuração. A compatibilidade pronta para usar significa que você altera a URL base e a chave de API, mantendo seu código existente.
URL base e autenticação
Comece apontando seu cliente para nosso endpoint dedicado. Esta API compatível com OpenAI usa cabeçalhos de autenticação padrão, então você só precisa alterar dois valores na sua configuração.
A URL base é https://api.onekeyllmapi.com/v1. Gere sua chave de API exclusiva na página de cadastro. Nenhum cartão é necessário para começar, e a chave é exibida imediatamente após o registro. Mantenha esta chave segura; ela autentica todas as requisições ao serviço.
Conclusão básica
Envie um prompt de texto simples para receber uma resposta direta. Esta é a base da nossa oferta de API de IA para desenvolvedores. O modelo retorna texto sem recusas de conteúdo para uso adulto lícito, sendo ideal para tarefas criativas ou sem restrições.
- ID do modelo:
uncensored - Endpoint:
POST /v1/chat/completions - Contexto: 100.000 tokens
Faça sua primeira requisição com este exemplo:
curl https://api.onekeyllmapi.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."}]
}'
Integração com SDK Python
Use a biblioteca oficial OpenAI Python para interagir com nosso serviço. As únicas alterações necessárias são base_url e api_key. Isso garante que sua lógica existente funcione sem modificações.
- Instale via
pip install openai - Defina variáveis de ambiente ou passe diretamente na inicialização do cliente
- Chame
chat.completions.create()como de costume
Configure o cliente assim:
from openai import OpenAI
client = OpenAI(base_url="https://api.onekeyllmapi.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)
Uso do SDK Node.js
Integre com projetos JavaScript ou TypeScript usando o pacote padrão OpenAI Node. Aponte o cliente para nossa URL e forneça sua chave. Esta abordagem mantém a compatibilidade com qualquer estrutura de cliente compatível com OpenAI.
- Instale via
npm install openai - Inicialize com URL base personalizada
- Use padrões assíncronos padrão
Exemplo de inicialização:
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.onekeyllmapi.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);
Respostas em streaming
Receba respostas token por token para reduzir a latência percebida. Nossa API de streaming suporta Server-Sent Events (SSE), permitindo que você exiba a saída conforme ela é gerada. Isso é útil para interfaces de chat ou aplicativos em tempo real.
- Defina
stream: truena sua requisição - Analise o fluxo SSE no cliente
- Gerencie tokens parciais com eficiência
Ative o streaming no seu código:
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)
Limites, erros e contexto
Entenda as limitações para criar integrações robustas. A API suporta uma janela de contexto de 100k, permitindo documentos longos ou conversas extensas. As requisições são limitadas a um tamanho de corpo de 8 MB.
Erros comuns incluem 401 para chaves inválidas, 402 quando o crédito pré-pago se esgota e 429 para exceder 300 requisições por minuto. O crédito de pagamento por uso nunca expira e você pode recarregar a partir de $10. Chamada de funções é suportada para execução de funções.
Ficha técnica da API
Todos os limites e recursos reais da API em um só lugar — confira antes de recarregar.
| Item | Valor |
|---|---|
| Formato | compatível com OpenAI: qualquer SDK da OpenAI funciona trocando a base URL e a chave |
| ID do modelo | uncensored |
| Base URL | https://api.onekeyllmapi.com/v1 |
| Autenticação | Authorization: Bearer YOUR_KEY |
| Endpoints | POST /v1/chat/completions · GET /v1/models |
| Janela de contexto | 100.000 tokens (entrada + saída) |
| Chamada de funções | sim — tools, tool_choice; resposta com tool_calls, inclusive em streaming; resultados como role: tool |
| Modo JSON | response_format: {"type": "json_object"} |
| Parâmetros | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Streaming | sim — server-sent events; o último bloco traz o uso de tokens |
| Saída máxima | até o restante da janela de 100.000 tokens; max_tokens opcional (sem limite separado) |
| Tamanho | até 8 MB por requisição |
| Cabeçalhos | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Limite de taxa | 300 requisições por minuto por chave |
| Concorrência | 8 requisições ao mesmo tempo por chave |
| Recarga | USDT (TRC20) ou USDC (Base), qualquer valor inteiro de $10 a $500 |
| Cobrança | crédito pré-pago pelo uso real; erros e recusas são grátis |
| Validade | crédito pago não expira, sem assinatura |
| Bônus | +5% a partir de $50, +10% a partir de $100 |
| Preço | $0,25 por 1M tokens de entrada · $1,00 por 1M de saída |
| Teste grátis | $0,50 por 7 dias, sem cartão · Chave de teste: 2 requisições paralelas, 60 por minuto; limites totais (8 e 300) após a primeira recarga |
| Chaves | uma chave ativa por conta; uma nova substitui a anterior |
| Login | Google ou e-mail e senha |
| Conteúdo | conteúdo adulto permitido; conteúdo sexual com menores é recusado |
Erros e o que fazer
Erros chegam em JSON com um type fixo; requisições com falha ou recusadas não são cobradas.
| Código | Tipo | Significado |
|---|---|---|
400 | bad_request | JSON inválido, mensagens vazias, parâmetro errado ou contexto longo demais |
401 | missing_key · invalid_key · key_revoked | chave ausente, errada ou substituída |
402 | no_credit | sem crédito — recarregue e continue na hora |
403 | content_blocked | conteúdo sexual com menores — recusado, sem cobrança |
404 | not_found | endpoint desconhecido |
413 | request_too_large | corpo acima de 8 MB |
429 | rate_limited · concurrency | acima de 300/min ou 8 em paralelo — aguarde e tente de novo |
503 | upstream_busy | modelo ocupado — tente em alguns segundos |
Perguntas e respostas
Este é um modelo OpenAI?
Não. Oferecemos um único modelo de linguagem grande dedicado e sem censura executado em nossos próprios servidores GPU. Não é GPT, Claude ou qualquer outro modelo de fornecedor, mas é compatível com a estrutura de API deles.
Como funciona o preço?
Usamos um modelo de pagamento por uso sem mensalidades. Tokens de entrada custam $0,25 por 1M e tokens de saída custam $1,00 por 1M. O crédito pré-pago nunca expira e você pode começar com um crédito de teste de $0,50.
Qual é o tamanho da janela de contexto?
A API suporta uma janela de contexto de 100.000 tokens para prompt e conclusão. Isso permite conversas extensas ou processamento de documentos longos em uma única requisição.
Sua chave está a um formulário de distância
Crie uma conta, copie a chave, altere a URL base. Essa é toda a configuração.