bugadoz/woolball-library

Uma biblioteca poderosa para integração de AI, incluindo funções de texto, imagem e áudio.

Maintainers

Details

github.com/bugadoz/WoolballLibrary

Source

Issues

Installs: 15

Dependents: 0

Suggesters: 0

Security: 0

Stars: 9

Watchers: 2

Forks: 3

v3.2.5 2025-01-17 16:12 UTC

Requires

Requires (Dev)

MIT 3388e08eb4badf2ec573d55553a74c103ae93e20

  • Bugadoz.dev <none.woop@none.com>

This package is not auto-updated.

Last update: 2025-06-21 02:00:04 UTC

README

A biblioteca WoolballAPI permite a integração com a API Woolball para realizar diversas tarefas, como conversão de texto em fala, transcrição de áudio, classificação de texto, tradução, detecção de emoções em imagens, análise de visão computacional, e muito mais. Este README explica como instalar, configurar e usar cada método disponível na biblioteca.

Instalação

Via Composer

Execute o seguinte comando no terminal para instalar a biblioteca usando o Composer:

composer require bugadoz/woolball-library

Depois de instalar, inclua o autoloader no seu projeto:

require_once 'vendor/autoload.php';

Manualmente

  1. Baixe o arquivo PHP contendo a classe WoolballAPI.
  2. Inclua a classe no seu projeto:
require_once 'WoolballAPI.php';

Configuração

Antes de usar a biblioteca, você precisa configurar a chave de API: https://woolball.xyz/

$apiKey = 'SUA_API_KEY';
$woolball = new WoolballLibrary\WoolballAPI($apiKey);

Funções Disponíveis

A biblioteca fornece as seguintes funções:

1. Conversão de Texto para Fala

Converte um texto em áudio no idioma desejado.

$audioData = $woolball->textToSpeech('Olá mundo', 'pt');
file_put_contents('output.mp3', $audioData);

Parâmetros:

  • text (string): O texto que deseja converter.
  • language (string): O código do idioma (ex: en, pt, es).

Retorno:

  • String em formato de dados de áudio (MP3).

2. Transcrição de Áudio

Transcreve o conteúdo de um arquivo de áudio para texto.

$transcription = $woolball->speechToText('audio.wav');
echo $transcription;

Parâmetros:

  • filePath (string): Caminho para o arquivo de áudio.

Retorno:

  • Texto transcrito.

3. Geração de Texto

Gera um texto baseado em um prompt fornecido.

$generatedText = $woolball->generateText('Qual é a capital da França?','HuggingFaceTB/SmolLM2-360M-Instruct');
echo $generatedText;

Parâmetros:

Retorno:

  • Texto gerado.

4. Tradução de Texto

Traduz um texto entre dois idiomas especificados.

Idiomas: languages-in-flores-200

$translatedText = $woolball->translateText('Olá, mundo!', 'por_Latn', 'eng_Latn');
echo $translatedText;

Parâmetros:

  • text (string): Texto a ser traduzido.
  • sourceLanguage (string): Idioma de origem.
  • targetLanguage (string): Idioma de destino.

Retorno:

  • Texto traduzido.

5. Classificação de Texto

Realiza classificação de texto baseada em rótulos fornecidos.

$classification = $woolball->classifyText('Qual cidade não está na América do Sul?', ['geografia', 'viagem', 'história']);
echo $classification;

Parâmetros:

  • text (string): Texto para classificar.
  • labels (array): Lista de rótulos candidatos.

Retorno:

  • Melhor rótulo identificado.

6. Detecção de Emoções em Imagens

Detecta emoções em imagens de rostos humanos.

$emotions = $woolball->detectFacialEmotions('img.png');
echo $emotions;

Parâmetros:

  • filePath (string): Caminho para a imagem.

Retorno:

  • Emoções detectadas.

7. Visão Computacional

Analisa o conteúdo de uma imagem e fornece descrições.

$description = $woolball->analyzeImage('img.png', 'Descreva o conteúdo da imagem');
echo $description;

Parâmetros:

  • filePath (string): Caminho para a imagem.
  • prompt (string): Instrução de descrição.

Retorno:

  • Descrição da imagem.

8. Classificação de Imagens

Classifica imagens com base em rótulos fornecidos.

$labels = $woolball->classifyImages(['img1.png', 'img2.png']);
print_r($labels);

Parâmetros:

  • filePaths (array): Lista de caminhos para imagens.

Retorno:

  • Rótulos e pontuações para cada imagem.

9. Resumo de Texto

Fornece um resumo para um texto longo.

$summary = $woolball->summarizeText('Texto longo aqui...');
echo $summary;

Parâmetros:

  • text (string): Texto a ser resumido.

Retorno:

  • Resumo do texto.

10. Criação de Imagens a Partir de Caracteres

Gera uma representação visual de um caractere fornecido.

$imageBase64 = $woolball->charToImage('A');
file_put_contents('character.png', base64_decode($imageBase64));

Parâmetros:

  • character (string): Caractere a ser representado.

Retorno:

  • String Base64 da imagem.

11. Avaliação de Sentimento

Analisa o sentimento de um texto (positivo, negativo ou neutro).

$sentiment = $woolball->analyzeSentiment('Estou muito feliz hoje!');
echo $sentiment;

Parâmetros:

  • text (string): Texto a ser analisado.

Retorno:

  • Sentimento identificado (positivo, negativo ou neutro).

Erros e Depuração

Caso ocorram erros, a biblioteca lançará exceções. Certifique-se de usar blocos try-catch para capturá-los:

try {
    $result = $woolball->textToSpeech('Olá mundo', 'pt');
} catch (Exception $e) {
    echo 'Erro: ' . $e->getMessage();
}

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou enviar pull requests.

Licença

Esta biblioteca é fornecida sob a licença MIT. Consulte o arquivo LICENSE para mais detalhes.

Créditos

Desenvolvido com ❤️ por Bugadoz.dev.