Guia de Integração da API Mistral

Por que Trocar da API Mistral Padrão?

Desenvolvedores frequentemente encontram filtros de conteúdo que interrompem seus fluxos de trabalho. APIs padrão recusam tópicos específicos. Nosso modelo sem censura responde diretamente. Você mantém controle total sobre sua saída.

A API padrão do Mistral é confiável. Ela oferece modelos populares. No entanto, aplica suas próprias camadas de moderação. Você pode ver recusas para escrita criativa ou temas adultos. Nossa API remove essas barreiras. Ela executa um modelo de peso aberto ajustado para menos restrições. Você obtém o mesmo endpoint compatível com OpenAI.

O custo é outro fator. Planos padrão frequentemente o vinculam a assinaturas. Usamos um sistema de créditos pré-pagos. Você paga apenas pelo que usa. Erros não custam tokens. Essa transparência ajuda você a orçar com precisão.

A migração é trivial. Seu código existente funciona. Você só altera a URL base. Não são necessárias reescritas complexas. Essa flexibilidade é adequada para desenvolvedores que desejam geração sem censura sem gerenciar modelos locais.

Passo 1: Obtenha sua Chave de API

Comece criando uma conta em nossa plataforma. Você pode fazer login com o Google ou usar um e-mail e senha. Nenhum número de telefone é necessário. Isso mantém sua identidade privada.

Depois de fazer login, navegue até o painel. Gere sua chave de API imediatamente. A chave é exibida apenas uma vez. Copie-a e armazene-a de forma segura. Você precisará dela para cada solicitação.

Você recebe crédito de teste automaticamente. Contas novas recebem $0.50 válidos por 7 dias. Isso permite que você teste a integração antes de comprometer fundos.

Sua chave possui limites específicos. Você pode fazer 300 solicitações por minuto. Apenas oito solicitações são executadas simultaneamente. Cada chave é exclusiva para sua conta. Se você gerar uma nova chave, a antiga deixará de funcionar. Isso garante acesso seguro aos seus créditos.

Passo 2: Configure sua URL Base

A URL base é a alteração mais importante. Aponte seu SDK para nosso endpoint. Use o formato padrão OpenAI. Isso garante compatibilidade com suas bibliotecas existentes.

Defina seu URL base para HTTPS://api.mistralbaseurl.com/v1. Este caminho espelha a estrutura dos principais provedores. Seu código reconhecerá os endpoints corretamente. Você não precisa de novos drivers ou clientes.

Atualize a variável da sua chave de API no seu código. Substitua a chave do provedor antigo pela nova. Certifique-se de que a string da chave esteja correta. Erros de digitação causam erros de autenticação imediatos.

Teste a conexão com um ping simples. Solicite a lista de modelos disponíveis. Você deve ver nosso modelo sem censura listado. Isso confirma que sua configuração está correta. Você está pronto para enviar prompts.

Passo 3: Implemente conclusões de chat

Envie uma solicitação POST para o endpoint de conclusões de chat. Use o ID do modelo "uncensored". Isso aciona nosso modelo de linguagem grande específico. Ele processa sua entrada e gera texto.

Estruture suas mensagens como um array. Inclua os papéis system, user e assistant. O modelo segue essas instruções de perto. Você pode definir parâmetros como temperature e top_p. Eles controlam a criatividade da saída.

A janela de contexto é de 100.000 tokens. Isso permite o processamento de documentos longos. Você pode enviar um contexto extenso em uma única solicitação. O modelo mantém a coerência ao longo de sequências longas. Isso é útil para análise de código ou resumo de textos.

A saída máxima é de 16.000 tokens. Se você não definir max_tokens, o limite é de 2.048. Ajuste este parâmetro com base em suas necessidades. Respostas mais longas requerem mais créditos. Planeje seu orçamento de tokens de acordo.

Lidando com Streaming e Tokens

O streaming melhora a experiência do usuário. Ele envia tokens à medida que são gerados. Isso reduz a latência percebida. Habilite o streaming nas configurações do seu SDK.

Usamos Server-Sent Events (SSE). O stream fornece chunks de texto. Cada chunk contém uma parte da resposta. Você pode exibir tokens em tempo real.

O uso de tokens é relatado no chunk final. Isso garante uma faturação precisa. Você vê exatamente o que foi consumido. Erros não cobram de você. Recusas são gratuitas. Isso protege seu orçamento contra solicitações desperdiçadas.

Monitore o saldo do seu crédito regularmente. Você pode recarregar via cripto a qualquer momento. Os créditos nunca expiram. Isso permite que você pause o uso sem penalidades. Você mantém seu saldo indefinidamente.

Chamada de Função e Modo JSON

Nossa API suporta saídas estruturadas. Você pode forçar o modo JSON. Defina response_format para json_object. O modelo retorna apenas JSON válido. Isso é crítico para integrações.

A chamada de função funciona perfeitamente. Defina suas ferramentas na solicitação. O modelo identifica qual ferramenta usar. Ele passa os argumentos corretamente. Você pode analisar o resultado no seu código.

Defina tool_choice como auto ou específico. Isso dá a você controle sobre o comportamento. O modelo prioriza o uso de ferramentas quando necessário. Isso aumenta a confiabilidade em fluxos de trabalho complexos.

Use esses recursos para extração de dados. Automatize formulários ou chamadas de API. O modelo uncensored lida bem com casos extremos. Ele não recusa consultas complexas. Isso o torna adequado para tarefas de produção.

Erros Comuns: Explicação de 404 e 422

Erros geralmente indicam problemas de configuração. Um erro 404 Not Found é comum. Isso significa que o endpoint está errado. Verifique sua URL base cuidadosamente. Certifique-se de incluir /v1 no caminho.

Ocorreu um erro 422 Unprocessable Entity. Isso geralmente acontece com JSON inválido. Verifique a estrutura do corpo da solicitação. Certifique-se de que todos os campos obrigatórios estejam presentes. Verifique se o ID do modelo está correto.

Os limites de taxa retornam erros 429. Você excedeu 300 solicitações por minuto. Aguarde brevemente antes de tentar novamente. Implemente backoff exponencial no seu código. Isso evita sobrecarregar a API.

Verifique a validade da sua chave de API. Certifique-se de que não está expirada. As chaves são substituídas automaticamente se forem regeneradas. Use a chave correta para cada solicitação. Isso minimiza o tempo de inatividade.

Comparação de Custos: Mistral vs. Nossa API Uncensored

Nossos preços são simples. Você paga $0,15 por milhão de tokens de entrada. Tokens de saída custam $0,50 por milhão. Isso é transparente e previsível.

APIs padrão frequentemente cobram mais. Elas incluem taxas de plataforma. Nosso modelo é executado em nossos servidores. Você paga pelo compute diretamente. Isso reduz o custo base.

Erros são gratuitos. Você não paga por solicitações falhas. Isso economiza dinheiro na depuração. Você paga apenas por saídas válidas.

Recargas começam em $20. Você paga com cripto. Créditos bônus estão disponíveis. Adicione $50 para 5% extras. Adicione $100 para 10% extras. Adicione $200 para 15% extras. Isso recompensa o uso maior.

Checklist Final para uma Migração Suave

Verifique se sua URL base está correta. Atualize sua chave de API no ambiente. Teste com um prompt simples. Certifique-se de que o streaming funcione, se necessário.

Verifique o tratamento do seu limite de taxa. Implemente retentativas para erros 429. Monitore o uso de tokens. Ajuste max_tokens conforme necessário.

Habilite o modo JSON para dados estruturados. Teste o function calling com suas ferramentas. Certifique-se de que o modelo responda corretamente. Verifique se o formato de saída corresponde às suas expectativas.

Ajuste seus parâmetros. Defina a temperatura para criatividade. Use top_p para diversidade. Essas configurações afetam a qualidade da saída. Experimente para encontrar o melhor equilíbrio. Seu código deve permanecer inalterado, exceto pela URL e chave.