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

# Quickstart Acheteur

> Créez votre compte, rechargez des crédits et soumettez vos premières tâches en moins d'une heure.

## 1. Créer votre compte

Rendez-vous sur [dloopiq-dashboard.vercel.app/register](https://dloopiq-dashboard.vercel.app/register) et créez votre compte acheteur.

Après inscription, vous recevrez un email de bienvenue et serez redirigé vers votre tableau de bord.

***

## 2. Recharger des crédits

Depuis le tableau de bord, allez dans **Facturation → Recharger** et déposez des crédits via Flutterwave (cartes, mobile money).

<Tip>
  Déposez ≥ $500 pour recevoir **+5 % de bonus crédit** automatiquement.
      Déposez ≥ $2 000 pour **+10 % de bonus**.
</Tip>

***

## 3. Créer votre première tâche

### Via l'API

Récupérez votre clé API dans **Paramètres → Clé API**, puis :

```bash theme={null}
curl -X POST https://dloopiq.onrender.com/api/v1/tasks \
  -H "Authorization: Bearer <votre_jwt>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "SENTIMENT_ANALYSIS",
    "content": "Ce produit est absolument fantastique !",
    "options": ["Positif", "Négatif", "Neutre"],
    "locale": "fr",
    "maxCents": 25
  }'
```

Réponse :

```json theme={null}
{
  "taskId": "cmpkb4ghw00016qduu44p7n2q",
  "status": "PENDING",
  "costCents": 20,
  "estimatedCompletionMs": 3600000
}
```

### Via import CSV

Pour soumettre plusieurs tâches d'un coup :

```csv theme={null}
type,content,options,locale,maxCents
SENTIMENT_ANALYSIS,"Ce produit est fantastique !","Positif|Négatif|Neutre",fr,25
BINARY_CHOICE,"Cette image contient-elle de la violence ?","Oui|Non",fr,20
IMAGE_CLASSIFICATION,"https://example.com/img.jpg","Chat|Chien|Autre",en,20
```

```bash theme={null}
curl -X POST https://dloopiq.onrender.com/api/v1/tasks/batch/csv \
  -H "Authorization: Bearer <votre_jwt>" \
  -F "file=@taches.csv"
```

***

## 4. Suivre les résultats

### Via le dashboard

L'onglet **Tâches** montre l'état en temps réel : `PENDING` → `VALIDATING` → `COMPLETED` ou `FAILED`.

### Via webhook

Configurez un webhook dans **Paramètres → Webhooks** pour recevoir les résultats dès validation :

```json theme={null}
POST https://votre-serveur.com/webhook
{
  "event": "task.completed",
  "taskId": "cmpkb4ghw00016qduu44p7n2q",
  "result": "Positif",
  "confidence": 0.87,
  "totalResponses": 3,
  "validatedAt": "2026-05-25T14:32:00Z"
}
```

### Via export

```bash theme={null}
# Télécharger toutes les tâches complétées en JSON
curl "https://dloopiq.onrender.com/api/v1/exports?format=json&status=COMPLETED" \
  -H "Authorization: Bearer <votre_jwt>"
```

***

## 5. Exporter pour l'entraînement

6 formats disponibles :

| Format        | Usage                            |
| ------------- | -------------------------------- |
| `json`        | Usage général                    |
| `jsonl`       | Fine-tuning GPT-style            |
| `csv`         | Excel / pandas                   |
| `openai`      | Fine-tuning OpenAI Chat          |
| `huggingface` | HuggingFace Datasets             |
| `alpaca`      | Format Alpaca instruction-tuning |

```bash theme={null}
curl "https://dloopiq.onrender.com/api/v1/exports?format=huggingface&trainRatio=0.8&valRatio=0.1&testRatio=0.1" \
  -H "Authorization: Bearer <votre_jwt>"
```

***

## Récapitulatif des coûts

| Volume      | Prix / tâche | Bonus         |
| ----------- | ------------ | ------------- |
| \< \$500    | \$0.20       | —             |
| $500–$1 999 | \$0.20       | +5 % crédits  |
| ≥ \$2 000   | \$0.20       | +10 % crédits |

<Note>
  Seules les tâches avec statut `COMPLETED` sont facturées. Les tâches `FAILED` (pas assez de réponses concordantes) ne coûtent rien.
</Note>