> For the complete documentation index, see [llms.txt](https://docs.mindee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mindee.com/v2/fr/integrations/client-libraries-sdk/configure-the-client.md).

# Configuration du client

## Avant de commencer

Vous devrez disposer de l’une des [bibliothèques clientes officielles Mindee](/v2/fr/integrations/client-libraries-sdk.md) installées.

Vous devrez également utiliser l’une de vos [Aperçu de l’intégration](/v2/fr/integrations/api-overview.md#api-keys) et avoir au moins un [Modèle](/v2/fr/models/models-overview.md) configuré.

Le client fonctionne pour tous les types de modèle.

## Initialiser le client Mindee

Avant d’envoyer des fichiers aux serveurs Mindee pour traitement, vous devrez initialiser votre client.

Cela devrait être la première étape de votre code. Cela déterminera quelle organisation est utilisée pour effectuer les appels.

Vous devriez réutiliser la même instance du client pour tous les appels de la même organisation.

L’instance du client est thread-safe dans les langages compatibles.

{% tabs %}
{% tab title="Python" %}
Importez d’abord les classes nécessaires :

```python
from mindee import (
    ClientV2,
    InferenceParameters,
    InferenceResponse,
    PathInput,  # pour charger des fichiers depuis le disque
)
```

Pour la clé API, vous pouvez la transmettre directement au client.\
Ceci est utile pour des tests rapides.

```python
api_key = "MY_API_KEY"

mindee_client = ClientV2(api_key)
```

Au lieu de transmettre la clé directement, vous pouvez également définir la variable d’environnement suivante :

`MINDEE_V2_API_KEY`

Ceci est recommandé pour une utilisation en production.\
Ainsi, il n’est pas nécessaire de transmettre la `api_key` lors de l’initialisation du client.

```python
mindee_client = ClientV2()
```

{% endtab %}

{% tab title="Node.js" %}
Importez d’abord les classes nécessaires. Nous recommandons d’utiliser les ES Modules.

```typescript
import * as mindee from "mindee";
// Si vous êtes en CommonJS :
// const mindee = require("mindee");
```

Pour la clé API, vous pouvez la transmettre directement au client.\
Ceci est utile pour des tests rapides.

```typescript
const apiKey = "MY_API_KEY";

const mindeeClient = new mindee.Client({ apiKey: apiKey });
```

Au lieu de transmettre la clé directement, vous pouvez également définir la variable d’environnement suivante :

`MINDEE_V2_API_KEY`

Ceci est recommandé pour une utilisation en production.\
Ainsi, il n’est pas nécessaire de transmettre la `apiKey` argument lors de l’initialisation du client.

```typescript
const mindeeClient = new mindee.Client();
```

**Utilisation avancée**

en interne, [undici](https://undici.nodejs.org/) est utilisé pour effectuer des appels HTTP, et lorsque le client est initialisé `getGlobalDispatcher` est appelé.

**Ceci convient parfaitement à la grande majorité des cas :**\
Si vous définissez un Agent personnalisé comme dispatcher global, Mindee l’utilisera.

Dans le cas rare où vous avez besoin d’un dispatcher spécifique pour Mindee, vous pouvez le définir comme suit :

```javascript
import { Agent, interceptors } from "undici";

// Initialisez le dispatcher personnalisé
// REMPLACEZ LA LIGNE CI-DESSOUS PAR VOTRE CODE - cet exemple ne fonctionnera PAS !
const myDispatcher = new Agent().compose( ... );

const mindeeClient = new mindee.Client({
  // Ne le définissez pas si vous utilisez une variable d’environnement
  apiKey: apiKey,

  // Active la journalisation verbeuse - à désactiver en production !
  debug: true,

  // Passez le dispatcher personnalisé au client Mindee
  dispatcher: myDispatcher,
});
```

{% endtab %}

{% tab title="PHP" %}
Importez d’abord les classes nécessaires :

```php
use Mindee\ClientV2;
use Mindee\Input\InferenceParameters;
use Mindee\Error\MindeeException;
```

Pour la clé API, vous pouvez la transmettre directement au client.\
Ceci est utile pour des tests rapides.

```php
$apiKey = "MY_API_KEY";

$mindeeClient = new ClientV2($apiKey);
```

Au lieu de transmettre la clé directement, vous pouvez également définir la variable d’environnement suivante :

`MINDEE_V2_API_KEY`

Ceci est recommandé pour une utilisation en production.\
Ainsi, il n’est pas nécessaire de transmettre la `$apiKey` lors de l’initialisation du client.

```php
$mindeeClient = new ClientV2($apiKey);
```

{% endtab %}

{% tab title="Ruby" %}
Importez d’abord le package Mindee :

```ruby
require 'mindee'
```

Pour la clé API, vous pouvez la transmettre directement au client.\
Ceci est utile pour des tests rapides.

```ruby
api_key = 'MY_API_KEY'
mindee_client = Mindee::ClientV2.new(api_key: api_key)
```

Au lieu de transmettre la clé directement, vous pouvez également définir la variable d’environnement suivante :

`MINDEE_V2_API_KEY`

Ceci est recommandé pour une utilisation en production.\
Ainsi, il n’est pas nécessaire de transmettre la `api_key` lors de l’initialisation du client.

```ruby
mindee_client = Mindee::ClientV2.new()
```

{% endtab %}

{% tab title="Java" %}
Importez d’abord les classes nécessaires :

```java
import com.mindee.MindeeClientV2;
import com.mindee.InferenceParameters;
```

Pour la clé API, vous pouvez la transmettre directement au client.\
Ceci est utile pour des tests rapides.

```java
String apiKey = "MY_API_KEY";

MindeeClientV2 mindeeClient = new MindeeClientV2(apiKey);
```

Au lieu de transmettre la clé directement, vous pouvez également définir la variable d’environnement suivante :

`MINDEE_V2_API_KEY`

Ceci est recommandé pour une utilisation en production.\
Ainsi, il n’est pas nécessaire de transmettre la `apiKey` argument lors de l’initialisation du client.

```java
MindeeClientV2 mindeeClient = new MindeeClientV2();
```

{% endtab %}

{% tab title=".NET" %}
Ajoutez d’abord les espaces de noms requis.

```csharp
using Mindee;
using Mindee.Input;
```

Pour la clé API, vous pouvez la transmettre directement au client.\
Ceci est utile pour des tests rapides.

```csharp
string apiKey = "MY_API_KEY";

MindeeClientV2 mindeeClient = new MindeeClientV2(apiKey);
```

Au lieu de transmettre la clé directement, vous pouvez également définir la variable d’environnement suivante :

`MindeeV2__ApiKey`

Ceci est recommandé pour une utilisation en production.\
Ainsi, il n’est pas nécessaire de transmettre la `apiKey` argument lors de l’initialisation du client.

```csharp
MindeeClientV2 mindeeClient = new MindeeClientV2();
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mindee.com/v2/fr/integrations/client-libraries-sdk/configure-the-client.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.