App attribution
Identify your application on API requests for rankings and analytics.
Pipevideo supports optional attribution headers on API requests. These help attribute usage to your application in rankings and analytics — the same pattern used by OpenRouter.
Headers
| Header | Alias | Description |
|---|---|---|
HTTP-Referer | Referer | Your site or application URL |
X-Pipevideo-Title | X-Title | Human-readable application name |
All attribution headers are optional. Requests work without them.
Example
curl -X POST https://api.pipevideo.co/v1/responses \
-H "Authorization: Bearer pv_your_api_key" \
-H "Content-Type: application/json" \
-H "HTTP-Referer: https://myapp.com" \
-H "X-Pipevideo-Title: My Video App" \
-d '{
"model": "moonshotai/kimi-k2.5",
"input": "Animated intro sequence"
}'Additional headers
| Header | Description |
|---|---|
X-Application-Name | Alternative application identifier (max 256 characters) |
X-App-Name | Alias for X-Application-Name |
Validation
- Referer URLs must be valid
http://orhttps://URLs (max 2048 characters). - Title values are sanitized (control characters stripped, max 256 characters).
- Invalid values are silently ignored — they do not cause request failures.
SDK usage
When using the pipevideo SDK, pass custom headers via the fetch option or set them at the HTTP client level in your application.
Related
- OpenAI SDK compatibility — attribution headers work with OpenAI SDK
defaultHeaders