> ## Documentation Index
> Fetch the complete documentation index at: https://pulze.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Labels

Custom labels at Pulze.ai are an extension of the label concept that allow you to add specific identifiers to your requests via Headers. These custom labels can be anything of your choosing and can be attached to any request, no matter the model being used. This flexibility makes custom labels a powerful tool for managing and analyzing your requests.

> Note: Labels will be saved as a lowercased `Dict[str, str]`. Any other variable types or extra nesting will be stringified using Python's `str()` method.

Just as you would with OpenAI's user ID, custom labels can be used to identify unique users or applications. This can be particularly useful for monitoring usage and identifying potential abuse. By hashing a user's username or email address, you can create unique identifiers without revealing any personally identifiable information.

***

If you are sending [`Pulze-Weights`](/features/custom-headers/weights) as well, but would like to store the values differently,
you can override that by sending keys with the format `weights_*`.
Whereas the `Pulze-Weights` will still decide which models get selected for you, the `weights` you send here
are the ones that will be stored.

The same applies to [`Pulze-Policies`](/features/custom-headers/policies):

<CodeGroup>
  ```bash Weights with "weights_*" name theme={null}
  curl ...
  -H ...
  -H "Pulze-Weights: {\"cost\": 0.2, \"quality\": 0.8, \"latency\": 0.2}"\
  -H "Pulze-Labels: {\"type\": \"test\", \"weights_cost\": \"very cheap\", \"weights_latency\": \"fast\", \"weights_quality\": 0.8}"\
  ...
  ```

  ```bash Policies with "policies_*" name theme={null}
  curl ...
  -H ...
  -H "Pulze-Policies: {\"max_retries\": 1234}"\
  -H "Pulze-Labels: {\"type\": \"test\", \"policies_max_retries\": \"Too many!\", \"policies_max_cost\": \"ENV_MAX_COST\"}"\
  ...
  ```
</CodeGroup>

<Snippet file="request-example-weights-labels-policies.mdx" />