Documentação da API

Autenticação & URL Base

Come apontando seu cliente para a URL base correta. Aceitamos cabeçalhos padrão do OpenAI para compatibilidade. Sua chave de API vai no cabeçalho Authorization como um token bearer. Passe-a diretamente de suas variáveis de ambiente para evitar codificar segredos. Esta configuração funciona com qualquer biblioteca que suporte o protocolo OpenAI.

Primeira solicitação

Envie uma conclusão de chat simples para verificar a conectividade. Use o ID do modelo "uncensored" para geração de texto. O endpoint retorna JSON padrão com escolhas e métricas de uso. Se você receber 401, verifique o formato da sua chave. Um 402 indica saldo pré-pago insuficiente. Este teste rápido confirma que sua integração está pronta para tráfego de produção.

Copycurl https://api.mistralbaseurl.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List installed python packages with versions"}]
  }'

Integração do SDK Python

Configure o pacote OpenAI Python para usar nossa URL base. Defina a chave da API e o nome do modelo explicitamente. Passe suas mensagens como uma lista de dicionários com chaves role e content. O objeto de resposta contém o texto gerado em choices[0].message.content. Lidar com exceções de forma elegante para capturar erros de rede ou de limite de taxa durante a execução.

Copyfrom openai import OpenAI

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

Configuração do SDK Node.js

Inicialize o cliente OpenAI com seu URL base e chave. Defina o array de mensagens com os papéis de usuário e assistente. Chame chat.completions.create com o modelo uncensored. A resposta fornece o texto gerado na primeira opção. Use esse padrão para chamadas síncronas e assíncronas em suas aplicações Node.

Copyimport OpenAI from "openai";

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

Habilite o streaming definindo stream como true. A API envia chunks de dados conforme são gerados. Cada chunk contém texto delta que você pode anexar a um buffer. Essa abordagem reduz a latência percebida para saídas longas. Monitore o uso de tokens no último chunk para rastrear o faturamento com precisã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)

Limites & Janela de Contexto

Sua conta suporta uma janela de contexto de 100.000 tokens. A saída máxima é de 16.000 tokens por requisição. Você pode enviar 300 requisições por minuto. Apenas 8 requisições são executadas simultaneamente. Requisições com corpo superior a 8 MB falharão. Use esses limites para projetar sua lógica de retry. Erros como 429 indicam que o limite de taxa foi atingido. Recusas não consomem créditos.