@@ -39,7 +39,9 @@ While each task has an associated [`pipeline`], it is simpler to use the general
...
@@ -39,7 +39,9 @@ While each task has an associated [`pipeline`], it is simpler to use the general
2. Pass your input text to the [`pipeline`]:
2. Pass your input text to the [`pipeline`]:
```py
```py
>>> generator("Three Rings for the Elven-kings under the sky, Seven for the Dwarf-lords in their halls of stone")
>>> generator(
... "Three Rings for the Elven-kings under the sky, Seven for the Dwarf-lords in their halls of stone"
... ) # doctest: +SKIP
[{'generated_text': 'Three Rings for the Elven-kings under the sky, Seven for the Dwarf-lords in their halls of stone, Seven for the Iron-priests at the door to the east, and thirteen for the Lord Kings at the end of the mountain'}]
[{'generated_text': 'Three Rings for the Elven-kings under the sky, Seven for the Dwarf-lords in their halls of stone, Seven for the Iron-priests at the door to the east, and thirteen for the Lord Kings at the end of the mountain'}]
```
```
...
@@ -51,7 +53,7 @@ If you have more than one input, pass your input as a list:
...
@@ -51,7 +53,7 @@ If you have more than one input, pass your input as a list:
... "Three Rings for the Elven-kings under the sky, Seven for the Dwarf-lords in their halls of stone",
... "Three Rings for the Elven-kings under the sky, Seven for the Dwarf-lords in their halls of stone",
... "Nine for Mortal Men, doomed to die, One for the Dark Lord on his dark throne",
... "Nine for Mortal Men, doomed to die, One for the Dark Lord on his dark throne",
... ]
... ]
... )
... ) # doctest: +SKIP
```
```
Any additional parameters for your task can also be included in the [`pipeline`]. The `text-generation` task has a [`~generation_utils.GenerationMixin.generate`] method with several parameters for controlling the output. For example, if you want to generate more than one output, set the `num_return_sequences` parameter:
Any additional parameters for your task can also be included in the [`pipeline`]. The `text-generation` task has a [`~generation_utils.GenerationMixin.generate`] method with several parameters for controlling the output. For example, if you want to generate more than one output, set the `num_return_sequences` parameter:
...
@@ -60,7 +62,7 @@ Any additional parameters for your task can also be included in the [`pipeline`]
...
@@ -60,7 +62,7 @@ Any additional parameters for your task can also be included in the [`pipeline`]
>>> generator(
>>> generator(
... "Three Rings for the Elven-kings under the sky, Seven for the Dwarf-lords in their halls of stone",
... "Three Rings for the Elven-kings under the sky, Seven for the Dwarf-lords in their halls of stone",
... num_return_sequences=2,
... num_return_sequences=2,
... )
... ) # doctest: +SKIP
```
```
### Choose a model and tokenizer
### Choose a model and tokenizer
...
@@ -85,7 +87,9 @@ Create a [`pipeline`] for your task, and specify the model and tokenizer you've
...
@@ -85,7 +87,9 @@ Create a [`pipeline`] for your task, and specify the model and tokenizer you've
Pass your input text to the [`pipeline`] to generate some text:
Pass your input text to the [`pipeline`] to generate some text:
```py
```py
>>> generator("Three Rings for the Elven-kings under the sky, Seven for the Dwarf-lords in their halls of stone")
>>> generator(
... "Three Rings for the Elven-kings under the sky, Seven for the Dwarf-lords in their halls of stone"
... ) # doctest: +SKIP
[{'generated_text': 'Three Rings for the Elven-kings under the sky, Seven for the Dwarf-lords in their halls of stone, Seven for the Dragon-lords (for them to rule in a world ruled by their rulers, and all who live within the realm'}]
[{'generated_text': 'Three Rings for the Elven-kings under the sky, Seven for the Dwarf-lords in their halls of stone, Seven for the Dragon-lords (for them to rule in a world ruled by their rulers, and all who live within the realm'}]
```
```
...
@@ -93,7 +97,18 @@ Pass your input text to the [`pipeline`] to generate some text:
...
@@ -93,7 +97,18 @@ Pass your input text to the [`pipeline`] to generate some text:
The flexibility of the [`pipeline`] means it can also be extended to audio tasks.
The flexibility of the [`pipeline`] means it can also be extended to audio tasks.
For example, let's classify the emotion from a short clip of John F. Kennedy's famous ["We choose to go to the Moon"](https://en.wikipedia.org/wiki/We_choose_to_go_to_the_Moon) speech. Find an [audio classification](https://huggingface.co/models?pipeline_tag=audio-classification) model on the Model Hub for emotion recognition and load it in the [`pipeline`]:
For example, let's classify the emotion in this audio clip:
Find an [audio classification](https://huggingface.co/models?pipeline_tag=audio-classification) model on the Model Hub for emotion recognition and load it in the [`pipeline`]:
```py
```py
>>> from transformers import pipeline
>>> from transformers import pipeline
...
@@ -106,12 +121,10 @@ For example, let's classify the emotion from a short clip of John F. Kennedy's f
...
@@ -106,12 +121,10 @@ For example, let's classify the emotion from a short clip of John F. Kennedy's f
Pass the audio file to the [`pipeline`]:
Pass the audio file to the [`pipeline`]:
```py
```py
>>> audio_classifier("jfk_moon_speech.wav")
>>> preds = audio_classifier(audio_file)
[{'label': 'calm', 'score': 0.13856211304664612},
>>> preds = [{"score": round(pred["score"], 4), "label": pred["label"]} for pred in preds]