https://github.com/david-lor/python-qqddm

Python wrapper for QQ "Different Dimension Me" AI (convert pictures into anime avatars)
https://github.com/david-lor/python-qqddm

ai anime different-dimension-me library python python3 qq scraper

Last synced: 23 days ago
JSON representation

Python wrapper for QQ "Different Dimension Me" AI (convert pictures into anime avatars)

• Host: GitHub
• URL: https://github.com/david-lor/python-qqddm
• Owner: David-Lor
• License: isc
• Created: 2022-11-30T19:10:09.000Z (almost 2 years ago)
• Default Branch: develop
• Last Pushed: 2023-01-07T16:07:38.000Z (almost 2 years ago)
• Last Synced: 2024-10-03T20:23:14.804Z (about 1 month ago)
• Topics: ai, anime, different-dimension-me, library, python, python3, qq, scraper
• Language: Python
• Homepage:
• Size: 4.5 MB
• Stars: 20
• Watchers: 1
• Forks: 2
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# QQ's "Different Dimension Me" Animefier Python library

Python wrapper for [QQ's "Different Dimension Me" AI](https://h5.tu.qq.com/web/ai-2d/cartoon/index) API, that applies an anime-theme to any given picture.

## Installing

This package was developed & tested under Python 3.9. Available on [PyPI](https://pypi.org/project/qqddm):

```bash

pip install --user qqddm

```

## Usage

Check the [example](example.py) code.

### Known issues and limitations of the API

- **Only pictures with human faces**: since 2022-12-06, the QQ's API became stricter with the pictures being converted, and requires them to have a human face.

- **Forbidden images**: the QQ's API refuses to convert images with sensible or political content.

## Changelog

Versions 0.y.z are expected to be unstable, and the library API may change on Minor (y) releases.

- 0.1.1

  - Update to the new "overseas" API, which can be used from outside China

  - Fix how images are downloaded using threads

- 0.0.3

  - Add new custom exception `ParamInvalidQQDDMApiResponseException`

  - Refactor mapping of API response codes with custom exceptions, now done programatically, defining the corresponding response code on each exception class

- 0.0.2

  - Add new `x-sign` headers required by the API since 2022-12-06.

  - Add new custom exceptions based on errors returned by the API: `VolumnLimitQQDDMApiResponseException`, `AuthFailedQQDDMApiResponseException`, `NotAllowedCountryQQDDMApiResponseException`, `NoFaceInPictureQQDDMApiResponseException`.

- 0.0.1

  - Initial release:

    - Class-based interface.

    - Pass an image (as bytes) and send it to QQ API, returning the resulting images URLs.

    - Download the returned images URLs.

    - Requests settings (different for QQ API and for downloading result images): request timeouts, proxy, user-agents.