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.
- Conta Muffins AI: Inscreva-se ou faça login em Muffins AI Platform.
- Chave de API: Obtenha sua chave de API diretamente no painel da plataforma.
- Ferramentas Necessárias: Editor de código (como VS Code) e um gerenciador de pacotes como npm ou yarn.
Instalação da Biblioteca
Instale a biblioteca oficial Muffins AI com o seguinte comando:
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.
