GET
/v1/schemas/cohere/chat/v1/summarize
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source tracee567cbddb2cc3cbd6a156ba9d74213895fc4e6df55d489d401327ed177ab803b{
"fetchedAt": 1786771957,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
7 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| text* | string | The text to generate a summary for. Can be up to 100,000 characters long. Currently the only supported language is English. | length ≥ 250 · length ≤ 50000 |
| length | enum | 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. | short | medium | long · default: "medium" |
| format | enum | 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. | paragraph | bullets · default: "paragraph" |
| model | string | 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… | |
| extractiveness | enum | 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 mo… | low | medium | high · default: "low" |
| temperature | number | 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. | 0 ≤ n ≤ 5 · default: 0.3 |
| additional_command | string | 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" |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"cohere","endpointId":"v1/summarize","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}