Metadata-Version: 2.1
Name: midjourney-py
Version: 1.0.3
Summary: MidjourneyPy allows developers to easily use midjourney api without complications.
Home-page: UNKNOWN
Author: Ajaga Abdulbasit (Code  Ninja)
Author-email: basitng2004@gmail.com
License: UNKNOWN
Description: 
        # Installation
        
        ```installation
        pip install midjourney-py==1.0.0
        ```
        
        # midjourney
        
        midjourney library provides a simplified and convenient way for developers to interact with the Midjourney API. With this library, developers can easily integrate Midjourney's powerful image processing capabilities into their applications without dealing with the complexities of manual API calls.
        
        ## Key Features
        
        1. _Simplified Interface_: The APIRequest class abstracts away the complexities of API
        2. _Authentication Handling_: he library handles the authentication process, ensuring that API requests are properly authenticated with the provided API key.
        3. _Endpoint Methods_: The library provides intuitive methods for each API endpoint, making it easy to perform actions such as describing images, retrieving results, upscaling images, generating images based on prompts, and generating seeds for image generation.
        4. _Response Handling_: The library processes API responses and provides them in a structured format, simplifying the integration of API results into the application workflow.
        
        ### Using the Imagine API
        
        ```python
        
        from midjourney import Midjourney
        
        midjourney = Midjourney(
            api_key="API_KEY", callback_uri="")
        
        # IMAGINE
        seed = midjourney.imagine(prompt='cute mouse with hats')
        
        result = midjourney.result(seed=seed)
        if result.get('status') == 'completed':
            response = result
            print(response)
        else:
            message = result.get('message')
            print(message)
        
        ```
        
        ### Imagine Response
        
        _Note_ the _task id_ generated will be passed to the result method to generate the imageUrl
        
        ```json
        {
          "taskId": "your_task_id"
        }
        ```
        
        when passed to the result method
        
        ```json
        {
          "status": "completed",
          "imageUrl": "https://cdn.discordapp.com/attachments/1124090271676772432/1126110757319360582/olivier_A_crying_white_kid_holding_a_blue_candy_splash_around_h_5b0a4099-f398-4118-8206-33f64c1a5589.png"
        }
        ```
        
        ### Using the Describe API
        
        Describe images using the describe api from midjourney
        
        ```python
        
        from midjourney import Midjourney
        
        
        midjourney = Midjourney(
            api_key="API_KEY", callback_uri="")
        
        seed = midjourney.describe(
            image_path=r"C:\Users\Basit Ng\Downloads\rabbit.png")
        
        result = midjourney.result(seed=seed)
        if result.get('status') == 'completed':
            response = result
            print(response)
        else:
            message = result.get('message')
            print(message)
        
        
        ```
        
        #### Describe response
        
        ```json
        {
          "taskId": "task_id_generated"
        }
        ```
        
        when passed to the result method
        
        ```json
        {
          "status": "completed",
          "content": [
            "1️⃣ four images of a lion lying in water, in the style of cinematic sets, fantasy characters, cinematic lighting, ray tracing, soggy, naturalistic bird portraits, strong facial expression ",
            "2️⃣ four different images of a lion sitting in the water, in the style of vray tracing, realistic, emotive portraits, bokeh, [noah bradley](https://goo.gl/search?artist%20noah%20bradley), fairy tale, photorealistic compositions, 8k ",
            "3️⃣ lion portraits in the water, in the style of [raphael lacoste](https://goo.gl/search?artist%20raphael%20lacoste), bokeh, detailed character expressions, [charles spencelayh](https://goo.gl/search?artist%20charles%20spencelayh), emotional and dramatic scenes, nature inspired, fawncore ",
            "4️⃣ the lion  lion photo editing, lion phototutorials, lionphotography, portrait photography, animal photography, lion photo, in the style of vray tracing, wet-on-wet blending, multi-panel compositions, rendered in cinema4d, 8k 3d, fairy tale, bokeh"
          ]
        }
        ```
        
        ### Using the RESULT API
        
        ```python
        
        from midjourney import Midjourney
        
        
        midjourney = Midjourney(
            api_key="API_KEY", callback_uri="")
        
        seed = {
            "taskId": 'your_task_id',
        }
        result = midjourney.result(seed=seed)
        if result.get('status') == 'completed':
            response = result
            print(response)
        else:
            message = result.get('message')
            print(message)
        
        ```
        
        #### Result response
        
        ```json
        {
          "imageURL": "https://cdn.discordapp.com/attachments/1124090271676772432/1125924854990917713/njho_Lion_king_8k_ultra_reality_in_a_rainy_zone___4410563673654_de36ac34-3209-4940-ab10-7178305ca75f.png"
        }
        ```
        
        ### Using the UPSCALE API
        
        The response will contain the imageURL of the upscaled image.
        
        ```python
        from midjourney import Midjourney
        
        midjourney = Midjourney(
            api_key="API_KEY", callback_uri="")
        
        upscale = midjourney.upscale(
            task_id="the_task_id", position="2")
        
        print(upscale)
        
        ```
        
        #### Upscale response
        
        ```json
        { "imageURL": "https://..........png" }
        ```
        
        ### Using the SEED API
        
        ```python
        from midjourney import Midjourney
        
        midjourney = Midjourney(
            api_key="AI_KEY", callback_uri="")
        
        seed = midjourney.seed(task_id="the_task_id")
        
        print(seed)
        ```
        
        #### Seed response
        
        ```json
        { "taskId": "https://..........png" }
        ```
        
        # Get a midjourney api to interact with midjourney-py
        
        [Get API key](https://slashimagine.pro)
        
        The midjourney is created to make interacting with midjourney-py easy and more structured.
        
        # Wonderful Piece of art generated by the midjourney-py project
        
        1. [A crying white kid holding a blue candy ](https://cdn.discordapp.com/attachments/1124090271676772432/1126110757319360582/olivier_A_crying_white_kid_holding_a_blue_candy_splash_around_h_5b0a4099-f398-4118-8206-33f64c1a5589.png)
        2. [Upscaled Lion](https://cdn.midjourney.com/de36ac34-3209-4940-ab10-7178305ca75f/0_3.png)
        3. [Lion 8k Ultra reality in a rainy zone](https://cdn.discordapp.com/attachments/1124090271676772432/1126104957876187237/olivier_Lion_king_8k_ultra_reality_in_a_rainy_zone___7017353063_1d46e0b1-ae48-47d6-b362-c91415b6d500.png)
        4. [A Lion King in a doom environment](https://cdn.discordapp.com/attachments/1124090271676772432/1125927531137220638/olivier_A_lion_king_in_a_doom_environment___0825378725574918___96c19b7a-5cbe-4879-a24f-1a2941670be8.png)
        5. [Cute Lion with hats](https://cdn.discordapp.com/attachments/1124090271676772432/1125922290304041071/olivier_cute_lion_with_hats___8761618977992125___53dbddbd-63cc-45ef-86da-f16e8026ce96.png)
        6. [8k ultra reality girl](https://cdn.discordapp.com/attachments/1124109999103295560/1125782219466748015/ajaga_abdulbasit_8k_ultra_reality_girl_e4694834-d68a-4335-8713-be93c294a7d6.png)
        7. [Ajaga Abdulbasit generate a custom 8k picture of a coding ninja](https://cdn.discordapp.com/attachments/1124109999103295560/1125250412996472862/ajaga_abdulbasit_generate_a_custom_8k_picture_of_a_coding_ninja_05848b15-4e0f-4694-b0f8-358862b84e06.png)
        
        ### Special Thanks
        
        I would like to extend special thanks to _John Coogan_ and the team at _midjourney_ for their invaluable contributions in making the midjourney-py package accessible to others. Their dedication and expertise have greatly enhanced the functionality and usability of the package. By leveraging their knowledge and efforts, developers can now seamlessly integrate the Mid Journey API into their Python projects. Their commitment to open-source collaboration and their willingness to share their expertise have been instrumental in fostering a vibrant and supportive developer community. We extend our heartfelt appreciation to _John Coogan_ and the entire _midjourney_ team for their outstanding contributions and for making the midjourney-py package a valuable resource for developers.
        
        ### Discord Community for Code Ninjas
        
        [Join the community](https://discord.gg/U6K4gMZh)
        
Keywords: python,ai,midjourney,image,request,stable,stable difusion,difusion
Platform: UNKNOWN
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: Unix
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Description-Content-Type: text/markdown
