API Mistral AI: Guia de Início Rápido

URL Base e Autenticação

O primeiro passo é configurar seu cliente para apontar para nossa infraestrutura. Substitua a URL base padrão da OpenAI por HTTPS://api.apimistralai.com/v1 e insira sua chave de API única no cabeçalho de autorização. Essa simples troca redireciona todas as solicitações para nosso modelo sem censura, mantendo sua lógica de integração existente intacta.

• URL Base: HTTPS://api.apimistralai.com/v1
• Autenticação: Token Bearer via o Authorization cabeçalho

Certifique-se de que sua chave esteja ativa no painel da sua conta antes de testar as conexões.

Primeira solicitação

Envie uma solicitação padrão de conclusão de chat para verificar a conectividade e a resposta do modelo. O seguinte curl o comando direciona o uncensored modelo com um prompt básico.

Isso confirma que o endpoint está acessível e retorna texto sem os filtros de conteúdo padrão.

Copycurl https://api.apimistralai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix syntax error in python list comprehension"}]
  }'

Se a resposta contiver texto, sua integração está sendo roteada com sucesso através da nossa camada de inferência sem censura.

Integração do SDK Python

Use a biblioteca oficial da OpenAI para Python para interagir com nossa API sem modificar a estrutura principal da requisição. Inicialize o cliente com a nova URL base e sua chave da API, depois chame chat.completions.create.

Essa abordagem permite que você mantenha toda a lógica Python existente enquanto ganha acesso às capacidades do modelo sem censura.

Copyfrom openai import OpenAI

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

O objeto de resposta comporta-se de forma idêntica às respostas padrão da OpenAI, tornando a migração perfeita para desenvolvedores Python.

Integração do SDK Node

Para ambientes JavaScript ou TypeScript, inicialize o pacote OpenAI com a URL base personalizada. Defina o apiKey e baseURL propriedades antes de chamar chat.completions.create.

Isso garante que suas aplicações Node.js direcionem solicitações para nosso endpoint uncensored, mantendo a compatibilidade com os padrões padrão de SDKs.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apimistralai.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 estrutura da resposta permanece consistente com os padrões da OpenAI, permitindo integração fácil em fluxos de trabalho Node.js existentes.

Respostas em Streaming via SSE

Ative a geração de tokens em tempo real definindo stream: true na sua solicitação. A API retorna um fluxo de Server-Sent Events (SSE), permitindo que você processe os tokens conforme são gerados.

Isso reduz a latência percebida para os usuários e fornece feedback imediato durante conclusões longas.

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)

Analise o fluxo de dados SSE para exibir tokens incrementalmente. O último chunk contém o uso total de tokens para a solicitação.

Limites, Erros e Contexto

Monitore seu uso contra limites rigorosos de taxa e lidere com erros HTTP comuns de forma graciosa. Você tem direito a 300 solicitações por minuto e 8 solicitações simultâneas por chave.

Um erro 401 indica uma chave de API inválida ou ausente, enquanto um erro 402 significa que seu crédito pré-pago está esgotado. Um status 429 sinaliza que você excedeu o limite de 300 solicitações por minuto.

Sua janela de contexto suporta 100.000 tokens no total, com uma saída máxima de 16.000 tokens por solicitação. Erros e recusas não consomem crédito, garantindo que você pague apenas pelo conteúdo real gerado.