> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Подключение BuildShip к CometAPI
> Используйте это руководство, чтобы подключить BuildShip к CometAPI, указав base URL, API key и параметры model или provider.
BuildShip — это low-code визуальный конструктор backend. Используйте node сообщества **CometAPI Text Generator**, чтобы добавить генерацию текста на базе AI в любой workflow.
## Требования
* Учетная запись CometAPI с активным API key — [получите его здесь](https://www.cometapi.com/console/token)
* Учетная запись BuildShip — [войдите здесь](https://app.buildship.com)
Войдите в [консоль CometAPI](https://www.cometapi.com/console/token). Нажмите **Add API Key** и скопируйте свой CometAPI API key.
1. В панели BuildShip нажмите **Create a new workflow → From Scratch**.
2. На холсте нажмите **Add Trigger** и выберите **REST API**. Это создаст вызываемый endpoint для workflow.
1. Под триггером REST API нажмите **+ Add a new step**.
2. В поле поиска библиотеки узлов введите `cometapi`.
3. В списке **Community** выберите **CometAPI Text Generator**.
На этом шаге узлу указывается, какую систему управления ключами использовать.
1. Нажмите на узел, чтобы открыть **Node Editor** справа.
2. Перейдите на вкладку **Settings**.
3. В разделе **Key-based Integration** откройте выпадающий список и выберите **CometAPI**.
4. Нажмите синюю кнопку **Save** в правом верхнем углу.
1. В Node Editor перейдите на вкладку **Inputs** (или нажмите прямо на узел).
2. Нажмите значок ключа 🔑 в правом верхнем углу узла, чтобы открыть выпадающий список ключей.
3. Выберите **+ Bring your own Key**.
4. Введите **Key ID** (например, `cometapi-key-1`) и вставьте свой CometAPI API key в поле **Value**.
5. Нажмите **Save**.
На вкладке **Inputs** узла:
* **Instructions** (необязательно): задайте системную роль, например `You are a productivity assistant.`
* **Prompt**: нажмите значок **``**, затем выберите **Trigger → Body → prompt**, чтобы сопоставить входящее body запроса.
* **Advanced → Model**: введите текущий model ID, который хотите использовать.
1. Под узлом CometAPI нажмите **+ Add a new step** и выберите **Return Response**.
2. В поле **Body** нажмите **``** и выберите переменную `response` из узла CometAPI Text Generator.
3. Нажмите **Test** в правом верхнем углу, выберите формат входных данных **JSON** и отправьте:
```json theme={null}
{
"prompt": "hi"
}
```
4. Успешный ответ в панели **Result** подтверждает, что workflow работает.
Если вызов завершился ошибкой, проверьте свой API key и убедитесь, что в Key-based Integration выбрано **CometAPI**, либо свяжитесь с [поддержкой CometAPI](https://www.cometapi.com).
Шаг **Key-based Integration** (связывание узла с CometAPI) обязателен — если его пропустить, возникнут ошибки аутентификации, даже если ваш API key указан верно.