Freelance Workspace

Main Information

Image Generation

Standard (by style)

Advanced (with additional parameters)

Obtaining Results

Other Requests

Balance Inquiry

Available Styles

API Usage Example

For generating images from a predefined prompt

For generating images for an article

Default

ClipCloud (EN)

Detailed information on using the ClipCloud Telegram bot’s image‑generation API

ClipCloud API documentation

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">You don’t need to add the API manually if you already have a script/template for ZennoPoster!</strong> In that case, use the ready‑made module:</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">Module for Zennoposter</a></div></li></ul><p class="slate-p " >OpenAPI specification is <a href="https://clipai.pro/clipcloud-api-doc/openapi.yaml" target="_blank">here</a>.</p></div></div><p class="slate-p " ><strong class="slate-bold">The ClipCloud API is extremely simple.</strong> Using it involves just three steps:</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 " >Preparing the request</h3><p class="slate-p " >First, you need to decide exactly what you want to generate. <strong class="slate-bold">It’s highly recommended to send your prompt in English.</strong></p><p class="slate-p " >Ideally, your prompt should contain only the information about what should appear in the image. However, you can also include general context (e.g. the title of the article you’re illustrating), though this may reduce quality. For simple prompts like that, we recommend using any style with <code class="slate-code">HQ</code> in its name (for example, <code class="slate-code">FullHD-HQ-h</code>).</p><p class="slate-p " ><strong class="slate-bold">If you’re a software owner</strong>, don’t forget to join our developer affiliate program: you’ll earn <strong class="slate-bold">10%</strong> of your users’ spending. Learn more in the <a href="https://t.me/clipcloudbot" target="_blank">ClipCloud bot</a> by clicking “For Developers”.</p></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >2</h6><h3 class="slate-h3 " >Sending the generation request</h3><p class="slate-p slate-indent-0" style="0px">Next, you send the image‑generation request.</p><p class="slate-p slate-indent-0" style="0px">We recommend all users stick to <a href="687587c854e422075d4fd5a0/687587c854e422075d4fd56c" target="">generation by style</a>: <strong class="slate-bold">ClipCloud will automatically configure</strong> all the necessary parameters—everything from the neural network to the number of steps and other non‑obvious settings. <a href="687587c854e422075d4fd5a0/687587c854e422075d4fd5a6" target="">Advanced generation</a> is needed only in very rare cases; most of the time there’s no need to spend time on it.</p><p class="slate-p slate-indent-0" style="0px">For maximum speed, we recommend sending the generation request in advance, as soon as you know exactly what needs to be generated. Then, perform the next step <em class="slate-italic">(</em><a href="687587c854e422075d4fd584" target=""><em class="slate-italic">retrieving the generation result</em></a><em class="slate-italic">)</em> at the point in your program’s workflow when the image is actually needed.</p></div></div><div class="steps-wrapper"><div class="steps-content"><h6 class="slate-h6 " >3</h6><h3 class="slate-h3 " >Retrieving the results</h3><p class="slate-p slate-indent-0" style="0px">Finally, check <a href="687587c854e422075d4fd584" target="">whether the images are ready</a>. If they’re complete at the time of your query, you’ll immediately get download links for your images.</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><p class="slate-p " ></p>

<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">You don’t need to add the API manually if you already have a script or template for ZennoPoster!</strong> In that case, use the ready‑made module:</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">Module for Zennoposter</a></div></li></ul><p class="slate-p " >OpenAPI specification is <a href="https://clipai.pro/clipcloud-api-doc/openapi.yaml" target="_blank">here</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-clone/image-generation/standard-by-style" 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 " >Standard generation (by style)</h3><p class="slate-p " ><strong class="slate-bold">Ideal for most users.</strong> Choosing a style also configures the neural network, image dimensions, and other settings.</p><p class="slate-p " ></p><p class="slate-p " >Pros:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Quick to get started.</div></li><li class="slate-li " ><div style="position:relative">All parameters are pre‑set: you won’t get “noise” instead of your requested image by mistake.</div></li><li class="slate-li " ><div style="position:relative">You can automate style selection based on the prompt.</div></li></ul><p class="slate-p " >Cons:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Limited style customization.</div></li></ul></div></a><a href="https://app.theneo.io/1503fe86-2db1-43ac-880a-cbf661919292/clipcloud-clone/image-generation/advanced-with-additional-parameters" 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 " >Advanced generation</h3><p class="slate-p " ><strong class="slate-bold">Useful only in rare cases</strong> — for example, if you need to fine‑tune a style for your specific requirements.</p><p class="slate-p " ></p><p class="slate-p " >Pros:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Ability to create your own style or modify an existing one (e.g., change the image size).</div></li></ul><p class="slate-p " >Cons:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">High complexity.</div></li><li class="slate-li " ><div style="position:relative">Parameters aren’t always intuitive.</div></li><li class="slate-li " ><div style="position:relative">Greater risk of ending up with “noise” instead of a usable image.</div></li></ul></div></a></div><p class="slate-p slate-indent-0" style="0px">If you plan to integrate ClipCloud into your software for multiple users, we recommend using only <a href="687587c854e422075d4fd5a0/687587c854e422075d4fd56c" target="">standard generation (by style)</a>.</p><p class="slate-p " ></p><p class="slate-p " ></p>

If you plan to integrate ClipCloud into your software for multiple users, we recommend using only 

<div class="slate-div"><p class="slate-p " >Standard image generation by style, recommended for all service users.</p><p class="slate-p " >As a result of this request, you will receive the ID of the started generation. It will be one, even if you specify <code class="slate-code">count</code> &gt; 1. This ID will be needed later to <a href="687587c854e422075d4fd584" target="">obtain the result</a> of creating the image or images.</p><p class="slate-p " >Only the <code class="slate-code">prompt</code> and <code class="slate-code">style</code> parameters in the request body, as well as <code class="slate-code">apikey</code> in the request URL, are mandatory.</p><p class="slate-p " ><strong class="slate-bold">POST request</strong>, data format – application/json (as, for example, in the GPT API).</p></div><p class="slate-p " ></p><p class="slate-p " ></p>

The request to generate an image. It is highly recommended to enter it in English.

prompt

Specify what you **do not** want to see in the image.

negative_prompt

The name of the image style. You can view all styles in a table on the page  https://clipai.pro/faq/clipcloud-api-styles/

styleName

The number of images generated with a single request.

count

The ID of your software. You can find it in the ClipCloud bot to receive referral payments: 10% of the cost of each request through your software.

soft_id

“False”, if you want to generate an image with this request.
“True”, if with this request you do not want to start generation, but only want to find out the cost of the request when using the paid mode.

check_cost

Your API key from the Telegram bot  https://t.me/clipcloudbot. A ClipCloud API key always begins with “clip-”.

apikey

“true” – the image is being generated; “false” – an error occurred during generation.

success

Generation ID (will be needed in the request to get the result)

creation_id

title

status

errors

Error creating the image generation request. For example, in this case – no prompt entered.

message

Not enough free generations left.
The same error will appear after the paid balance is exhausted: after the free balance is also spent.

The API key is not specified or is incorrect.

The POST request format must be “application/json”.
The same format is used, for example, in the GPT API.

Most likely you need to add the header:
“Content-Type”: “application/json”

If you are making a request through Zennoposter, then in the POST request block:

1. Select “Data type” – “Other”.
2. Enter “application/json” in the field next to it.

<p class="slate-p " >Advanced image generation, recommended only in exceptional cases: for experienced users who want to configure every parameter.</p><p class="slate-p " >As a result of this request you will receive the ID of the started generation. It will be one, even if you specify <code class="slate-code">count</code> &gt; 1. You will need this ID later to <a href="687587c854e422075d4fd584" target="">obtain the result</a> of creating the image.</p><p class="slate-p " >Only the <code class="slate-code">prompt</code> parameter in the request body and <code class="slate-code">apikey</code> in the request URL are mandatory. However, to obtain good results with advanced generation (described on this page) you will also need to specify at least <code class="slate-code">model</code>, <code class="slate-code">width</code>, <code class="slate-code">height</code>, and <code class="slate-code">quality</code>. If you prefer not to specify them yet still achieve good results, use <a href="687587c854e422075d4fd5a0/687587c854e422075d4fd56c" target="">style‑based generation</a> instead.</p><p class="slate-p slate-indent-0" style="0px"><strong class="slate-bold">POST request</strong>, data format – application/json (as, for example, in the GPT API).</p><p class="slate-p " ></p><p class="slate-p " ></p>

Advanced image generation, recommended only in exceptional cases: for experienced users who want to configure every parameter.

As a result of this request you will receive the ID of the started generation. It will be one, even if you specify 

 in the request URL are mandatory. However, to obtain good results with advanced generation (described on this page) you will also need to specify at least 

. If you prefer not to specify them yet still achieve good results, use 

, data format – application/json (as, for example, in the GPT API).

The prompt for image generation. It is highly recommended to enter it in English.

Roughly equivalent to the “CFG Scale” parameter in other services. The higher its value, the more the AI takes the prompt into account.

temperature

width

height

quality

model

Number of images generated with a single request.

Your software ID. You can find it in the ClipCloud bot to receive referral payouts: 10 % of the cost of every request through your software.

“False” if you want to generate an image with this request.
“True” if you do not want to start generation with this request but only want to know the cost of the request when using the paid mode.

Your API key from the Telegram bot https://t.me/clipcloudbot. A ClipCloud API key always begins with “clip-”.

<p class="slate-p " ><strong class="slate-bold">GET request</strong>. In the request URL — your API key and the generation ID obtained earlier in the image‑generation request response. The response contains the link(s) to the generated images (one link per image).</p><p class="slate-p " ></p><p class="slate-p " ></p>

. In the request URL — your API key and the generation ID obtained earlier in the image‑generation request response. The response contains the link(s) to the generated images (one link per image).

Generation ID obtained earlier in the image‑generation request response.

Creation ID

Your API key from the Telegram bot @clipcloudbot.

Generation ID (the same one you entered in this request).

The image is still being generated. Repeat the request after some time.

Total cost of all images generated in this request (if paid mode was used).

cost

How many images were canceled by the server because they potentially violated the usage rules. Cancellation usually occurs for NSFW prompts and similar cases.

censored

results

One of the parameters is incorrect: for example, the generation ID is in the wrong format. Note that the generation ID must be entered without braces {}, quotation marks, or any characters other than those returned in the previous response.

The request URL is incorrect.
If a “404” response appears when requesting to download an image, the download link has either expired or is incorrect.

The request URL is incorrect, or the generation ID is not specified in the request.

You specified an incorrect or expired generation ID, although it is probably in the correct format.
Or a server‑side error occurred.

<p class="slate-p " >In this category you’ll find miscellaneous requests that may be useful (but are not mandatory) in certain program workflows:</p><p class="slate-p " ><a href="687587c854e422075d4fd5c6/687587c854e422075d4fd5d9" target="">Checking the API-key balance</a></p><p class="slate-p " ><a href="687587c854e422075d4fd5c6/687587c854e422075d4fd5c8" target="">Retrieving available styles</a></p><p class="slate-p " ></p>

In this category you’ll find miscellaneous requests that may be useful (but are not mandatory) in certain program workflows:

<p class="slate-p " >Here are examples of using the API in various scenarios:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><a href="687587c854e422075d4fd5a4/687587c854e422075d4fd5c2" target="">For generating images for an article</a> (including those automatically generated by third‑party AI)</div></li><li class="slate-li " ><div style="position:relative"><a href="687587c854e422075d4fd5a4/687587c854e422075d4fd5c4" target="">For generating images from a predefined prompt</a> (the standard usage method)</div></li></ul><p class="slate-p " ></p><p class="slate-p " ></p>

Here are examples of using the API in various scenarios:

Sections