Ideal House
Перейти к содержанию

Учетные данные и среды#

Запросы AI API используют ключ API, принадлежащий вашему аккаунту Ideal House API. Храните его на сервере и отправляйте в заголовке запроса APIKEY.

Получите ключ API#

  1. Войдите в консоль AI API.
  2. Откройте панель управления ключом API и создайте или выберите ключ для вашей интеграции.
  3. Храните ключ в хранилище секретов сервера или в конфигурации среды. Не добавляйте его в систему контроля версий и не включайте в браузерную сборку.

Чтение этой документации не создаёт ключ API и не предоставляет доступ к аккаунту.

Настройка среды запросов#

Используйте базовый URL и путь запроса, указанные в выбранном справочном разделе API. Например, в справочниках, где указан https://api.ideal.house, следует использовать этот API-хост, а не документационный URL.

Храните ключ API в серверной переменной окружения, например IDEALHOUSE_API_KEY. Это пример имени переменной вашего приложения, а не настройка SDK. Запрос должен включать следующий заголовок; замените заполнитель на сервере:

http
APIKEY: YOUR_API_KEY

Соблюдайте требования эндпоинта к типу содержимого, полям и формату входных изображений. Для асинхронных операций сохраняйте полученный идентификатор задачи и используйте эндпоинт результата, описанный для этой операции.

Разработка и рабочая среда#

Выполняйте локальные тесты через свой сервер, чтобы ключ оставался закрытым. Настройте секреты развертывания до публикации и проверьте цены, лимиты задач и списание кредитов. Тестовые запросы могут расходовать кредиты аккаунта; эти руководства не обещают отдельную бесплатную тестовую среду.

Shop ID и Publishable Key продавца, а также Client Secret для импорта товаров относятся к интеграции Visualizer SDK. Они не заменяют ключ AI API. Настройка Allowed Origins (CORS) в панели управления продавца предназначена для интеграции визуализатора, а не для настройки серверных запросов AI API.

Проверка аутентификации#

Следуйте Быстому старту, затем проверьте ответ, специфичный для операции. Если аутентификация не удалась, проверьте заголовок APIKEY и обратитесь к кодам ошибок. Удалите ключи из журналов и скриншотов для службы поддержки.