Início rápido para pipelines Acestep

Pré-requisitos: Obtenha sua chave de API

Antes de fazer requisições, você precisa de uma chave de API válida. Acesse a página Obter chave de API em acestep.cc. Você pode entrar usando Continuar com Google ou criando uma conta com e-mail e senha. Não é necessário número de telefone. Após o registro, sua chave de API é exibida imediatamente. Copie esta chave; você a usará para autenticar todas as requisições subsequentes. Se você não tiver crédito, precisará recarregar. Aceitamos apenas pagamentos em criptomoedas (USDT na rede TRC20 ou USDC na Base) para valores entre $10 e $500. Contas novas recebem $0,50 de crédito de teste válido por 7 dias, sem necessidade de cartão para começar. Mantenha sua chave segura, pois ela autentica seu uso contra os limites de requisições e o consumo de tokens.

Instalação

A API usa o protocolo padrão compatível com OpenAI. Você pode interagir com ela usando os SDKs oficiais da OpenAI para sua linguagem preferida ou qualquer cliente HTTP. Para Python, instale o pacote openai. Para Node.js, instale openai. Certifique-se de estar usando uma versão recente do SDK que suporte URLs base personalizados. O URL base para nosso serviço é https://api.acestep.cc/v1. Isso permite que você reutilize código de pipeline existente que espera endpoints da OpenAI, simplesmente substituindo o URL base e a chave de API. O ID do modelo que você deve especificar em suas solicitações é uncensored. Este modelo é um LLM de pesos abertos ajustado para minimizar recusas em tópicos adultos lícitos, fictícios ou controversos, tornando-o ideal para pipelines criativos onde filtros de conteúdo poderiam bloquear saídas criativas válidas.

Solicitação básica: Gerar texto

Envie uma requisição POST para /v1/chat/completions com seu prompt de sistema e mensagens do usuário. O modelo retornará o texto gerado. Certifique-se de definir o parâmetro model como uncensored. Você pode controlar a criatividade com temperature e top_p. A janela de contexto suporta até 100.000 tokens no total (prompt + completion). A saída máxima por requisição é de 32.000 tokens, ou 2.048 se você não especificar max_tokens. Erros e recusas não consomem crédito, mas a geração bem-sucedida de tokens consome. Use este endpoint para gerar scripts, legendas ou processar dados de texto antes de passá-los para outras modalidades, como APIs de geração de fala ou imagem.

Streaming de respostas

Para atualizações em tempo real, defina stream: true em sua requisição. A API retorna Server-Sent Events (SSE). Cada fragmento contém texto parcial. Detalhes do uso de tokens são fornecidos no último fragmento do stream. Isso é útil para aplicações que exibem texto conforme é gerado, melhorando a latência percebida para os usuários. Certifique-se de que seu cliente lide corretamente com SSE. O stream permite que você processe tokens conforme chegam, o que é benéfico para a geração de conteúdo longo em seu pipeline. Lembre-se de que o streaming não altera o preço ou os limites de tokens; você ainda será cobrado pelos tokens totais gerados.

Chamada de funções

A API suporta chamada de funções, permitindo que o modelo produza dados estruturados com base nas ferramentas definidas por você. Defina suas funções no parâmetro tools. Defina tool_choice para auto ou um nome de função específico. O modelo responderá com um objeto de chamada de função se apropriado. Isso é valioso para extrair dados estruturados de texto ou preparar entradas para chamadas de API subsequentes. Você também pode forçar saída JSON definindo response_format para {"type": "json_object"}. Isso garante que o modelo retorne JSON válido, o que é crítico para integração confiável no seu pipeline automatizado. Use esses recursos para melhorar a confiabilidade das etapas de processamento de texto.

Preços e limites

O preço é $0,25 por 1M de tokens de entrada e $1,00 por 1M de tokens de saída. O crédito é pré-pago e nunca expira. Erros são gratuitos. Os limites de requisições são de 300 requisições por minuto por chave e 8 requisições simultâneas ao mesmo tempo por chave. O tamanho máximo do corpo da requisição é de 8 MB. Se você exceder o limite de requisições, receberá um erro 429. Um erro 401 indica uma chave inválida ou expirada. Um erro 402 significa que você tem crédito insuficiente. Reembolsos não são emitidos para crédito; disputas são tratadas pela página de Suporte. Uma chave ativa é permitida por conta; gerar uma nova chave substitui a antiga. Tenha esses limites em mente ao projetar a lógica de retry do seu pipeline.

cURL

Copycurl https://api.acestep.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.acestep.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.acestep.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)