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

​
Creating Your Developer Account

1

Sign Up

Go to IACrea.com and create your account by providing your professional information.

2

Verify Your Email

Confirm your account by clicking on the link we send you by email.

3

Contact Our Support

Send an email to contact@iacrea.com to request API access activation for your account. Specify your use case and specific needs.

4

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.

API access is subject to validation by our team. Contact us at contact@iacrea.com to discuss your specific needs and get information about available plans.

​
Setting Up Your API Environment

1

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.

# Example of authentication with your API key
x-api-key: your-api-key
2

Test the Connection

Verify that your configuration works by retrieving the number of photos remaining on your account.

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"
}'

​
Integrating IACrea Services

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

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
}'

​
Retrieving Results

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

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

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

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

Complete API Documentation

Check our detailed API documentation for all available endpoints

FAQ

Find answers to frequently asked questions

Need help with integration? Contact our support team at contact@iacrea.com