# GetGenerationData

Generation data


## Fields

| Field                                                                       | Type                                                                        | Required                                                                    | Description                                                                 | Example                                                                     |
| --------------------------------------------------------------------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| `api_type`                                                                  | [Nullable[operations.APIType]](../operations/apitype.md)                    | :heavy_check_mark:                                                          | Type of API used for the generation                                         |                                                                             |
| `app_id`                                                                    | *Nullable[int]*                                                             | :heavy_check_mark:                                                          | ID of the app that made the request                                         | 12345                                                                       |
| `cache_discount`                                                            | *Nullable[float]*                                                           | :heavy_check_mark:                                                          | Discount applied due to caching                                             | 0.0002                                                                      |
| `cancelled`                                                                 | *Nullable[bool]*                                                            | :heavy_check_mark:                                                          | Whether the generation was cancelled                                        | false                                                                       |
| `created_at`                                                                | *str*                                                                       | :heavy_check_mark:                                                          | ISO 8601 timestamp of when the generation was created                       | 2024-07-15T23:33:19.433273+00:00                                            |
| `external_user`                                                             | *Nullable[str]*                                                             | :heavy_check_mark:                                                          | External user identifier                                                    | user-123                                                                    |
| `finish_reason`                                                             | *Nullable[str]*                                                             | :heavy_check_mark:                                                          | Reason the generation finished                                              | stop                                                                        |
| `generation_time`                                                           | *Nullable[float]*                                                           | :heavy_check_mark:                                                          | Time taken for generation in milliseconds                                   | 1200                                                                        |
| `http_referer`                                                              | *Nullable[str]*                                                             | :heavy_check_mark:                                                          | Referer header from the request                                             |                                                                             |
| `id`                                                                        | *str*                                                                       | :heavy_check_mark:                                                          | Unique identifier for the generation                                        | gen-3bhGkxlo4XFrqiabUM7NDtwDzWwG                                            |
| `is_byok`                                                                   | *bool*                                                                      | :heavy_check_mark:                                                          | Whether this used bring-your-own-key                                        | false                                                                       |
| `latency`                                                                   | *Nullable[float]*                                                           | :heavy_check_mark:                                                          | Total latency in milliseconds                                               | 1250                                                                        |
| `model`                                                                     | *str*                                                                       | :heavy_check_mark:                                                          | Model used for the generation                                               | sao10k/l3-stheno-8b                                                         |
| `moderation_latency`                                                        | *Nullable[float]*                                                           | :heavy_check_mark:                                                          | Moderation latency in milliseconds                                          | 50                                                                          |
| `native_finish_reason`                                                      | *Nullable[str]*                                                             | :heavy_check_mark:                                                          | Native finish reason as reported by provider                                | stop                                                                        |
| `native_tokens_cached`                                                      | *Nullable[int]*                                                             | :heavy_check_mark:                                                          | Native cached tokens as reported by provider                                | 3                                                                           |
| `native_tokens_completion`                                                  | *Nullable[int]*                                                             | :heavy_check_mark:                                                          | Native completion tokens as reported by provider                            | 25                                                                          |
| `native_tokens_completion_images`                                           | *Nullable[int]*                                                             | :heavy_check_mark:                                                          | Native completion image tokens as reported by provider                      | 0                                                                           |
| `native_tokens_prompt`                                                      | *Nullable[int]*                                                             | :heavy_check_mark:                                                          | Native prompt tokens as reported by provider                                | 10                                                                          |
| `native_tokens_reasoning`                                                   | *Nullable[int]*                                                             | :heavy_check_mark:                                                          | Native reasoning tokens as reported by provider                             | 5                                                                           |
| `num_input_audio_prompt`                                                    | *Nullable[int]*                                                             | :heavy_check_mark:                                                          | Number of audio inputs in the prompt                                        | 0                                                                           |
| `num_media_completion`                                                      | *Nullable[int]*                                                             | :heavy_check_mark:                                                          | Number of media items in the completion                                     | 0                                                                           |
| `num_media_prompt`                                                          | *Nullable[int]*                                                             | :heavy_check_mark:                                                          | Number of media items in the prompt                                         | 1                                                                           |
| `num_search_results`                                                        | *Nullable[int]*                                                             | :heavy_check_mark:                                                          | Number of search results included                                           | 5                                                                           |
| `origin`                                                                    | *str*                                                                       | :heavy_check_mark:                                                          | Origin URL of the request                                                   | https://openrouter.ai/                                                      |
| `provider_name`                                                             | *Nullable[str]*                                                             | :heavy_check_mark:                                                          | Name of the provider that served the request                                | Infermatic                                                                  |
| `provider_responses`                                                        | List[[components.ProviderResponse](../components/providerresponse.md)]      | :heavy_check_mark:                                                          | List of provider responses for this generation, including fallback attempts |                                                                             |
| `request_id`                                                                | *OptionalNullable[str]*                                                     | :heavy_minus_sign:                                                          | Unique identifier grouping all generations from a single API request        | req-1727282430-aBcDeFgHiJkLmNoPqRsT                                         |
| `router`                                                                    | *Nullable[str]*                                                             | :heavy_check_mark:                                                          | Router used for the request (e.g., openrouter/auto)                         | openrouter/auto                                                             |
| `session_id`                                                                | *OptionalNullable[str]*                                                     | :heavy_minus_sign:                                                          | Session identifier grouping multiple generations in the same session        |                                                                             |
| `streamed`                                                                  | *Nullable[bool]*                                                            | :heavy_check_mark:                                                          | Whether the response was streamed                                           | true                                                                        |
| `tokens_completion`                                                         | *Nullable[int]*                                                             | :heavy_check_mark:                                                          | Number of tokens in the completion                                          | 25                                                                          |
| `tokens_prompt`                                                             | *Nullable[int]*                                                             | :heavy_check_mark:                                                          | Number of tokens in the prompt                                              | 10                                                                          |
| `total_cost`                                                                | *float*                                                                     | :heavy_check_mark:                                                          | Total cost of the generation in USD                                         | 0.0015                                                                      |
| `upstream_id`                                                               | *Nullable[str]*                                                             | :heavy_check_mark:                                                          | Upstream provider's identifier for this generation                          | chatcmpl-791bcf62-080e-4568-87d0-94c72e3b4946                               |
| `upstream_inference_cost`                                                   | *Nullable[float]*                                                           | :heavy_check_mark:                                                          | Cost charged by the upstream provider                                       | 0.0012                                                                      |
| `usage`                                                                     | *float*                                                                     | :heavy_check_mark:                                                          | Usage amount in USD                                                         | 0.0015                                                                      |
| `user_agent`                                                                | *Nullable[str]*                                                             | :heavy_check_mark:                                                          | User-Agent header from the request                                          |                                                                             |