Início Rápido da API

Autenticação & URL Base

A API utiliza autenticação padrão compatível com OpenAI. Você recebe uma chave de API imediatamente após o cadastro com Google ou e-mail. Use esta chave no Authorization cabeçalho para todas as solicitações. A URL base é fixa em https://api.mistralabliterated.com/v1. Nenhuma configuração adicional é necessária para o caminho do endpoint.

Copycurl https://api.mistralabliterated.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the first five prime numbers"}]
  }'

Sua chave identifica sua conta e rastreia o uso. Se você perder sua chave, gere uma nova; a antiga se tornará inválida.

POST /v1/chat/completions

Envie mensagens para o modelo usando o endpoint padrão de chat completion. O ID do modelo é sempre uncensored. Esse endpoint lida com interações de texto-in, texto-out sem exigir estruturas de payload complexas. Você pode enviar mensagens de system, user e assistant em uma única solicitação.

Copyfrom openai import OpenAI

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

A solicitação retorna uma resposta JSON estruturada contendo a saída do modelo. Você pode ajustar parâmetros como temperatura e top_p para controlar a criatividade. O modelo não recusa tópicos adultos legais ou controversos, fornecendo um estilo de resposta bruto. Erros retornam códigos de status HTTP padrão para depuração fácil na sua base de código.

GET /v1/models

Consulte os modelos disponíveis para verificar a conectividade e a configuração. Este endpoint retorna uma lista de modelos disponíveis, confirmando que sua autenticação e URL base estão corretos. É útil para testar sua integração antes de enviar cargas pesadas.

Copyimport OpenAI from "openai";

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

A resposta inclui o ID do modelo e o tipo de objeto. Você pode usar este endpoint na sequência de inicialização do seu aplicativo para garantir que a API esteja acessível. Ele retorna imediatamente com baixa latência, tornando-o ideal para verificações de status. Nenhum crédito é consumido por esta solicitação.

Streaming & Ferramentas

Ative o streaming definindo stream: true na sua solicitação. A API envia blocos de texto via Server-Sent Events (SSE) conforme são gerados. Isso reduz a latência percebida para usuários aguardando respostas longas. Você também pode usar chamada de funções fornecendo uma lista de ferramentas na solicitação.

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)

As estatísticas de uso de tokens estão incluídas no último chunk do stream. Isso permite que você rastreie os custos em tempo real. O modelo suporta modo JSON para saídas estruturadas quando você define response_format para {"type": "json_object"}. As escolhas de ferramentas são flexíveis, permitindo seleção específica ou automática.

Parâmetros & Limites

A janela de contexto suporta 100.000 tokens para prompt e conclusão combinados. A saída máxima por solicitação é de 16.000 tokens, ou 2.048 se você não especificar max_tokens. Você pode controlar a geração com temperature, top_p, stop, e seed parâmetros. Penalidades de frequência e presença também estão disponíveis para ajuste fino.

Os limites de taxa permitem 300 solicitações por minuto por chave e 8 solicitações simultâneas. O tamanho máximo do corpo da solicitação é de 8 MB. Esses limites garantem desempenho estável para aplicativos de alto rendimento. Ajuste sua estratégia de agrupamento para permanecer dentro desses limites.

Erros & Preços

HTTP 401 indica uma chave de API inválida ou ausente. HTTP 402 significa que seu crédito pré-pago está esgotado; recarregue com cripto para continuar. HTTP 429 sinaliza o esgotamento do limite de taxa; aguarde ou reduza a concorrência. Erros não consomem crédito, então você não é cobrado por solicitações falhas.

O preço é $0,15 por milhão de tokens de entrada e $0,50 por milhão de tokens de saída. O crédito nunca expira, e não há taxas mensais. As recargas começam em $20 com bônus para valores maiores. Reembolsos não estão disponíveis, mas o suporte pode corrigir cobranças duplicadas.