> ## Documentation Index
> Fetch the complete documentation index at: https://docs.muffinscorp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

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

1. **Conta Muffins AI**: Inscreva-se ou faça login em [Muffins AI Platform](https://platform.muffinscorp.com).
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:

```bash theme={null}
npm install muffinscorp
```

### Configuração Básica

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

```plaintext theme={null}
MUFFINS_API_KEY=sua_chave_api_aqui
```

### Exemplo Básico de Uso

#### Criar uma Resposta de Chat

```javascript theme={null}
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

```javascript theme={null}
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](https://docs.muffinscorp.com).
* **Chave de API**: Gerencie suas chaves de API na [Plataforma Muffins AI](https://platform.muffinscorp.com).
* **Testes Interativos**: Explore a API no [Chatbot Muffins AI](https://chat.muffinscorp.com).
* **Repositórios GitHub**: Acesse exemplos de código e contribua para o desenvolvimento em nosso [GitHub Oficial](https://github.com/muffins-corp).

***

## Exemplos Avançados

### Criação de Respostas com Streaming

```javascript theme={null}
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

```javascript theme={null}
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](./models/overview).

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

Utilize o [Chatbot Muffins AI](https://chat.muffinscorp.com) para explorar as funcionalidades de maneira interativa.

***

> **Dica**: Para novidades, tutoriais e exemplos, visite o [Blog Muffins AI](https://ai.muffinscorp.com/blog).