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

# Guide de démarrage rapide

> Intégrez IACrea à vos applications en quelques étapes simples

# Guide de démarrage rapide

Ce guide vous aidera à commencer rapidement avec IACrea et à intégrer notre API à vos applications. Pour accéder à notre API, vous devez obligatoirement contacter notre support à [contact@iacrea.com](mailto:contact@iacrea.com).

## Création de votre compte développeur

<Steps>
  <Step title="Inscrivez-vous">
    Rendez-vous sur [IACrea.com](https://iacrea.com) et créez votre compte en
    fournissant vos informations professionnelles.
  </Step>

  {" "}

  <Step title="Vérifiez votre email">
    Confirmez votre compte en cliquant sur le lien que nous vous envoyons par
    email.
  </Step>

  {" "}

  <Step title="Contactez notre support">
    Envoyez un email à [contact@iacrea.com](mailto:contact@iacrea.com) pour demander l'activation de l'accès
    API pour votre compte. Précisez votre cas d'utilisation et vos besoins
    spécifiques.
  </Step>

  <Step title="Accédez à votre Espace développeur">
    Une fois l'accès API activé par notre équipe, connectez-vous à votre compte
    et accédez à la section "Espace développeur" pour récupérer votre clé API.
  </Step>
</Steps>

<Note>
  L'accès à l'API est soumis à validation par notre équipe. Contactez-nous à
  [contact@iacrea.com](mailto:contact@iacrea.com) pour discuter de vos besoins spécifiques et obtenir les
  informations concernant les forfaits disponibles.
</Note>

## Configuration de votre environnement API

<Steps>
  <Step title="Récupérez votre clé API">
    Dans votre Espace Développeur sur le site d'IACrea, récupérez votre clé API unique. Cette clé doit rester confidentielle et ne pas être partagée.

    ```bash theme={null}
    # Exemple d'authentification avec votre clé API
    x-api-key: votre-clé-api
    ```
  </Step>

  <Step title="Testez la connexion">
    Vérifiez que votre configuration fonctionne en récupérant le nombre de photos restantes sur votre compte.

    ```bash theme={null}
    curl --request POST \
    --url 'https://iacrea.com/api/account/credit' \
    --header 'x-api-key: VOTRE_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
      "user_id": "votre-user-id"
    }'
    ```
  </Step>
</Steps>

## Intégration des services IACrea

Notre API offre plusieurs services que vous pouvez intégrer dans votre application :

<Tabs>
  <Tab title="Rénovation">
    ```bash theme={null}
    curl --request POST \
    --url 'https://iacrea.com/api/renovate/generate' \
    --header 'x-api-key: VOTRE_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
      "user_id": "votre-user-id",
      "image_url": "https://exemple.com/image.jpg",
      "theme": "MODERN",
      "room_type": "LIVING_ROOM",
      "photo_360": false
    }'
    ```
  </Tab>

  <Tab title="Ameublement">
    ```bash theme={null}
    curl --request POST \
    --url 'https://iacrea.com/api/furnish/v4/generate' \
    --header 'x-api-key: VOTRE_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
      "user_id": "votre-user-id",
      "image_url": "https://exemple.com/image.jpg",
      "theme": "MODERN",
      "room_type": "LIVING_ROOM",
      "generation_mode": "creative"
    }'
    ```
  </Tab>

  <Tab title="Ciel Bleu">
    ```bash theme={null}
    curl --request POST \
    --url 'https://iacrea.com/api/sky/generate' \
    --header 'x-api-key: VOTRE_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
      "user_id": "votre-user-id",
      "image_url": "https://exemple.com/image.jpg"
    }'
    ```
  </Tab>
</Tabs>

## Récupération des résultats

Comme nos services fonctionnent de manière asynchrone, vous avez deux options pour obtenir les résultats :

### Option 1 : Webhook (recommandé)

Fournissez une URL de webhook lors de l'appel initial, et nous vous notifierons automatiquement lorsque le traitement sera terminé.

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/renovate/generate' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "votre-user-id",
  "image_url": "https://exemple.com/image.jpg",
  "theme": "MODERN",
  "room_type": "LIVING_ROOM",
  "webhook": "https://votre-serveur.com/webhooks/iacrea"
}'
```

### Option 2 : Polling

Interrogez régulièrement l'API de récupération jusqu'à ce que le statut soit "SUCCEEDED" ou "FAILED".

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/renovate/get' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "votre-user-id",
  "generation_id": "id-recu-lors-de-la-generation"
}'
```

## Bonnes pratiques d'intégration

* **Gestion des erreurs** : Implémentez un système robuste de gestion des erreurs pour traiter les réponses d'erreur de l'API
* **Cache des images** : Stockez les URL d'images générées pour éviter de refaire des appels inutiles
* **Monitoring** : Suivez régulièrement votre consommation de crédits via l'API de photos restantes
* **Timeout** : Configurez des timeouts appropriés, car le traitement peut prendre plusieurs minutes

## Ressources supplémentaires

<CardGroup cols={2}>
  <Card title="Documentation API complète" icon="book" href="/api-reference/introduction">
    Consultez notre documentation API détaillée pour tous les endpoints
    disponibles
  </Card>

  <Card title="FAQ" icon="question-circle" href="/faq">
    Trouvez des réponses aux questions fréquemment posées
  </Card>
</CardGroup>

<Note>
  Besoin d'aide pour l'intégration ? Contactez notre équipe de support à
  [contact@iacrea.com](mailto:contact@iacrea.com)
</Note>