Guia de Desenvolvimento

Integre diretamente a Muffins AI em seu projeto com exemplos práticos e recursos detalhados.

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

• Documentação Oficial: Encontre detalhes adicionais na Documentação Muffins AI.
• Chave de API: Gerencie suas chaves de API na Plataforma Muffins AI.
• Testes Interativos: Explore a API no Chatbot Muffins AI.
• Repositórios GitHub: Acesse exemplos de código e contribua para o desenvolvimento em nosso GitHub Oficial.

---

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.