[AI Gateway] Add documentation for Fal AI

Author: Rishit Bansal

src/content/docs/ai-gateway/usage/providers/fal.mdx

@@ -0,0 +1,91 @@
+---
+title: Fal AI
+pcx_content_type: get-started
+---
+
+[Fal AI](https://fal.ai/) provides access to 600+ production-ready generative media models through a single, unified API. The service offers the world's largest collection of open image, video, voice, and audio generation models, all accessible with one line of code.
+
+## Endpoint
+
+```txt
+https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/fal
+```
+
+## URL structure
+
+When making requests to Fal AI, replace `https://fal.run` in the URL you're currently using with `https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/fal`.
+
+## Prerequisites
+
+When making requests to Fal AI, ensure you have the following:
+
+- Your AI Gateway Account ID.
+- Your AI Gateway gateway name.
+- An active Fal AI API token.
+- The name of the Fal AI model you want to use.
+
+## Default synchronous API
+
+By default, requests to the Fal AI endpoint will hit the synchronous API at `https://fal.run/<path>`.
+
+### cURL example
+
+```bash
+curl https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/fal/fal-ai/fast-sdxl \
+  --header 'Authorization: Key {fal_ai_token}' \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "prompt": "Make an image of a cat flying an aeroplane"
+  }'
+```
+
+## Custom target URLs
+
+If you need to hit a different target URL, you can supply the entire Fal target URL in the `x-fal-target-url` header.
+
+### cURL example with custom target URL
+
+```bash
+curl https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/fal \
+  --header 'Authorization: Bearer {fal_ai_token}' \
+  --header 'x-fal-target-url: https://queue.fal.run/fal-ai/bytedance/seedream/v4/edit' \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "prompt": "Dress the model in the clothes and hat. Add a cat to the scene and change the background to a Victorian era building.",
+    "image_urls": [
+      "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_1.png",
+      "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_2.png",
+      "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_3.png",
+      "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_4.png"
+    ]
+  }'
+```
+
+## JavaScript SDK integration
+
+The `x-fal-target-url` format is compliant with the Fal SDKs, so AI Gateway can be easily passed as a `proxyUrl` in the SDKs.
+
+### JavaScript SDK example
+
+```js
+import { fal } from "@fal-ai/client";
+
+fal.config({
+  credentials: "{fal_ai_token}",
+  proxyUrl: "https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/fal"
+});
+
+const result = await fal.subscribe("fal-ai/bytedance/seedream/v4/edit", {
+  "input": {
+    "prompt": "Dress the model in the clothes and hat. Add a cat to the scene and change the background to a Victorian era building.",
+    "image_urls": [
+      "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_1.png",
+      "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_2.png",
+      "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_3.png",
+      "https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_4.png"
+    ]
+  }
+});
+
+console.log(result.data.images[0]);
+```

src/content/docs/ai-gateway/usage/websockets-api/realtime-api.mdx

@@ -13,6 +13,7 @@ Some AI providers support real-time, low-latency interactions over WebSockets. A
 - [Google AI Studio](https://ai.google.dev/gemini-api/docs/multimodal-live)
 - [Cartesia](https://docs.cartesia.ai/api-reference/tts/tts)
 - [ElevenLabs](https://elevenlabs.io/docs/conversational-ai/api-reference/conversational-ai/websocket)
+- [Fal AI](https://docs.fal.ai/model-apis/model-endpoints/websockets)
 
 ## Authentication
 
@@ -21,6 +22,10 @@ For real-time WebSockets, authentication can be done using:
 - Headers (for non-browser environments)
 - `sec-websocket-protocol` (for browsers)
 
+:::note
+Provider specific API Keys can also be alternatively configured on AI Gateway using our [BYOK](/ai-gateway/configuration/bring-your-own-keys) feature. You must still include the `cf-aig-authorization` header in the websocket request.
+:::
+
 ## Examples
 
 ### OpenAI
@@ -131,3 +136,30 @@ ws.send(
 	}),
 );
 ```
+
+### Fal AI
+
+Fal AI supports WebSocket connections for real-time model interactions through their HTTP over WebSocket API.
+
+```javascript
+const ws = new WebSocket(
+	"wss://gateway.ai.cloudflare.com/v1/<account_id>/<gateway>/fal/fal-ai/fast-lcm-diffusion",
+	["fal-api-key.<fal_api_key>", "cf-aig-authorization.<cloudflare_token>"],
+);
+
+ws.on("open", function open() {
+	console.log("Connected to server.");
+});
+
+ws.on("message", function incoming(message) {
+	console.log(message.data);
+});
+
+ws.send(
+	JSON.stringify({
+		prompt: "generate an image of a cat flying an aeroplane",
+	}),
+);
+```
+
+For more information on Fal AI's WebSocket API, see their [HTTP over WebSocket documentation](https://docs.fal.ai/model-apis/model-endpoints/websockets).