Documentation API

Envoie deux images (produit + photo du client) et retourne une URL de téléchargement de l'image générée. Consomme 1 crédit par appel.

Sources d'images — 3 modes (mixables)

Mode 1 — URL publique (JSON)

curl -X POST https://cabine.ai/api/v1/generate \
  -H "X-Api-Key: vf_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "product_image_url": "https://maboutique.com/img/robe.jpg",
    "user_photo_url":    "https://maboutique.com/uploads/client.jpg",
    "product_id":         42,
    "cart_id":            67890,
    "customer_id":        12345
  }'

Mode 2 — Base64 ✅ recommandé pour PrestaShop

curl -X POST https://cabine.ai/api/v1/generate \
  -H "X-Api-Key: vf_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "product_image_b64": "data:image/jpeg;base64,/9j/4AAQ...",
    "user_photo_b64":    "data:image/jpeg;base64,/9j/4AAQ...",
    "product_id":         42,
    "cart_id":            67890,
    "customer_id":        12345
  }'

Mode 3 — Multipart/form-data (upload direct)

curl -X POST https://cabine.ai/api/v1/generate \
  -H "X-Api-Key: vf_live_xxx" \
  -F "product_image=@/chemin/robe.jpg" \
  -F "user_photo=@/chemin/client.jpg" \
  -F "product_id=42" \
  -F "cart_id=67890" \
  -F "customer_id=12345"

Réponse succès (200)

{
  "success":             true,
  "result_url":          "https://cabine.ai/generation/a3f8...b2/download",
  "generation_id":       1042,
  "credits_used":        1,
  "credits_remaining":   163,
  "processing_time_ms":  8420
}

Champs de la réponse

Enregistre une conversion : une commande passée après qu'un client a effectué un essayage virtuel. L'API relie automatiquement la commande à la génération d'origine grâce au cart_id et au product_id envoyés lors de l'essayage.

Cet endpoint est idempotent : un second appel avec le même order_id retourne la conversion déjà enregistrée sans créer de doublon.

Paramètres

Exemple — appel depuis PrestaShop

curl -X POST https://cabine.ai/api/v1/conversion \
  -H "X-Api-Key: vf_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "order_id":    "PS-00012345",
    "product_id":  42,
    "cart_id":     67890,
    "customer_id": 12345,
    "metadata": {
      "amount":   89.90,
      "currency": "EUR",
      "sku":      "ROBE-BLEU-M"
    }
  }'

Réponse succès (201 Created)

{
  "success":               true,
  "conversion_id":         58,
  "linked_generation_id":  1042,
  "already_recorded":      false
}

Réponse — conversion déjà enregistrée (200, idempotent)

{
  "success":               true,
  "conversion_id":         58,
  "linked_generation_id":  1042,
  "already_recorded":      true
}

Champs de la réponse

Intégration PrestaShop — hook actionOrderStatusPostUpdate

// À appeler depuis le hook de confirmation de commande
public function hookActionOrderStatusPostUpdate($params)
{
    $order  = $params['order'];
    $status = $params['newOrderStatus'];

    // Ne déclencher que sur commandes validées/payées
    if (!in_array($status->id, [2, 12])) return;

    foreach ($order->getProducts() as $product) {
        $payload = json_encode([
            'order_id'    => (string) $order->reference,
            'product_id'  => (int) $product['product_id'],
            'cart_id'     => (int) $order->id_cart,
            'customer_id' => (int) $order->id_customer,
            'metadata'    => [
                'amount'   => (float) $order->total_paid,
                'currency' => Context::getContext()->currency->iso_code,
                'sku'      => $product['reference'],
            ],
        ]);

        file_get_contents('https://cabine.ai/api/v1/conversion', false,
            stream_context_create(['http' => [
                'method'  => 'POST',
                'header'  => "X-Api-Key: vf_live_xxx\r\nContent-Type: application/json",
                'content' => $payload,
                'timeout' => 5,
                'ignore_errors' => true, // Ne pas bloquer la confirmation commande
            ]])
        );
    }
}

Retourne le détail des crédits de l'abonnement actif. Aucun paramètre requis.

curl https://cabine.ai/api/v1/quota \
  -H "X-Api-Key: vf_live_xxx"

Réponse succès (200)

{
  "success":            true,
  "plan":               "Growth",
  "plan_slug":          "growth",
  "credits_total":      200,
  "credits_used":       37,
  "credits_bonus":      0,
  "credits_remaining":  163,
  "usage_percent":      18,
  "renews_at":          "2025-02-01"
}

Champs de la réponse

Retourne la liste des modèles IA disponibles et indique lesquels sont accessibles avec votre plan. Aucun paramètre requis.

curl https://cabine.ai/api/v1/models \
  -H "X-Api-Key: vf_live_xxx"

Réponse succès (200)

{
  "success": true,
  "models": [
    {
      "id":                     "gemini-3-pro-image-preview",
      "label":                  "Flash Image — défaut ✅",
      "credits_per_generation": 1,
      "available":             true
    },
    // ...
  ]
}

Champs par modèle