whisk-api

An unofficial TypeScript/JavaScript API wrapper for Google Labs' Whisk image generation platform.

Features

• Image Generation: Create high-quality images from text prompts
• Image Refinement: Enhance and modify existing generated images
• Project Management: Organize generations into projects with full CRUD operations
• Media Management: Access generation history and download images
• Multiple Models: Support for various Imagen models with different capabilities
• Type Safety: Full TypeScript support with comprehensive type definitions

Installation

bun i whisk-api
# or
npm i whisk-api

Quick Start

import Whisk from 'whisk-api';

const whisk = new Whisk({
  cookie: "your_google_labs_cookie_here"
});

// Generate an image
const result = await whisk.generateImage({
  prompt: "A serene mountain landscape at sunset"
});

if (result.Ok) {
  const imageData = result.Ok.imagePanels[0]?.generatedImages[0]?.encodedImage;
  whisk.saveImage(imageData, "mountain_sunset.png");
}

Authentication

You'll need to obtain your Google Labs session cookie:

1. Visit labs.google/fx/tools/whisk
2. Open browser developer tools (F12)
3. Go to Application/Storage → Cookies
4. Copy the cookie value and use it in your configuration

Supported Models

Examples

The library includes comprehensive examples in the examples/ directory:

• Getting authorization tokens
• Checking credit status
• Creating projects
• Managing project history
• Project content management
• Deleting projects
• Renaming projects
• Image generation history
• Saving images
• Basic image generation
• Image refinement

API Reference

Core Methods

• generateImage(prompt) - Generate images from text prompts
• refineImage(refinementRequest) - Refine existing images with new prompts
• getProjectHistory(limit) - Retrieve project history
• getImageHistory(limit) - Retrieve image generation history
• getNewProjectId(title) - Create new projects
• deleteProjects(projectIds) - Delete multiple projects
• renameProject(newName, projectId) - Rename existing projects
• saveImage(base64Data, fileName) - Save images to disk
• getAuthorizationToken() - Generate authentication tokens

Response Format

All methods return a Result<T> type with either:

• Ok: Contains the successful response data
• Err: Contains error information

const result = await whisk.generateImage({ prompt: "example" });
if (result.Err) {
  console.error("Generation failed:", result.Err);
} else {
  console.log("Success:", result.Ok);
}

Development

# Install dependencies
bun install

# Run tests
bun test

# Set up environment
export COOKIE="your_cookie_here"

Testing

The test suite requires a valid Google Labs cookie. Set the COOKIE environment variable and run:

bun test

Limitations

• Requires valid Google Labs authentication
• Rate limiting applies based on Google's policies
• Regional availability may vary
• Unofficial API subject to changes

Contributing

Contributions are welcome. Please ensure all tests pass and follow the existing code style.

License

This project is for educational and research purposes. Please respect Google's terms of service when using this library.

Disclaimer

This is an unofficial API wrapper and is not affiliated with Google. Use at your own risk and ensure compliance with Google's terms of service.