# Discussion about the pipelines API

**URL:** <https://discuss.huggingface.co/t/discussion-about-the-pipelines-api/20585>\
**Category:** 🧨 Diffusers\
**Created:** [July 19, 2022, 4:23pm UTC](https://discuss.huggingface.co/t/discussion-about-the-pipelines-api/20585 "2022-07-19T16:23:44Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![patrickvonplaten](https://sea2.discourse-cdn.com/hellohellohello/user_avatar/discuss.huggingface.co/patrickvonplaten/32/2171_2.png) [@patrickvonplaten](https://discuss.huggingface.co/u/patrickvonplaten)\
**Post date:** [July 19, 2022, 4:23pm UTC](https://discuss.huggingface.co/t/discussion-about-the-pipelines-api/20585/1 "2022-07-19T16:23:45Z")

</div>

Thread to collect all feedback regarding the public API of the code in `src/diffusers/pipelines`.

To better understand what exactly a _pipeline_ is, please see: [GitHub - huggingface/diffusers](https://github.com/huggingface/diffusers#definitions)

---

<div class="post-metadata">

**Author:** ![ehalit](https://sea2.discourse-cdn.com/hellohellohello/user_avatar/discuss.huggingface.co/ehalit/32/28854_2.png) [@ehalit](https://discuss.huggingface.co/u/ehalit)\
**Post date:** [September 23, 2022, 7:48am UTC](https://discuss.huggingface.co/t/discussion-about-the-pipelines-api/20585/2 "2022-09-23T07:48:32Z")

</div>

Hello and thanks for building such an awesome and useful library! I have a question, in the example scripts you provide there is a `strength` parameter given to the pipeline call function. What is its purpose and what does it do? What is the apparent effect of increasing or decreasing it?

Specifically, in the official GitHub repo of the library ([link](https://github.com/huggingface/diffusers/tree/main/src/diffusers/pipelines)) the lines:

```auto
with autocast("cuda"):
    images = pipe(prompt=prompt, init_image=init_image, mask_image=mask_image, strength=0.75).images

```

have the `strength` parameter. It would be best if you could provide the explanation in the docstring.

---

<div class="post-metadata">

**Author:** ![pcuenq](https://sea2.discourse-cdn.com/hellohellohello/user_avatar/discuss.huggingface.co/pcuenq/32/32135_2.png) [@pcuenq](https://discuss.huggingface.co/u/pcuenq)\
**Post date:** [September 23, 2022, 12:19pm UTC](https://discuss.huggingface.co/t/discussion-about-the-pipelines-api/20585/3 "2022-09-23T12:19:15Z")

</div>

Hi @ehalit! Thanks a lot for your nice comments and for your question 🙂

We recently added docstrings for the `strength` parameter [here](https://github.com/huggingface/diffusers/blob/main/src/diffusers/pipelines/stable_diffusion/pipeline_stable_diffusion_inpaint.py#L168). Is there any other place where we may have missed them?

---

<div class="post-metadata">

**Author:** ![ehalit](https://sea2.discourse-cdn.com/hellohellohello/user_avatar/discuss.huggingface.co/ehalit/32/28854_2.png) [@ehalit](https://discuss.huggingface.co/u/ehalit)\
**Post date:** [September 23, 2022, 12:46pm UTC](https://discuss.huggingface.co/t/discussion-about-the-pipelines-api/20585/4 "2022-09-23T12:46:22Z")

</div>

Oh I see, I was looking at the text-to-image generation docstring, as I understand this parameter is not related to this task. Maybe an indicator in the text-to-image docs would be helpful…
