Pick one label

Picks the best label for the text and returns the full distribution. Describe labels for better accuracy.

Send text for one result, or texts for a batch wrapped as { results: [...] }. The response carries x-input-chars (input characters) and x-input-tokens (input tokens billed for this call) headers.

Request

This endpoint expects an object.
labelslist of strings or map from strings to stringsRequired

Label names, or name -> description. Descriptions improve accuracy.

textstringOptional1-20000 characters
The text to decide about.
textslist of stringsOptional

Batch form: one result per text.

Response

Result, or { results } for a batch

ClassifyResultobject
OR
object

Errors

400
Bad Request Error
502
Bad Gateway Error