Skip to main content

bingart is an unofficial API wrapper for Bing Image Creator (based on DALL-E 3).

Project description

🎨 bingart

bingart is an unofficial 🤫 API wrapper for Bing Image Creator (based on DALL-E 3). It allows you to programmatically generate 🖼️ AI-powered images using Bing's image creation tool.

⚠️ Warning: The _U auth cookie should be changed every 2-4 weeks for working.

💡 Description

This module uses web scraping and engineering techniques to interface with Bing's internal image creation APIs. It is not an official API client.

🔑 Key Features

  • 🖼️ Generate images by providing a text prompt
  • 📸 Get image URLs up to 4 generated images
  • 🔐 Authentication via saved Bing cookies or auto-fetched from browsers
  • ⚠️ Custom exceptions for common issues

💻 Usage

Import and instantiate the BingArt class with a valid _U cookie value:

from bingart import BingArt

bing_art = BingArt(auth_cookie_U='...')

try:
    results = bing_art.generate_images('sunset')
    print(results)
finally:
    bing_art.close_session()

Sometimes an extra cookie called KievRPSSecAuth is required for it to work properly

bing_art = BingArt(auth_cookie_U='...', auth_cookie_KievRPSSecAuth='...')

Also, you can try the auto cookie search feature

bing_art = BingArt(auto=True)

Call generate_images() with your query text:

results = bing.generate_images("a cat painting in Picasso style")

The return value contains image URLs and original prompt:

{
  "images": [
    {"url": "https://..."}
  ],
  "prompt": "a cat painting in Picasso style"
}

🚨 Exceptions

  • AuthCookieError: Invalid authentication cookie
  • PromptRejectedError: Prompt rejected as unethical

🤝 Contributing

Pull requests welcome! Please open an issue to discuss major changes.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bingart-1.0.3.tar.gz (4.7 kB view hashes)

Uploaded Source

Built Distribution

bingart-1.0.3-py3-none-any.whl (4.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page