> ## 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.

# Quick Start Guide

> Integrate IACrea into your applications in a few simple steps

# Quick Start Guide

This guide will help you get started quickly with IACrea and integrate our API into your applications. To access our API, you must contact our support at [contact@iacrea.com](mailto:contact@iacrea.com).

## Creating Your Developer Account

<Steps>
  <Step title="Sign Up">
    Go to [IACrea.com](https://iacrea.com) and create your account by providing
    your professional information.
  </Step>

  {" "}

  <Step title="Verify Your Email">
    Confirm your account by clicking on the link we send you by email.
  </Step>

  {" "}

  <Step title="Contact Our Support">
    Send an email to [contact@iacrea.com](mailto:contact@iacrea.com) to request API access activation for your
    account. Specify your use case and specific needs.
  </Step>

  <Step title="Access Your Developer Space">
    Once API access is activated by our team, log in to your account and access
    the "Developer Space" section to retrieve your API key.
  </Step>
</Steps>

<Note>
  API access is subject to validation by our team. Contact us at
  [contact@iacrea.com](mailto:contact@iacrea.com) to discuss your specific needs and get information about
  available plans.
</Note>

## Setting Up Your API Environment

<Steps>
  <Step title="Get Your API Key">
    In your Developer Space on the IACrea website, retrieve your unique API key. This key must remain confidential and not be shared.

    ```bash theme={null}
    # Example of authentication with your API key
    x-api-key: your-api-key
    ```
  </Step>

  <Step title="Test the Connection">
    Verify that your configuration works by retrieving the number of photos remaining on your account.

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

## Integrating IACrea Services

Our API offers several services that you can integrate into your application:

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

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

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

## Retrieving Results

Since our services work asynchronously, you have two options for getting the results:

### Option 1: Webhook (recommended)

Provide a webhook URL during the initial call, and we will automatically notify you when processing is complete.

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

### Option 2: Polling

Regularly query the retrieval API until the status is "SUCCEEDED" or "FAILED".

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/renovate/get' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "your-user-id",
  "generation_id": "id-received-during-generation"
}'
```

## Integration Best Practices

* **Error Handling**: Implement a robust error handling system to process API error responses
* **Image Caching**: Store generated image URLs to avoid unnecessary calls
* **Monitoring**: Regularly track your credit consumption through the remaining photos API
* **Timeout**: Configure appropriate timeouts, as processing can take several minutes

## Additional Resources

<CardGroup cols={2}>
  <Card title="Complete API Documentation" icon="book" href="/api-reference/introduction">
    Check our detailed API documentation for all available endpoints
  </Card>

  <Card title="FAQ" icon="question-circle" href="/en/faq">
    Find answers to frequently asked questions
  </Card>
</CardGroup>

<Note>
  Need help with integration? Contact our support team at [contact@iacrea.com](mailto:contact@iacrea.com)
</Note>

{" "}