PT ▾
Obter chave de API

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: true na 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.

ItemValor
Formatocompatível com OpenAI: qualquer SDK da OpenAI funciona trocando a base URL e a chave
ID do modelouncensored
Base URLhttps://api.onekeyllmapi.com/v1
AutenticaçãoAuthorization: Bearer YOUR_KEY
EndpointsPOST /v1/chat/completions · GET /v1/models
Janela de contexto100.000 tokens (entrada + saída)
Chamada de funçõessim — tools, tool_choice; resposta com tool_calls, inclusive em streaming; resultados como role: tool
Modo JSONresponse_format: {"type": "json_object"}
Parâmetrostemperature, top_p, stop, seed, presence_penalty, frequency_penalty
Streamingsim — server-sent events; o último bloco traz o uso de tokens
Saída máximaaté o restante da janela de 100.000 tokens; max_tokens opcional (sem limite separado)
Tamanhoaté 8 MB por requisição
CabeçalhosX-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency
Limite de taxa300 requisições por minuto por chave
Concorrência8 requisições ao mesmo tempo por chave
RecargaUSDT (TRC20) ou USDC (Base), qualquer valor inteiro de $10 a $500
Cobrançacrédito pré-pago pelo uso real; erros e recusas são grátis
Validadecré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
Chavesuma chave ativa por conta; uma nova substitui a anterior
LoginGoogle ou e-mail e senha
Conteúdoconteú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ódigoTipoSignificado
400bad_requestJSON inválido, mensagens vazias, parâmetro errado ou contexto longo demais
401missing_key · invalid_key · key_revokedchave ausente, errada ou substituída
402no_creditsem crédito — recarregue e continue na hora
403content_blockedconteúdo sexual com menores — recusado, sem cobrança
404not_foundendpoint desconhecido
413request_too_largecorpo acima de 8 MB
429rate_limited · concurrencyacima de 300/min ou 8 em paralelo — aguarde e tente de novo
503upstream_busymodelo 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.