# FlexiClass

Text classification into caller-defined categories. Use the origin of this URL as the API base URL.

## Documentation

- [Overview](/human): product explanation and checked examples.
- [Integration guide](/clanker.md): complete Markdown instructions, Python CSV workflow, batching and failures.
- [OpenAPI schema](/openapi.json): authoritative request/response schema and configured limits.
- [Python client](/clanker/client.py): standard-library batch helper; save as classify_rows.py.
- [Browser guide](/clanker): readable HTML when Accept is text/html.
- [Interactive reference](/docs): explore and try API calls.

## Access

The operator supplies FLEXICLASS_API_KEY. In protected mode, send Authorization: Bearer <FLEXICLASS_API_KEY> when fetching the guide, schema or client. Use Accept: text/plain for the Python client. Never put credentials in URLs or source code. A 401 response means credentials are missing or invalid, not that the file is absent.

## Start

Read the integration guide and schema before writing code. POST /v1/classify accepts one text or a texts list sharing labels and a task. Group rows with the same task, preserve IDs locally and inspect every result status. Use choice for one label or softmax for candidate scores.