Skip to main content
The Python SDK and docs are currently in beta. Report issues on GitHub.
Generation data

Fields

FieldTypeRequiredDescriptionExample
api_typeNullable[components.APIType]:heavy_check_mark:Type of API used for the generation
app_idNullable[int]:heavy_check_mark:ID of the app that made the request12345
cache_discountNullable[float]:heavy_check_mark:Discount applied due to caching0.0002
cancelledNullable[bool]:heavy_check_mark:Whether the generation was cancelledfalse
created_atstr:heavy_check_mark:ISO 8601 timestamp of when the generation was created2024-07-15T23:33:19.433273+00:00
external_userNullable[str]:heavy_check_mark:External user identifieruser-123
finish_reasonNullable[str]:heavy_check_mark:Reason the generation finishedstop
generation_timeNullable[float]:heavy_check_mark:Time taken for generation in milliseconds1200
http_refererNullable[str]:heavy_check_mark:Referer header from the request
idstr:heavy_check_mark:Unique identifier for the generationgen-3bhGkxlo4XFrqiabUM7NDtwDzWwG
is_byokbool:heavy_check_mark:Whether this used bring-your-own-keyfalse
latencyNullable[float]:heavy_check_mark:Total latency in milliseconds1250
modelstr:heavy_check_mark:Model used for the generationsao10k/l3-stheno-8b
moderation_latencyNullable[float]:heavy_check_mark:Moderation latency in milliseconds50
native_finish_reasonNullable[str]:heavy_check_mark:Native finish reason as reported by providerstop
native_tokens_cachedNullable[int]:heavy_check_mark:Native cached tokens as reported by provider3
native_tokens_completionNullable[int]:heavy_check_mark:Native completion tokens as reported by provider25
native_tokens_completion_imagesNullable[int]:heavy_check_mark:Native completion image tokens as reported by provider0
native_tokens_promptNullable[int]:heavy_check_mark:Native prompt tokens as reported by provider10
native_tokens_reasoningNullable[int]:heavy_check_mark:Native reasoning tokens as reported by provider5
num_fetchesNullable[int]:heavy_check_mark:Number of web fetches performed0
num_input_audio_promptNullable[int]:heavy_check_mark:Number of audio inputs in the prompt0
num_media_completionNullable[int]:heavy_check_mark:Number of media items in the completion0
num_media_promptNullable[int]:heavy_check_mark:Number of media items in the prompt1
num_search_resultsNullable[int]:heavy_check_mark:Number of search results included5
originstr:heavy_check_mark:Origin URL of the requesthttps://openrouter.ai/
preset_idNullable[str]:heavy_check_mark:ID of the preset used for this generation, null if no preset was useda9e8d400-592a-494f-908c-375efa66cafd
provider_nameNullable[str]:heavy_check_mark:Name of the provider that served the requestInfermatic
provider_responsesList[components.ProviderResponse]:heavy_check_mark:List of provider responses for this generation, including fallback attempts
request_idOptionalNullable[str]:heavy_minus_sign:Unique identifier grouping all generations from a single API requestreq-1727282430-aBcDeFgHiJkLmNoPqRsT
response_cache_source_idOptionalNullable[str]:heavy_minus_sign:If this generation was served from response cache, contains the original generation ID. Null otherwise.
routerNullable[str]:heavy_check_mark:Router used for the request (e.g., openrouter/auto)openrouter/auto
service_tierNullable[str]:heavy_check_mark:Service tier the upstream provider reported running this request on, or null if it did not report one.priority
session_idOptionalNullable[str]:heavy_minus_sign:Session identifier grouping multiple generations in the same session
streamedNullable[bool]:heavy_check_mark:Whether the response was streamedtrue
tokens_completionNullable[int]:heavy_check_mark:Number of tokens in the completion25
tokens_promptNullable[int]:heavy_check_mark:Number of tokens in the prompt10
total_costfloat:heavy_check_mark:Total cost of the generation in USD0.0015
upstream_idNullable[str]:heavy_check_mark:Upstream provider’s identifier for this generationchatcmpl-791bcf62-080e-4568-87d0-94c72e3b4946
upstream_inference_costNullable[float]:heavy_check_mark:Cost charged by the upstream provider0.0012
usagefloat:heavy_check_mark:Usage amount in USD0.0015
user_agentNullable[str]:heavy_check_mark:User-Agent header from the request
web_search_engineNullable[str]:heavy_check_mark:The resolved web search engine used for this generation (e.g. exa, firecrawl, parallel)exa