Summarize

POST

This API is marked as “Legacy” and is no longer maintained. Follow the migration guide to start using the Chat API.

Generates a summary in English for a given text.

Headers

X-Client-NamestringOptional

The name of the project that is making the request.

Request

This endpoint expects an object.
textstringRequired

The text to generate a summary for. Can be up to 100,000 characters long. Currently the only supported language is English.

lengthenumOptionalDefaults to medium
Allowed values: shortmediumlong

One of short, medium, long, or auto defaults to auto. Indicates the approximate length of the summary. If auto is selected, the best option will be picked based on the input text.

format"paragraph" or "bullets"OptionalDefaults to paragraph
Allowed values: paragraphbullets

One of paragraph, bullets, or auto, defaults to auto. Indicates the style in which the summary will be delivered - in a free form paragraph or in bullet points. If auto is selected, the best option will be picked based on the input text.

modelstringOptional

The identifier of the model to generate the summary with. Currently available models are command (default), command-nightly (experimental), command-light, and command-light-nightly (experimental). Smaller, “light” models are faster, while larger models will perform better.

extractivenessenumOptionalDefaults to low
Allowed values: lowmediumhigh

One of low, medium, high, or auto, defaults to auto. Controls how close to the original text the summary is. high extractiveness summaries will lean towards reusing sentences verbatim, while low extractiveness summaries will tend to paraphrase more. If auto is selected, the best option will be picked based on the input text.

temperaturedoubleOptional

Ranges from 0 to 5. Controls the randomness of the output. Lower values tend to generate more “predictable” output, while higher values tend to generate more “creative” output. The sweet spot is typically between 0 and 1.

additional_commandstringOptional

A free-form instruction for modifying how the summaries get generated. Should complete the sentence “Generate a summary _“. Eg. “focusing on the next steps” or “written by Yoda”

Response

OK

idstringOptional

Generated ID for the summary

summarystringOptional

Generated summary for the text

metaobjectOptional