Custom properties
Helicone allows you to tag requests with any information you choose to segment, analyze, and visualize by
Custom Properties allow you to add any additional information to your requests, such as:
- The session, conversation, or app id
- The prompt chain by adding a common value to group of requests
- Application or user metadata making the request
- Get the the total cost or latency for a group of requests in a prompt chain
- Get the "unit economics" of your application, such as the average cost of a conversation or session
- Slice and dice your requests and metrics by any custom property
Custom properties are added with headers to your OpenAI requests. For each header,
- The Key is
Helicone-Property-{Name}with your property name inName - The Value is the string value for the property in the request.
Curl
Python
Node.js
curl https://oai.hconeai.com/v1/completions \
-H 'Content-Type: application/json' \
-H 'Helicone-Auth: Bearer HELICONE_API_KEY' \
-H 'Helicone-Property-Session: "24"' \
-H 'Helicone-Property-Conversation: "support_issue_2"' \
-H 'Helicone-Property-App: "mobile"'
-d ...
openai.api_base = "https://oai.hconeai.com/v1"
openai
openai.Completion.create(
model="text-davinci-003",
prompt="Say this is a test",
headers={
"Helicone-Auth": "Bearer HELICONE_API_KEY"
"Helicone-Property-Session": "24",
"Helicone-Property-Conversation": "support_issue_2",
"Helicone-Property-App": "mobile",
}
)
import { Configuration, OpenAIApi } from "openai";
const configuration = new Configuration({
apiKey: process.env.OPENAI_API_KEY,
basePath: "https://oai.hconeai.com/v1",
baseOptions: {
headers: {
"Helicone-Auth": "Bearer HELICONE_API_KEY"
"Helicone-Property-Session": "24",
"Helicone-Property-Conversation": "support_issue_2",
"Helicone-Property-App": "mobile",
},
},
});
const openai = new OpenAIApi(configuration);
Last modified 1mo ago