> ## Documentation Index
> Fetch the complete documentation index at: https://jigsaw-13.mintlify.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Window.ai
> How to integrate JigsawStack with the window.ai API for browser-based AI capabilities
Explore our complete list of models and API references here.
## Overview
The `window.ai` Chrome API introduces native AI capabilities that run locally within the browser environment. While Chrome's native implementation is still in its early stages (available in Chrome Canary) with limited capabilities, **JigsawStack extends this concept** by providing a comprehensive suite of powerful AI utilities through the same familiar interface.
By integrating JigsawStack with the `window.ai` object, you can:
* Provide consistent AI capabilities across all browsers
* Access advanced AI features beyond what's natively available
* Create seamless browser-based AI experiences for your users
## Prerequisites
Before integrating JigsawStack with window\.ai, you'll need:
* A [JigsawStack account](https://jigsawstack.com/dashboard)
* Your JigsawStack [Public API key](https://jigsawstack.com/dashboard)
For client-side browser integration, always use your `public key` instead of your secret key.
You can enhance security by restricting the `public key` to specific APIs or domains.
Learn more about [public vs. secret API keys](/docs/api-reference/authentication#public-and-secret-api-keys).
## Integration
### Basic Setup
Add JigsawStack to your browser application and assign it to the window\.ai object:
```javascript theme={null}
// Import JigsawStack in a module environment
import { JigsawStack } from "jigsawstack";
// Initialize with your public key
const jigsawstack = JigsawStack({
apiKey: "pk_fecc....92je9" // Use your public key here
});
// Assign to window.ai
window.ai = jigsawstack;
```
For script tag inclusion:
```html theme={null}
```
### TypeScript Support
For TypeScript projects, add proper typing for the window\.ai object:
```typescript theme={null}
// index.d.ts or types.d.ts
import type { JigsawStack } from "jigsawstack";
declare global {
interface Window {
ai: ReturnType;
}
}
export {};
```
## Using window\.ai
Once integrated, you can access all JigsawStack capabilities through the window\.ai object:
### Sentiment Analysis
```javascript theme={null}
// Analyze sentiment with a simple call
const sentiment = await window.ai.sentiment("I love how easy it is to get started");
console.log(sentiment); // { sentiment: "positive", score: 0.92 }
```
### Text Translation
```javascript theme={null}
// Translate text between languages
const translation = await window.ai.translate({
text: "Hello, world!",
targetLang: "es"
});
console.log(translation); // "¡Hola, mundo!"
```
### Text Summarization
```javascript theme={null}
// Generate a summary of longer text
const summary = await window.ai.summary({
text: "Long article or document content here...",
maxLength: 100
});
console.log(summary); // Concise summary of the text
```
### Image Generation
```javascript theme={null}
// Generate an image from a text prompt
const image = await window.ai.image_generation({
prompt: "A serene mountain landscape with a lake"
});
document.getElementById('generatedImage').src = image.url;
```
## Complete Example
Here's a complete example showing how to integrate JigsawStack with window\.ai in a web application:
```html theme={null}
JigsawStack window.ai Demo
JigsawStack window.ai Demo
```
## Fallback Strategy
To create a resilient application that works with both native window\.ai (when available) and JigsawStack:
```javascript theme={null}
// Check if native window.ai exists, otherwise use JigsawStack
if (!window.ai) {
const jigsawstack = JigsawStack({ apiKey: "pk_fecc....92je9" });
window.ai = jigsawstack;
}
// Now you can use window.ai safely
const result = await window.ai.sentiment("Your text here");
```
## Browser Compatibility
JigsawStack's window\.ai integration works across all major browsers:
* Chrome
* Firefox
* Safari
* Edge
* Opera
This provides consistent AI capabilities regardless of native browser AI support.