Zorveus LogoZorveusDOCS

Product-User Metadata

Pass custom customer identifiers, names, emails, and tracking tags inside inference requests.

Product-User Metadata

Zorveus allows product teams to embed end-user context directly inside OpenAI-compatible requests for real-time attribution, metering, and credit deduction.

Inference Key TesterInteractive
Paste your Zorveus key to dynamically update all code snippets below.

Supported Metadata Fields

Inside metadata (or extra_body.metadata in Python):

FieldTypeDescription
external_user_idstringPrimary external customer ID in your database (e.g. usr_98124).
product_user_idstringOptional Zorveus internal product user UUID.
namestringUser's display name for dashboard identification.
emailstringUser's email address for audit and search.
planstringCustom subscription or customer tier name (e.g. enterprise_seat).

Code Example

from openai import OpenAI

client = OpenAI(
    base_url="https://api.zorveus.com/v1",
    api_key="zrv_your_inference_key",
)

response = client.chat.completions.create(
    model="openai/gpt-4.1-mini",
    messages=[{"role": "user", "content": "Generate 3 taglines for an electric bicycle."}],
    extra_body={
        "metadata": {
            "external_user_id": "cust_uuid_9921",
            "name": "Alex Mercer",
            "email": "alex.mercer@company.io",
            "plan": "pro_tier",
        }
    },
)

print(response.choices[0].message.content)
Was this page helpful?
Edit this page on GitHub

On this page