Document video_memory for GPU browsers

Author: yummybomb

browsers/gpu-acceleration.mdx

@@ -59,9 +59,9 @@ func main() {
 
 You can also enable GPU acceleration in the dashboard when deploying a browser under **Advanced Configuration**.
 
-## Large GPU browsers
+## Request more video memory
 
-A standard GPU browser runs with 4 vCPUs, 6 GiB of memory, and a 2 GiB vGPU frame buffer. For graphics-heavy pages, request the large GPU browser by setting `memory` to `12GiB`. It doubles CPU, memory, and frame buffer: 8 vCPUs, 12 GiB of memory, and a 4 GiB frame buffer.
+A GPU browser gets 2 GiB of video memory by default, with 4 vCPUs and 6 GiB of memory. For WebGL scenes, large canvases, or video that run out of video memory, set `video_memory` to `4GiB`. That browser gets 4 GiB of video memory, 8 vCPUs, and 12 GiB of memory.
 
 <CodeGroup>
 ```typescript Typescript/Javascript
@@ -71,7 +71,7 @@ const kernel = new Kernel();
 
 const kernelBrowser = await kernel.browsers.create({
   gpu: true,
-  memory: '12GiB',
+  video_memory: '4GiB',
 });
 ```
 
@@ -82,7 +82,7 @@ kernel = Kernel()
 
 kernel_browser = kernel.browsers.create(
     gpu=True,
-    memory="12GiB",
+    video_memory="4GiB",
 )
 ```
 
@@ -100,20 +100,26 @@ func main() {
 	client := kernel.NewClient()
 
 	kernelBrowser, err := client.Browsers.New(ctx, kernel.BrowserNewParams{
-		GPU:    kernel.Bool(true),
-		Memory: "12GiB",
+		GPU:         kernel.Bool(true),
+		VideoMemory: kernel.BrowserVideoMemory4GiB,
 	})
 	if err != nil {
 		panic(err)
 	}
 	_ = kernelBrowser
 }
 ```
+
+```bash CLI
+kernel browsers create --gpu --video-memory 4GiB
+```
 </CodeGroup>
 
-`12GiB` is the only `memory` value accepted together with `gpu: true`; omit `memory` to get the standard GPU browser. The `memory` field on the browser response reports the allocation you received.
+`video_memory` requires SDK version 0.123.0 or later, or CLI version 0.47.0 or later. It accepts `2GiB` or `4GiB` and requires `gpu: true`. You can't set `memory` on a GPU browser, because `video_memory` determines its memory. The browser response includes `video_memory` and `memory`, so you can confirm the allocation you received.
+
+A browser with 4 GiB of video memory is billed for its 12 GiB of memory, so it costs twice the [standard GPU rate](/info/pricing#usage-rates).
 
-Large GPU browsers come from their own capacity. When none is available, creation fails with HTTP 529 and the `no_gpu_browsers_available` code rather than falling back to a standard GPU browser, so retry later or omit `memory` to get a standard GPU browser instead.
+These browsers come from separate capacity. If none is available, creation fails with HTTP 529 and the `no_gpu_browsers_available` code instead of falling back to 2 GiB of video memory. Retry later, or omit `video_memory` to get a standard GPU browser.
 
 ## Use cases
 

browsers/process-execution.mdx

@@ -240,7 +240,7 @@ Kernel doesn't expose a per-session memory metric in the API, CLI, or dashboard
 
 ### Read whole-session memory
 
-`free` reports the memory allocated to your browser. A headless browser gets 1 GiB; a headful, non-GPU browser gets 8 GiB by default and 16 GiB when you set `memory` on [create](/api-reference/browsers/create-a-browser-session). A GPU browser gets 6 GiB, or 12 GiB as a [large GPU browser](/browsers/gpu-acceleration#large-gpu-browsers).
+`free` reports the memory allocated to your browser. A headless browser gets 1 GiB; a headful, non-GPU browser gets 8 GiB by default and 16 GiB when you set `memory` on [create](/api-reference/browsers/create-a-browser-session). A GPU browser gets 6 GiB, or 12 GiB when you [request 4 GiB of video memory](/browsers/gpu-acceleration#request-more-video-memory).
 
 <CodeGroup>
 ```typescript Typescript/Javascript

changelog.mdx

@@ -9,6 +9,16 @@ import { YouTubeVideo } from '/snippets/youtube-video.mdx';
 For API library updates, see the [Node SDK](https://github.com/onkernel/kernel-node-sdk/blob/main/CHANGELOG.md), [Python SDK](https://github.com/onkernel/kernel-python-sdk/blob/next/CHANGELOG.md), and [Go SDK](https://github.com/onkernel/kernel-go-sdk/blob/main/CHANGELOG.md) changelogs.
 </Note>
 
+<Update label="October 9" tags={["Product", "Docs"]}>
+## Product updates
+
+- Added **`video_memory`** for [GPU browsers](/browsers/gpu-acceleration#request-more-video-memory). Set it to `4GiB` with `gpu: true` to get 4 GiB of video memory, 8 vCPUs, and 12 GiB of memory, double the default GPU browser. Available in the Node, Python, and Go SDKs from 0.123.0 and in the CLI from 0.47.0 as `--video-memory`.
+
+## Documentation updates
+
+- Documented [video memory](/browsers/gpu-acceleration#request-more-video-memory) on the GPU acceleration page and added its rate to [pricing](/info/pricing#usage-rates).
+</Update>
+
 <Update label="October 6" tags={["Product", "Docs"]}>
 ## Product updates
 

info/pricing.mdx

@@ -20,6 +20,7 @@ With Kernel, you only pay for what you use and nothing more. You don't pay for i
 | Headful browser | 0.0001333336 |
 | Headless browser | 0.0000166667 |
 | Headful browser + GPU acceleration | 0.0008000016 |
+| Headful browser + GPU acceleration, [4 GiB video memory](/browsers/gpu-acceleration#request-more-video-memory) | 0.0016000032 |
 | App invocation | 0.0000666668 |
 
 > Included monthly credits apply to usage costs only.