Bem-vindo ao Guia de Desenvolvimento da Muffins AI. Este documento fornece instruções detalhadas sobre como integrar a biblioteca oficial da Muffins AI em seu projeto, juntamente com exemplos práticos de uso.

​
Pré-requisitos

Certifique-se de que você tem o Node.js (versão 19 ou superior) instalado.

  1. Conta Muffins AI: Inscreva-se ou faça login em Muffins AI Platform.
  2. Chave de API: Obtenha sua chave de API diretamente no painel da plataforma.
  3. Ferramentas Necessárias: Editor de código (como VS Code) e um gerenciador de pacotes como npm ou yarn.

​
Integração com Muffins AI: Biblioteca Oficial

​
Instalação da Biblioteca

Instale a biblioteca oficial Muffins AI com o seguinte comando:

npm install muffinscorp

​
Configuração Básica

Configure sua chave de API utilizando variáveis de ambiente para maior segurança:

MUFFINS_API_KEY=sua_chave_api_aqui

​
Exemplo Básico de Uso

​
Criar uma Resposta de Chat

const { MuffinsCorp } = require("muffinscorp");

// Inicialização com a chave de API
const muffinsai = new MuffinsCorp({
  apiKey: process.env.MUFFINS_API_KEY || "sua-chave-api",
});

async function criarRespostaChat() {
  try {
    const resposta = await muffinsai.chat.create({
      messages: [
        { role: "system", content: "Você é um assistente útil." },
        { role: "user", content: "Olá, mundo!" },
      ],
      model: "chat-model-small",
      stream: false,
    });

    console.log("Resposta do chat:", resposta);
  } catch (error) {
    console.error("Erro ao criar resposta de chat:", error.message);
  }
}

criarRespostaChat();

​
Listar Modelos Disponíveis

async function listarModelos() {
  try {
    const modelos = await muffinsai.models.list();
    console.log("Modelos disponíveis:", modelos);
  } catch (error) {
    console.error("Erro ao listar modelos:", error.message);
  }
}

listarModelos();

​
Recursos Adicionais

​
Exemplos Avançados

​
Criação de Respostas com Streaming

async function criarRespostaStreaming() {
  try {
    const stream = await muffinsai.chat.create({
      messages: [
        { role: "system", content: "Você é um assistente criativo." },
        { role: "user", content: "Escreva um poema sobre tecnologia." },
      ],
      model: "chat-model-small",
      stream: true,
    });

    console.log("Iniciando resposta em streaming:");

    stream.on("data", (chunk) => {
      process.stdout.write(chunk.toString());
    });

    stream.on("end", () => {
      console.log("\nStreaming concluído.");
    });

    stream.on("error", (error) => {
      console.error("Erro no streaming:", error);
    });
  } catch (error) {
    console.error("Erro ao criar resposta com streaming:", error.message);
  }
}

criarRespostaStreaming();

​
Consultar Saldo de Créditos

async function consultarSaldo() {
  try {
    const saldo = await muffinsai.credits.getBalance();
    console.log("Saldo de créditos atual:", saldo);
  } catch (error) {
    console.error("Erro ao consultar saldo de créditos:", error.message);
  }
}

consultarSaldo();

​
Perguntas Frequentes

​
1. Erro 401: Chave de API inválida.

Certifique-se de que:

  • A chave de API está configurada corretamente.
  • Não há espaços ou caracteres adicionais no arquivo .env.

​
2. Quais modelos estão disponíveis?

Confira a lista completa no Catálogo de Modelos.

​
3. Como testar a API sem escrever código?

Utilize o Chatbot Muffins AI para explorar as funcionalidades de maneira interativa.

Dica: Para novidades, tutoriais e exemplos, visite o Blog Muffins AI.