Overview

Summarizes the provided text from that text only, without adding additional information available during the model pre-training. Responses are in 1-2 sentence snippets.

Optionally add a free-text focus topic, which will limit the summary to information in the source material about the requested topic.


Examples

from ai21 import AI21Client
client = AI21Client(api_key=<<AI21_API_KEY>>)

def summarize():
    response = client.summarize.create(
        source="https://en.wikipedia.org/wiki/Blue_whale",
        source_type="URL",
        focus="interbreeding"
    )
    print(response.summary
    
# Response
Blue whales are closely related to sei whales, with gene flow between minke whales and blue whales.
Blue whales are known to interbreed with fin whales. A 21-meter (70 ft) pregnant female whale caught off Iceland in 1986 was found to have a blue whale mother and a fin whale father, and its fetus was sired by a blue whale.
In 2024, a genome analysis of North Atlantic blue whales found that 3.5% of their genome was derived from hybridization with fin whales.
Chilean blue whales may overlap with Antarctica blue whales and Eastern North Pacific blue whales in the Eastern Tropical Pacific.
ROOT_URL = "https://api.ai21.com/studio/v1/"   
 
def summarize():
  url = ROOT_URL + "summarize"
  response = requests.post(
      url,
      headers={"Authorization": f"Bearer {AI21_API_KEY}"},
      json={
        "source":"https://en.wikipedia.org/wiki/Blue_whale",
        "sourceType":"URL",
        "focus":"interbreeding"
      }
  )
  print(response.json()["summary"])

# Response
Blue whales are closely related to sei whales and have significant gene flow with minke whales.
Blue whales are known to interbreed with fin whales. A 21-meter (70 ft) pregnant female whale caught off Iceland in 1986 had a blue whale mother and a fin whale father, and its fetus was sired by a blue whale.
In 2024, a genome analysis of North Atlantic blue whales found that 3.5% of their genome was derived from hybridization with fin whales.
Chilean blue whales may overlap with Antarctica blue whales and Eastern North Pacific blue whales in the Eastern Tropical Pacific.
Language
Authorization
Header