Início rápido para usuários do Mistral

URL Base e Autenticação

Nossa API é totalmente compatível com os SDKs da OpenAI. Você só precisa atualizar a URL base e fornecer sua chave de API. A URL base para este serviço é https://api.mistralapi.com/v1. A autenticação é feita via cabeçalho Authorization usando um token Bearer. Ao contrário de alguns provedores, não exigimos roteamento complexo ou cabeçalhos específicos do fornecedor; basta passar sua chave como de costume.

• URL Base: https://api.mistralapi.com/v1
• Cabeçalho: Authorization: Bearer YOUR_API_KEY

Sua chave de API é gerada imediatamente após o cadastro. Mantenha-a segura, pois ela concede acesso ao seu crédito pré-pago. Não há taxas de assinatura mensal, apenas preços pagamento por uso baseados no uso de tokens.

Endpoint de Completions de Chat

O núcleo da nossa API é o endpoint POST /v1/chat/completions. Ele aceita uma lista de mensagens e retorna uma resposta gerada. Este endpoint suporta o formato de mensagem padrão usado pela maioria dos clientes LLM. Você deve especificar o ID do modelo como "uncensored". Este modelo é um modelo de linguagem grande de pesos abertos hospedado em nossos servidores, ajustado para responder sem recusas de conteúdo para uso adulto lícito.

• Endpoint: POST /v1/chat/completions
• ID do Modelo: uncensored

A API retorna apenas respostas de texto. Não suporta imagens, áudio, vídeo ou embeddings. Para a maioria dos desenvolvedores, este endpoint substitui o endpoint de chat padrão da OpenAI com zero alterações de código além da URL base e do ID do modelo.

Integração com SDK Python

Usar a biblioteca oficial Python da OpenAI é a maneira mais rápida de integrar. Defina a URL base para nosso endpoint e forneça sua chave de API. O código abaixo demonstra uma solicitação simples de conclusão de texto.

• Instale a biblioteca: pip install openai
• Defina base_url para https://api.mistralapi.com/v1
• Use model="uncensored"

Esta abordagem funciona porque nossa API espelha a estrutura de resposta da OpenAI. Você pode usar bibliotecas existentes para streaming, chamada de funções e modo JSON sem modificações.

Integração com SDK Node.js

Para desenvolvedores JavaScript/TypeScript, o pacote npm openai funciona perfeitamente. Configure o cliente com nossa URL base e sua chave de API. Isso permite que você use a mesma base de código tanto para a OpenAI quanto para nosso modelo sem censura.

• Instale a biblioteca: npm install openai
• Configure baseUrl para https://api.mistralapi.com/v1
• Especifique model: "uncensored"

Esta compatibilidade se estende a todos os parâmetros padrão como temperature, top_p e sequências stop. Você pode alternar entre provedores facilmente alterando a configuração do cliente.

Respostas em Streaming

Nós suportamos respostas em streaming via Server-Sent Events (SSE). Isso permite que você receba tokens conforme são gerados, reduzindo a latência percebida para os usuários. O último lote do streaming inclui as estatísticas de uso de tokens para faturamento.

• Defina stream: true em sua requisição
• Leia os lotes da resposta
• Analise o último lote para dados de uso

O streaming é ideal para interfaces de chat e aplicativos em tempo real. O formato da resposta corresponde ao padrão de streaming da OpenAI, então sua lógica de streaming existente funcionará sem alterações.

Limites, Erros e Janela de Contexto

Nossa API tem limites específicos para garantir estabilidade. Cada chave de API suporta 300 requisições por minuto e 8 requisições simultâneas. O tamanho máximo do corpo da requisição é 8 MB. A janela de contexto é de 100.000 tokens no total (prompt + conclusão). Se você não definir max_tokens, a saída padrão é de 2.048 tokens; caso contrário, a saída máxima é de 32.000 tokens.

• 401: Chave de API inválida
• 402: Crédito insuficiente
• 429: Limite de requisições excedido

Crédito premium nunca expira. Erros e recusas são gratuitos. Se você encontrar problemas, use a página de Suporte para reembolsos ou ajuda com a conta.

cURL

Copiarcurl https://api.mistralapi.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."}]
  }'

Python

Copiarfrom openai import OpenAI

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

Node.js

Copiarimport OpenAI from "openai";

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

Streaming

Copiarstream = 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)