Freelance Workspace

Основная информация

Генерация изображений

Стандартная, по стилю

Расширенная, с доп. параметрами

Получение результата

Прочие запросы

Проверка баланса

Доступные стили

Пример использования API

Для генерации картинок по заранее известному запросу

Для генерации картинок к статье

Default

ClipCloud

Подробная информация о использовании API генерации картинок Telegram-бота ClipCloud

Документация API ClipCloud

Production

Sandbox

<div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=info ><div class="callout-icon"><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><p class="slate-p " ><strong class="slate-bold">Вам не нужно добавлять API вручную, если у вас скрипт/шаблон на Zennoposter!</strong> В таком случае воспользуйтесь готовым модулем:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><a href="https://zenno.club/discussion/threads/clipcloud-api-generacii-kartinok-s-gotovym-modulem-zennoposter-i-s-referalnoj-programmoj-dlja-razrabotchikov-shablonov.127838/" target="_blank">Модуль для Zennoposter</a></div></li></ul><p class="slate-p " >Спецификация OpenAPI - <a href="https://clipai.pro/clipcloud-api-doc/openapi.yaml" target="_blank">здесь</a>.</p></div></div><p class="slate-p " ><strong class="slate-bold">API ClipCloud крайне простой.</strong> Его использование состоит всего из трёх шагов:</p><div class="steps-widget" style="width:100%;
  	min-width:100%;"><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >1</h6><h3 class="slate-h3 " >Подготовка запроса</h3><p class="slate-p " >Сначала необходимо понять, что именно вы хотите сгенерировать.</p><p class="slate-p " >Запрос крайне желательно отправлять на английском языке. <em class="slate-italic">ClipCloud примет запрос и на другом, в т.ч. русском языке, однако в таком случае создание картинки может производиться намного дольше, а её качество может стать хуже.</em></p><p class="slate-p " >Сам же запрос, в идеальном случае, должен содержать лишь информацию о том, что должно быть изображено на картинке. Тем не менее, допускается отправлять и общую информацию (например, название статьи, к которой создаются картинки), однако качество в таком случае может быть хуже. Для подобного простого указания запроса мы рекомендуем использовать стили, имеющие <code class="slate-code">HQ</code> в названии (например, <code class="slate-code">FullHD-HQ-h</code>).</p><p class="slate-p " >Также,<strong class="slate-bold"> если вы владелец своего ПО </strong>на несколько пользователей - не забудьте воспользоваться партнёрской программой для разработчиков: вам будет начисляться <strong class="slate-bold">10%</strong> от трат ваших пользователей. Подробнее можно узнать <a href="https://t.me/clipcloudbot" target="_blank">в боте ClipCloud</a>, нажав на кнопку “Для разработчиков”.</p></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >2</h6><h3 class="slate-h3 " >Отправка запроса на генерацию изображения</h3><p class="slate-p slate-indent-0" style="0px">Затем вам нужно отправить запрос на генерацию изображения.</p><p class="slate-p slate-indent-0" style="0px">Мы рекомендуем всем пользователям использовать исключительно <a href="680297323e7f618a1b9e44f9/67ffddcb1e9feb6ca307d44d" target="">генерацию по стилю</a>: в таком случае ClipCloud <strong class="slate-bold">сам настроит за вас</strong> все необходимые параметры, связанные со стилем: от используемой нейронной сети, до количества шагов (&quot;steps&quot;) и прочих неочевидных параметров. <a href="680297323e7f618a1b9e44f9/680a5a429854d447215a89d4" target="">Расширенная генерация</a>, в то же время, необходима в крайне редких случаях: зачастую вам не стоит тратить время на её добавление.</p><p class="slate-p slate-indent-0" style="0px">Для максимальной скорости работы рекомендуем отправлять запрос на генерацию заранее, как только будет известно, что именно нужно сгенерировать. Следующий же этап <em class="slate-italic">(</em><a href="67ffddcb1e9feb6ca307d44f" target=""><em class="slate-italic">получение результата генерации</em></a><em class="slate-italic">)</em> выполнять в тот момент работы вашей программы, когда изображение уже будет необходимо.</p></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >3</h6><h3 class="slate-h3 " >Получение результата генерации</h3><p class="slate-p slate-indent-0" style="0px">После этого вам необходимо <a href="67ffddcb1e9feb6ca307d44f" target="">получить информацию о готовности</a> изображений. В случае их готовности на момент запроса вам будет доступны ссылки на скачивание картинок.</p><p class="slate-p slate-indent-0-1-1-1-1-1-1-1" style="NaNpx"></p></div></div></div><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

API ClipCloud крайне простой.

 Его использование состоит всего из трёх шагов:

<div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=info ><div class="callout-icon"><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><p class="slate-p slate-indent-0" style="0px"><strong class="slate-bold">Вам не нужно добавлять API вручную, если у вас скрипт/шаблон на Zennoposter!</strong> В таком случае воспользуйтесь готовым модулем:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><a href="https://zenno.club/discussion/threads/clipcloud-api-generacii-kartinok-s-gotovym-modulem-zennoposter-i-s-referalnoj-programmoj-dlja-razrabotchikov-shablonov.127838/" target="_blank">Модуль для Zennoposter</a></div></li></ul><p class="slate-p " >Спецификация OpenAPI - <a href="https://clipai.pro/clipcloud-api-doc/openapi.yaml" target="_blank">здесь</a>.</p></div></div><div class=card-group-box style="width:100%; min-width:540px;"><a href="https://app.theneo.io/1503fe86-2db1-43ac-880a-cbf661919292/clipcloud/generaciya-izobrazhenii/standartnaya-po-stilyu" target="_top" class="card-box-anchor"><img src=https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/1f680.png class=card-icon></img><div ><h3 class="slate-h3 " >Стандартная генерация (по стилю)</h3><p class="slate-p " ><strong class="slate-bold">Идеально подходит для большинства пользователей.</strong> Вместе со стилем изменяется и используемая нейронная сеть, и размер изображения, и прочие параметры.</p><p class="slate-p " ></p><p class="slate-p " >Плюсы:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Быстрый старт.</div></li><li class="slate-li " ><div style="position:relative">Все параметры настроены заранее: невозможно ошибиться и получить “шум” вместо запрашиваемой картинки.</div></li><li class="slate-li " ><div style="position:relative">Возможность автоматизировать выбор стиля в зависимости от запроса.</div></li></ul><p class="slate-p " >Минусы:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Ограниченная кастомизация стилей.</div></li></ul></div></a><a href="https://app.theneo.io/1503fe86-2db1-43ac-880a-cbf661919292/clipcloud/generaciya-izobrazhenii/rasshirennaya-s-dop-parametrami" target="_top" class="card-box-anchor"><img src=https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/1f6e0-fe0f.png class=card-icon></img><div ><h3 class="slate-h3 " >Расширенная генерация</h3><p class="slate-p " ><strong class="slate-bold">Подойдёт в редких случаях.</strong> Например, если вы хотите самостоятельно настроить стиль под свои нужды.</p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " >Плюсы:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Возможность создать свой стиль, или же изменить существующий под свои нужды (например, изменить размер изображения).</div></li></ul><p class="slate-p " >Минусы:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Высокая сложность.</div></li><li class="slate-li " ><div style="position:relative">Неочевидные параметры.</div></li><li class="slate-li " ><div style="position:relative">Есть высокая вероятность получить “шум” вместо картинки.</div></li></ul></div></a></div><p class="slate-p slate-indent-0" style="0px">Если вы планируете интегрировать ClipCloud в своё ПО на несколько пользователей, мы рекомендуем интегрировать только <a href="680297323e7f618a1b9e44f9/67ffddcb1e9feb6ca307d44d" target="">стандартную генерацию (по стилю)</a>.</p><p class="slate-p " ></p>

Если вы планируете интегрировать ClipCloud в своё ПО на несколько пользователей, мы рекомендуем интегрировать только 

<div class="slate-div"><p class="slate-p " >Стандартная генерация картинок по стилю, которая <strong class="slate-bold">рекомендуется для использования всем пользователям сервиса</strong>.</p><p class="slate-p " >В результате данного запроса вы получите ID начатой генерации. Он будет один, даже если вы укажете значение <code class="slate-code">count</code> &gt; 1. Данный ID будет необходим для дальнейшего <a href="67ffddcb1e9feb6ca307d44f" target="">получения результата</a> создания картинки или картинок.</p><p class="slate-p " >Обязательны лишь параметры <code class="slate-code">prompt</code> и <code class="slate-code">style</code> в теле запроса, а также <code class="slate-code">apikey</code> в URL запроса.</p><p class="slate-p " ><strong class="slate-bold">POST-запрос</strong>, формат данных - application/json (как, например, и в API GPT).</p></div><p class="slate-p " ></p>

Запрос на генерацию изображения. Крайне желательно вводить на английском языке.

prompt

Укажите, что вы **не** хотите видеть на изображении.

negative_prompt

Название стиля картинки. Все стили в виде таблицы можно посмотреть на странице https://clipai.pro/faq/clipcloud-api-styles/

styleName

Количество генерируемых с одним запросом изображений.

count

ID вашего программного обеспечения. Его можно узнать в боте ClipCloud для получения реферальных отчислений: 10% от стоимости каждого запроса через ваше ПО.

soft_id

"False", если вы хотите сгенерировать картинку данным запросом.
"True", если этим запросом вы **не** хотите начинать генерацию, а лишь хотите узнать стоимость запроса при использовании платного режима.

check_cost

Ваш API-ключ из Telegram-бота https://t.me/clipcloudbot . API-ключ ClipCloud всегда начинается с "clip-".

apikey

"true" - изображение генерируется; "false" - ошибка при генерации.

success

ID генерации (будет необходим в запросе на получение результата)

creation_id

Генерация изображения успешно начата.

title

status

errors

Ошибка при создании запроса на генерацию изображения. Например, в данном случае - не введён запрос.

message

Осталось недостаточно бесплатных генераций.
Та же ошибка будет и после окончания платного баланса: после того, как потратится в том числе и бесплатный.

API-ключ не указан, либо указан неверно.

Формат POST-запроса должен быть "application/json".
Такой же формат используется, например, в API GPT.

Скорее всего, вам нужно добавить заголовок:
"Content-Type": "application/json"

Если вы делаете запрос через Zennoposter, то в блоке POST-запроса:
1. Выберите "Тип данных" - "Другой".
2. Введите "application/json" в поле рядом.

<p class="slate-p " >Расширенная генерация картинок, которая рекомендуется для использования лишь в исключительных случаях: опытными пользователями, которые хотят настроить каждый параметр.</p><p class="slate-p " >В результате данного запроса вы получите ID начатой генерации. Он будет один, даже если вы укажете значение <code class="slate-code">count</code> &gt; 1. Данный ID будет необходим для дальнейшего <a href="67ffddcb1e9feb6ca307d44f" target="">получения результата</a> создания картинки.</p><p class="slate-p " >Обязателен лишь параметр <code class="slate-code">prompt</code> в теле запроса, а также <code class="slate-code">apikey</code> в URL запроса. Однако для получения хороших результатов при расширенной генерации, которая и рассматривается на данной странице, вам необходимо будет указать ещё как минимум <code class="slate-code">model</code>, <code class="slate-code">width</code>, <code class="slate-code">height</code>, <code class="slate-code">quality</code>. Чтобы их не указывать, и при этом достичь хорошего результата, воспользуйтесь <a href="680297323e7f618a1b9e44f9/67ffddcb1e9feb6ca307d44d" target="">генерацией по стилю</a>.</p><p class="slate-p slate-indent-0" style="0px"><strong class="slate-bold">POST-запрос</strong>, формат данных - application/json (как, например, и в API GPT).</p><p class="slate-p " ></p>

Расширенная генерация картинок, которая рекомендуется для использования лишь в исключительных случаях: опытными пользователями, которые хотят настроить каждый параметр.

В результате данного запроса вы получите ID начатой генерации. Он будет один, даже если вы укажете значение 

 > 1. Данный ID будет необходим для дальнейшего 

Обязателен лишь параметр 

 в теле запроса, а также 

 в URL запроса. Однако для получения хороших результатов при расширенной генерации, которая и рассматривается на данной странице, вам необходимо будет указать ещё как минимум 

. Чтобы их не указывать, и при этом достичь хорошего результата, воспользуйтесь 

, формат данных - application/json (как, например, и в API GPT).

Практически аналог параметра "CFG Scale" в других сервисах. Чем больше его значение, тем больше ИИ принимает во внимание запрос.

temperature

width

height

quality

model

Ваш API-ключ из Telegram-бота https://t.me/clipcloudbot

<p class="slate-p " ><strong class="slate-bold">GET-запрос</strong>. В URL запроса - ваш API-ключ и ID генерации, полученный ранее в ответе на запрос генерации изображения. В ответе - ссылка/ссылки на сгенерированные изображения (по 1 ссылке на каждое изображение).</p><p class="slate-p " ></p>

. В URL запроса - ваш API-ключ и ID генерации, полученный ранее в ответе на запрос генерации изображения. В ответе - ссылка/ссылки на сгенерированные изображения (по 1 ссылке на каждое изображение).

ID генерации, полученный ранее в ответе на запрос генерации изображения

Creation ID

Ваш API-ключ из Telegram-бота @clipcloudbot

ID генерации успешно найден.

ID генерации (тот же, что и вы вводили в данном запросе).

Изображение ещё генерируется. Повторите запрос через некоторое время.

Итоговая стоимость всех сгенерированных в этом запросе изображений (если использовался платный режим).

cost

Генерация скольких изображений была отменена сервером из-за их потенциального несоответствия правилам использования. Обычно отмена происходит при NSFW запросах и подобных.

censored

Ссылки на сгенерированные изображения

results

Изображение успешно сгенерировано.

Неверно указан один из параметров: например, ID генерации введён в неправильном формате. Обратите внимание, что ID генерации нужно вводить без скобок {}, кавычек, и прочих символов, кроме тех, которые были отправлены в ответ на предыдущий запрос.

URL запроса указан неверно.
Если ответ "404" появляется при запросе на скачивание изображения, то ссылка на скачивание либо истекла, либо указана неверно.

Неверно задан URL запроса, или не указан ID генерации в запросе.

Вы указали неверный или истёкший ID генерации, хоть он, скорее всего, и указан в правильном формате.
Либо произошла ошибка на стороне сервера.

<p class="slate-p " >В этой категории расположены прочие запросы, которые могут быть полезны (но совсем не обязательны) в программах в некоторых случаях.</p><p class="slate-p " ><a href="68213870f940829eafd2e2e4/6834325a9d27ab7a2891c7c4" target="">Проверка баланса API-ключа</a></p><p class="slate-p " ><a href="68213870f940829eafd2e2e4/6823d5c23655096e778611ed" target="">Получение доступных стилей</a></p>

В этой категории расположены прочие запросы, которые могут быть полезны (но совсем не обязательны) в программах в некоторых случаях.

<p class="slate-p " >Здесь расположены примеры использования API в различных ситуациях:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><a href="68043e40092799ae64c1d5e6/680a648b9854d447215b2896" target="">Для генерации картинок к статье</a> (в том числе для автоматически генерируемых при помощи сторонних ИИ статей)</div></li><li class="slate-li " ><div style="position:relative"><a href="68043e40092799ae64c1d5e6/680a64c037d1b3e72b70cc8e" target="">Для генерации картинок по заранее известному запросу</a> (стандартный способ использования)</div></li></ul><p class="slate-p " ></p>

Здесь расположены примеры использования API в различных ситуациях:

Sections