GetGenerationData Type | OpenRouter TypeScript SDK | OpenRouter

The TypeScript SDK and docs are currently in beta. Report issues on GitHub.

Generation data

Example Usage

1 import { GetGenerationData } from "@openrouter/sdk/models/operations";
2 
3 let value: GetGenerationData = {
4   apiType: "embeddings",
5   appId: 12345,
6   cacheDiscount: 0.0002,
7   cancelled: false,
8   createdAt: "2024-07-15T23:33:19.433273+00:00",
9   externalUser: "user-123",
10   finishReason: "stop",
11   generationTime: 1200,
12   httpReferer: "<value>",
13   id: "gen-3bhGkxlo4XFrqiabUM7NDtwDzWwG",
14   isByok: false,
15   latency: 1250,
16   model: "sao10k/l3-stheno-8b",
17   moderationLatency: 50,
18   nativeFinishReason: "stop",
19   nativeTokensCached: 3,
20   nativeTokensCompletion: 25,
21   nativeTokensCompletionImages: 0,
22   nativeTokensPrompt: 10,
23   nativeTokensReasoning: 5,
24   numInputAudioPrompt: 0,
25   numMediaCompletion: 0,
26   numMediaPrompt: 1,
27   numSearchResults: 5,
28   origin: "https://openrouter.ai/",
29   providerName: "Infermatic",
30   providerResponses: [
31     {
32       status: 200,
33     },
34   ],
35   router: "openrouter/auto",
36   streamed: true,
37   tokensCompletion: 25,
38   tokensPrompt: 10,
39   totalCost: 0.0015,
40   upstreamId: "chatcmpl-791bcf62-080e-4568-87d0-94c72e3b4946",
41   upstreamInferenceCost: 0.0012,
42   usage: 0.0015,
43   userAgent: "<value>",
44 };

Fields

Field	Type	Required	Description	Example
`apiType`	operations.ApiType	✔️	Type of API used for the generation
`appId`	number	✔️	ID of the app that made the request	12345
`cacheDiscount`	number	✔️	Discount applied due to caching	0.0002
`cancelled`	boolean	✔️	Whether the generation was cancelled	false
`createdAt`	string	✔️	ISO 8601 timestamp of when the generation was created	2024-07-15T23:33:19.433273+00:00
`externalUser`	string	✔️	External user identifier	user-123
`finishReason`	string	✔️	Reason the generation finished	stop
`generationTime`	number	✔️	Time taken for generation in milliseconds	1200
`httpReferer`	string	✔️	Referer header from the request
`id`	string	✔️	Unique identifier for the generation	gen-3bhGkxlo4XFrqiabUM7NDtwDzWwG
`isByok`	boolean	✔️	Whether this used bring-your-own-key	false
`latency`	number	✔️	Total latency in milliseconds	1250
`model`	string	✔️	Model used for the generation	sao10k/l3-stheno-8b
`moderationLatency`	number	✔️	Moderation latency in milliseconds	50
`nativeFinishReason`	string	✔️	Native finish reason as reported by provider	stop
`nativeTokensCached`	number	✔️	Native cached tokens as reported by provider	3
`nativeTokensCompletion`	number	✔️	Native completion tokens as reported by provider	25
`nativeTokensCompletionImages`	number	✔️	Native completion image tokens as reported by provider	0
`nativeTokensPrompt`	number	✔️	Native prompt tokens as reported by provider	10
`nativeTokensReasoning`	number	✔️	Native reasoning tokens as reported by provider	5
`numInputAudioPrompt`	number	✔️	Number of audio inputs in the prompt	0
`numMediaCompletion`	number	✔️	Number of media items in the completion	0
`numMediaPrompt`	number	✔️	Number of media items in the prompt	1
`numSearchResults`	number	✔️	Number of search results included	5
`origin`	string	✔️	Origin URL of the request	https://openrouter.ai/
`providerName`	string	✔️	Name of the provider that served the request	Infermatic
`providerResponses`	models.ProviderResponse[]	✔️	List of provider responses for this generation, including fallback attempts
`requestId`	string	➖	Unique identifier grouping all generations from a single API request	req-1727282430-aBcDeFgHiJkLmNoPqRsT
`router`	string	✔️	Router used for the request (e.g., openrouter/auto)	openrouter/auto
`sessionId`	string	➖	Session identifier grouping multiple generations in the same session
`streamed`	boolean	✔️	Whether the response was streamed	true
`tokensCompletion`	number	✔️	Number of tokens in the completion	25
`tokensPrompt`	number	✔️	Number of tokens in the prompt	10
`totalCost`	number	✔️	Total cost of the generation in USD	0.0015
`upstreamId`	string	✔️	Upstream provider’s identifier for this generation	chatcmpl-791bcf62-080e-4568-87d0-94c72e3b4946
`upstreamInferenceCost`	number	✔️	Cost charged by the upstream provider	0.0012
`usage`	number	✔️	Usage amount in USD	0.0015
`userAgent`	string	✔️	User-Agent header from the request