Paraphrase

AI21 Studio's paraphrase Task-Specific Model offers access to our world-class paraphrasing engine. It has been specifically developed for suggesting alternative ways to convey the same message using different words.

The model takes a piece of text and returns a list of paraphrases that convey the same meaning using different words, according to the style you choose. As a specialized API for paraphrasing, it contains features to enable you more control over the output by adjusting the tone and style. Moreover, you can add additional context to the text, to make the rewrite suggestion more relevant (by paraphrasing a certain range of your text).

Try it

The tool below can paraphrase your input text using a general style. Other styles available in the playground and API include casual, formal, long and short.

Usage

Choose a style that fits your needs

You have the choice between five different styles:

General - there are fresh and creative ways to rephrase sentences. Offer them to your users.
Casual - convey a friendlier and more accessible tone for the right audience.
Formal - present your words in a more professional way.
Short - express your messages clearly and concisely.
Long - expand your sentences to give more detail, nuance and depth.

Provide context for your paraphrased text

You can specify start and end points to paraphrase from a longer text. If you want to paraphrase part of a longer text, provide as much context as makes sense, so that the system can get a good idea of what you're trying to say when it generates suggestions.

To improve fluency, the model can modify up to one word before or after the suggested range. For example, consider the following sentence (where the range to paraphrase is bolded):

I had a good night.

Among the response suggestions, you may see “I had a relaxing evening”, where the range is on the limit, as well as “I had an enjoyable evening”, where you can see the range included an extra word before.

Don't over-narrow your selection

For example, consider the sentence “This is a flat out bad example”. Paraphrasing the word “flat” alone in this sentence without violating fluency is not possible, because “flat” is part of the term “flat out”. Cases like this usually yield few or no suggestions.

Examples

By integrating the Paraphrase API into your system, your users gain an embedded co-writer within the experience. This is useful for virtually all text-based tasks, from marketing content (like that post about a newly specialized API) to emails (a formal report to higher-ups or casual correspondence with a colleague) and even general descriptions. Following are some examples illustrating both use cases and special features you can take advantage of with this API.

General writing

Example 1

You can enhance the writing experience of your users by adding paraphrasing functionality to your writing platforms. See the following example for a generic call, without any of the special features. Here is an example for paraphrasing suggestions (note that the API will return up to 10 suggestions in every call):

Text
We will explore the Paraphrase API's advantages and features throughout this page.
Suggestions
The Paraphrase API will be explored throughout this page.
On this page, we will look at the advantages and features of the Paraphrase API.
In this page, we'll explore Paraphrase API's benefits and features.
This page provides an overview of the Paraphrase API's advantages and features
We will discuss the benefits and features of the Paraphrase API throughout this page.

You can use this code and see for yourself:

from ai21 import AI21Client

client = AI21Client(
    # This is the default and can be omitted
    api_key=os.environ.get("AI21_API_KEY"),
)

response = client.paraphrase.create(
  text=="Throughout this page, we will explore the advantages and features of the Paraphrase API.",
)

import requests

fetch("https://api.ai21.com/studio/v1/paraphrase", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "Throughout this page, we will explore the advantages and features of the Paraphrase API."
  }),
  method: "POST"
});

{
   "id":"e218271d-bc3a-3c31-5576-e6b09eb75f8b",
   "suggestions":[
      {
         "text":"We will explore the Paraphrase API's advantages and features throughout this page."
      },
      {
         "text":"The Paraphrase API will be explored throughout this page."
      },
      {
         "text":"On this page, we will look at the advantages and features of the Paraphrase API."
      },
      {
         "text":"In this page, we'll explore Paraphrase API's benefits and features."
      },
      {
         "text":"This page explores the advantages and features of Paraphrase API."
      },
      {
         "text":"This page provides an overview of the Paraphrase API's advantages and features."
      },
      {
         "text":"We will discuss the benefits and features of the Paraphrase API throughout this page."
      },
      {
         "text":"During this page, you will learn about the features and advantages of the Paraphrase API."
      },
      {
         "text":"This page will explore the Paraphrase API's advantages and features."
      },
      {
         "text":"In this page, we'll discuss the advantages and features of the Paraphrase API."
      }
   ]
}

Example 2

Request:

from ai21 import AI21Client

client = AI21Client(
    # This is the default and can be omitted
    api_key=os.environ.get("AI21_API_KEY"),
)

// Paraphrase everything after “Is my contractor licensed?”
response = client.paraphrase.create(
  text="My team discovered that there was little-to-no information that answered the question, “Is my contractor licensed?” We figured that we should create some pages that satisfied this need.",
  start_index=116,
)

Response:

[
   {
      "text":"My team discovered that there was little-to-no information that answered the question, “Is my contractor licensed?” Therefore, we decided to create some pages that answered this question."
   },
   {
      "text":"My team discovered that there was little-to-no information that answered the question, “Is my contractor licensed?” Our team decided to create some pages to answer this question."
   },
   {
      "text":"My team discovered that there was little-to-no information that answered the question, “Is my contractor licensed?” This led to the idea of creating some pages that answered this question."
   },
   {
      "text":"My team discovered that there was little-to-no information that answered the question, “Is my contractor licensed?” Thus, some pages were created to provide this information."
   },
   {
      "text":"My team discovered that there was little-to-no information that answered the question, “Is my contractor licensed?” Thus, we decided to create some pages that address this issue."
   },
   {
      "text":"My team discovered that there was little-to-no information that answered the question, “Is my contractor licensed?” Therefore, we designed some pages that addressed this question."
   },
   {
      "text":"My team discovered that there was little-to-no information that answered the question, “Is my contractor licensed?” Therefore, we decided to create some pages that would fulfill this need."
   },
   {
      "text":"My team discovered that there was little-to-no information that answered the question, “Is my contractor licensed?” Thus, we created some pages that provide that information."
   },
   {
      "text":"My team discovered that there was little-to-no information that answered the question, “Is my contractor licensed?” Thus, we decided to create a few pages about this topic."
   },
   {
      "text":"My team discovered that there was little-to-no information that answered the question, “Is my contractor licensed?” Therefore, we decided to create some pages that would provide this information."
   }
]

You can see that everything before start_index remains the same in all of the suggestions.

Retail product descriptions (short style and context use)

Writing product descriptions requires understanding your customers' needs and communicating the features and benefits of your product in an engaging, informative, and compelling manner. Also, as a copywriter, they need to keep a consistent tone in descriptions. On top of that, there is often a strict length restriction, which may cause multiple descriptions for the same product on different platforms. Offering your users different paraphrasing styles, such as shortening, can improve their productivity and help them provide high-quality results, all with their own voice and consistency.

See the following example for a call that combines a short style and the context feature, i.e. - paraphrase only part of the text, while maintaining the full context. Note that unlike in this table, the response will include the full text and not just the paraphrased part.


Text (full context)
This classic cotton t-shirt is made from soft, comfortable cotton and is suitable for everyday wear. In addition to providing ultimate comfort and a timeless appearance, this t-shirt has a durable ribbed neckline and a regular fit. It is available in a variety of colors so that you can wear it up or down for any occasion. It's great for running errands or dressing up for a night out.
Text to paraphrase
This classic cotton t-shirt is made from soft, comfortable cotton and is suitable for everyday wear.
Suggestions
Designed from 100% soft, comfortable cotton, this classic cotton t-shirt is ideal for everyday use and would make a stylish addition to any wardrobe.