Update image URL and translate README

Author: lucianotonet

README.md

@@ -1,69 +1,69 @@
 # Groq Laravel
 
-![Groq Laravel](./docs/art.png)
+![Groq Laravel](https://raw.githubusercontent.com/lucianotonet/groq-laravel/v0.0.9/docs/art.png)
 
 [![Latest Stable Version](https://poser.pugx.org/lucianotonet/groq-laravel/v)](https://packagist.org/packages/lucianotonet/groq-laravel) [![Total Downloads](https://poser.pugx.org/lucianotonet/groq-laravel/downloads)](https://packagist.org/packages/lucianotonet/groq-laravel) [![Latest Unstable Version](https://poser.pugx.org/lucianotonet/groq-laravel/v/unstable)](https://packagist.org/packages/lucianotonet/groq-laravel) [![License](https://poser.pugx.org/lucianotonet/groq-laravel/license)](https://packagist.org/packages/lucianotonet/groq-laravel) [![PHP Version Require](https://poser.pugx.org/lucianotonet/groq-laravel/require/php)](https://packagist.org/packages/lucianotonet/groq-laravel)
 
-Groq Laravel é um pacote poderoso para integração entre suas aplicações Laravel a API da [Groq](https://groq.com/), permitindo que você aproveite velocidades ultra-rápidas de inferência de IA com alguns dos LLMs mais populares, como o Llama3.1 ou Mixtral.
+Groq Laravel is a powerful package for integrating your Laravel applications with the [Groq](https://groq.com/) API, allowing you to leverage ultra-fast AI inference speeds with some of the most popular LLMs, such as Llama3.1 or Mixtral.
 
 ## Features
 
-- **Interface Simples e Intuitiva:** Interaja com a API Groq usando a facade `Groq`, simplificando o acesso às funcionalidades de chat, tradução e transcrição de áudio e chamadas à funções.
-- **Tratamento Robusto de Erros:** Gerencie eficientemente erros de comunicação e respostas da API Groq, capturando exceções específicas e fornecendo mensagens informativas.
-- **Configuração Flexível:** Defina várias instâncias da API Groq, personalize timeouts de requisição, configure opções de cache e ajuste o comportamento do pacote conforme suas necessidades.
-- **Exemplos Práticos Detalhados:** Explore exemplos de código que demonstram como usar o pacote Groq Laravel em cenários reais, incluindo chatbots, transcrição de áudio e muito mais.
-- **Testes Abrangentes:** Garanta a qualidade e confiabilidade do pacote com um conjunto de testes que cobrem aspectos de integração, testes unitários e configuração.
+- **Simple and Intuitive Interface:** Interact with the Groq API using the `Groq` facade, simplifying access to chat, translation, audio transcription, function call, and image analysis functionalities.
+- **Robust Error Handling:** Efficiently manage communication errors and responses from the Groq API, capturing specific exceptions and providing informative messages.
+- **Flexible Configuration:** Define multiple Groq API instances, customize request timeouts, configure caching options, and adjust the package's behavior to suit your needs.
+- **Detailed Practical Examples:** Explore code examples that demonstrate how to use the Groq Laravel package in real-world scenarios, including chatbots, audio transcription, and more.
+- **Comprehensive Testing:** Ensure the quality and reliability of the package with a suite of tests covering integration, unit testing, and configuration.
 
-## Instalação
+## Installation
 
-1. Instale o pacote via Composer:
+1. Install the package via Composer:
 
    ```bash
    composer require lucianotonet/groq-laravel
    ```
 
-2. Publique o arquivo de configuração:
+2. Publish the configuration file:
 
    ```bash
    php artisan vendor:publish --provider="LucianoTonet\GroqLaravel\GroqServiceProvider"
    ```
 
-3. Configure suas credenciais da API Groq no arquivo `.env`:
+3. Configure your Groq API credentials in the `.env` file:
 
    ```
    GROQ_API_KEY=your_api_key_here
    GROQ_API_BASE=https://api.groq.com/openai/v1
    ```
 
-4. (Opcional) Configure o cache definindo as seguintes variáveis de ambiente no arquivo `.env`:
+4. (Optional) Configure caching by setting the following environment variables in the `.env` file:
 
    ```
    GROQ_CACHE_DRIVER=file
    GROQ_CACHE_TTL=3600
    ```
 
-5. Importe a facade `Groq` em suas classes:
+5. Import the `Groq` facade into your classes:
 
    ```php
    use LucianoTonet\GroqLaravel\Facades\Groq;
    ```
 
-## Uso
+## Usage
 
-Aqui está um exemplo simples de como criar uma conclusão de chat:
+Here is a simple example of how to create a chat completion:
 
 ```php
 $response = Groq::chat()->completions()->create([
     'model' => 'llama-3.1-8b-instant',
     'messages' => [
-        ['role' => 'user', 'content' => 'Olá, como você está?'],
+        ['role' => 'user', 'content' => 'Hello, how are you?'],
     ],
 ]);
 ```
 
-## Tratamento de Erros
+## Error Handling
 
-O pacote Groq Laravel facilita o tratamento de erros que podem ocorrer ao interagir com a API Groq. Use um bloco `try-catch` para capturar e gerenciar exceções:
+The Groq Laravel package makes it easy to handle errors that may occur when interacting with the Groq API. Use a `try-catch` block to capture and manage exceptions:
 
 ```php
 try {
@@ -72,37 +72,79 @@ try {
         // ...
     ]);
 } catch (GroqException $e) {
-    Log::error('Erro na API Groq: ' . $e->getMessage());
-    abort(500, 'Erro ao processar sua solicitação.');
+    Log::error('Error in Groq API: ' . $e->getMessage());
+    abort(500, 'Error processing your request.');
 }
 ```
 
-## Testes
+## Vision API
 
-Os testes são uma parte essencial do desenvolvimento de software de qualidade. O pacote Groq Laravel inclui uma suíte de testes que cobre integração, unidade e configuração. Para executar os testes, siga os passos abaixo:
+The Groq Laravel package also provides access to the Groq Vision API, allowing you to analyze images and extract information from them.
 
-1. **Instale as dependências do projeto:**
+**Example of use with image URL:**
+
+```php
+use LucianoTonet\GroqLaravel\Facades\Groq;
+
+// ...
+
+$imageUrl = 'https://example.com/image.jpg'; // Replace with your image URL
+$prompt = 'Describe the image';
+
+$response = Groq::vision()->analyze($imageUrl, $prompt);
+
+$imageDescription = $response['choices'][0]['message']['content'];
+
+// ... do something with the image description
+```
+
+**Example of use with local image file:**
+
+```php
+use LucianoTonet\GroqLaravel\Facades\Groq;
+
+// ...
+
+$imagePath = '/path/to/your/image.jpg'; // Replace with the actual path
+$prompt = 'What do you see in this image?';
+
+$response = Groq::vision()->analyze($imagePath, $prompt);
+
+$imageAnalysis = $response['choices'][0]['message']['content'];
+
+// ... do something with the image analysis
+```
+
+**Remember:**
+- The Vision API requires a model compatible with image analysis, such as `llava-v1.5-7b-4096-preview`. You can configure the default model for Vision in the `config/groq.php` configuration file.
+- The Vision API is an experimental feature and may not meet expectations, as well as not having long-term support.
+
+## Testing
+
+Testing is an essential part of quality software development. The Groq Laravel package includes a test suite that covers integration, unit, and configuration. To run the tests, follow the steps below:
+
+1. **Install the project dependencies:**
 
    ```bash
    composer install
    ```
 
-2. **Execute os testes:**
+2. **Run the tests:**
 
    ```bash
    vendor/bin/phpunit ./tests/Feature
    ```
 
-   ou individualmente:
+   or individually:
 
    ```bash
    vendor/bin/phpunit ./tests/Feature/FacadeTest.php
    ```
 
-## Contribuindo
+## Contributing
 
-Contribuições são bem-vindas! Siga as diretrizes descritas no arquivo [CONTRIBUTING.md](CONTRIBUTING.md).
+Contributions are welcome! Follow the guidelines described in the [CONTRIBUTING.md](CONTRIBUTING.md) file.
 
-## Licença
+## License
 
-Este pacote é um software de código aberto licenciado sob a [licença MIT](LICENSE).
+This package is open-source software licensed under the [MIT license](LICENSE).