Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/erictik/midjourney-api

MidJourney client. Unofficial Node.js client
https://github.com/erictik/midjourney-api

midjourney midjourney-client

Last synced: 20 days ago
JSON representation

MidJourney client. Unofficial Node.js client

Host: GitHub
URL: https://github.com/erictik/midjourney-api
Owner: erictik
License: apache-2.0
Created: 2023-04-24T13:54:42.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2024-04-16T20:15:29.000Z (7 months ago)
Last Synced: 2024-10-11T11:34:40.997Z (24 days ago)
Topics: midjourney, midjourney-client
Language: TypeScript
Homepage:
Size: 2.67 MB
Stars: 1,697
Watchers: 28
Forks: 285
Open Issues: 121
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

awesome - erictik/midjourney-api - MidJourney client. Unofficial Node.js client (TypeScript)
awesome - erictik/midjourney-api - MidJourney client. Unofficial Node.js client (TypeScript)

README

        # midjourney-client

Node.js client for the unofficial MidJourney api.

English / [中文文档](README_zh.md)



	

		

		

	



## What's new

- [face swap](https://github.com/erictik/midjourney-client/blob/main/example/faceswap.ts)

- [niji bot](https://github.com/erictik/midjourney-client/blob/main/example/imagine-niji.ts)

- [custom zoom](https://github.com/erictik/midjourney-client/blob/main/example/customzoom.ts)

- [remix mode](https://github.com/erictik/midjourney-client/blob/main/example/variation-ws.ts)

## Example

To run the included example, you must have [Node.js](https://nodejs.org/en/) installed. Then, run the following commands in the root directory of this project:

1. clone the repository

   ```bash

   git clone https://github.com/erictik/midjourney-client.git

   cd midjourney-client

   ```

2. install dependencies

   ```bash

   yarn

   # or npm

   npm install

   ```

3. set the environment variables

- [Login Discord](https://discord.com/channels/@me)`F12` _OR_ `Ctrl + Shift + I` (or `Command + Option + I` on Mac) to open the developer tools _AND_ paste the following code into the console

  ```javascript

  window.webpackChunkdiscord_app.push([

    [Math.random()],

    {},

    (req) => {

      for (const m of Object.keys(req.c)

        .map((x) => req.c[x].exports)

        .filter((x) => x)) {

        if (m.default && m.default.getToken !== undefined) {

          return copy(m.default.getToken());

        }

        if (m.getToken !== undefined) {

          return copy(m.getToken());

        }

      }

    },

  ]);

  console.log("%cWorked!", "font-size: 50px");

  console.log(`%cYou now have your token in the clipboard!`, "font-size: 16px");

  ```

  OR [use network your Discord TOKEN](https://www.androidauthority.com/get-discord-token-3149920/)

- [Join my discord server](https://discord.com/invite/GavuGHQbV4)

  ```

  export SERVER_ID="1082500871478329374"

  export CHANNEL_ID="1094892992281718894"

  ```

- OR [Create a server](https://discord.com/blog/starting-your-first-discord-server) and [Invite Midjourney Bot to Your Server](https://docs.midjourney.com/docs/invite-the-bot)

  ```bash

  # How to get server and channel ids:

  # when you click on a channel in your server in the browser

  # expect to have the follow URL pattern

  # `https://discord.com/channels/$SERVER_ID/$CHANNEL_ID`

  export SERVER_ID="your-server-id"

  export CHANNEL_ID="your-channel-id"

  ```

- wirte your token to `.env` file or set the environment variables

  ```bash

    #example variables, please set up yours

    export SERVER_ID="1082500871478329374"

    export CHANNEL_ID="1094892992281718894"

    export SALAI_TOKEN="your-discord-token"

  ```

- Then, run the example with the following command:

  ```bash

  npx tsx example/imagine-ws.ts

  ```

  OR

  ```bash

  yarn example:imagine

  # or npm

  npm run example:imagine

  ```

- [more example](./example/)

## Usage

1. Install

   ```bash

   npm i midjourney

   # or

   yarn add midjourney

   ```

2. config param

   ```typescript

   export interface MJConfigParam {

     SalaiToken: string; //DISCORD_TOKEN

     ChannelId?: string; //DISCORD_CHANNEL_ID

     ServerId?: string; //DISCORD_SERVER_ID

     BotId?: typeof MJBot | typeof NijiBot; //DISCORD_BOT_ID MJBot OR NijiBot

     Debug?: boolean; // print log

     ApiInterval?: number; //ApiInterval request api interval

     Limit?: number; //Limit of get message list

     MaxWait?: number;

     Remix?: boolean; //Remix:true use remix mode

     Ws?: boolean; //Ws:true use websocket get discord message (ephemeral message)

     HuggingFaceToken?: string; //HuggingFaceToken for verify human

     SessionId?: string;

     DiscordBaseUrl?: string;

     ImageProxy?: string;

     WsBaseUrl?: string;

     fetch?: FetchFn; //Node.js<18 need node.fetch Or proxy

     WebSocket?: WebSocketCl; //isomorphic-ws Or proxy

   }

   ```

3. Use Imagine 、Variation and Upscale

   ```typescript

   import { Midjourney } from "midjourney";

   const client = new Midjourney({

     ServerId: process.env.SERVER_ID,

     ChannelId: process.env.CHANNEL_ID,

     SalaiToken: process.env.SALAI_TOKEN,

     Debug: true,

     Ws: true, //enable ws is required for remix mode (and custom zoom)

   });

   await client.init();

   const prompt =

     "Christmas dinner with spaghetti with family in a cozy house, we see interior details , simple blue&white illustration";

   //imagine

   const Imagine = await client.Imagine(

     prompt,

     (uri: string, progress: string) => {

       console.log("loading", uri, "progress", progress);

     }

   );

   console.log(Imagine);

   if (!Imagine) {

     console.log("no message");

     return;

   }

   //U1 U2 U3 U4 V1 V2 V3 V4  "Vary (Strong)" ...

   //⬅️,⬆️,⬇️,➡️

   const V1CustomID = Imagine.options?.find((o) => o.label === "V1")?.custom;

   if (!V1CustomID) {

     console.log("no V1");

     return;

   }

   // Varition V1

   const Varition = await client.Custom({

     msgId: Imagine.id,

     flags: Imagine.flags,

     customId: V1CustomID,

     content: prompt, //remix mode require content

     loading: (uri: string, progress: string) => {

       console.log("loading", uri, "progress", progress);

     },

   });

   console.log(Varition);

   const U1CustomID = Imagine.options?.find((o) => o.label === "U1")?.custom;

   if (!U1CustomID) {

     console.log("no U1");

     return;

   }

   // Upscale U1

   const Upscale = await client.Custom({

     msgId: Imagine.id,

     flags: Imagine.flags,

     customId: U1CustomID,

     loading: (uri: string, progress: string) => {

       console.log("loading", uri, "progress", progress);

     },

   });

   if (!Upscale) {

     console.log("no Upscale");

     return;

   }

   console.log(Upscale);

   const zoomout = Upscale?.options?.find((o) => o.label === "Custom Zoom");

   if (!zoomout) {

     console.log("no zoomout");

     return;

   }

   // Custom Zoom

   const CustomZoomout = await client.Custom({

     msgId: Upscale.id,

     flags: Upscale.flags,

     content: `${prompt} --zoom 2`, // Custom Zoom  require content

     customId: zoomout.custom,

     loading: (uri: string, progress: string) => {

       console.log("loading", uri, "progress", progress);

     },

   });

   console.log(CustomZoomout);

   ```

## route-map

- [x] `/imagine` `variation` `upscale` `reroll` `blend` `zoomout` `vary`

- [x] `/info`

- [x] `/fast ` and `/relax `

- [x] [`/prefer remix`](https://github.com/erictik/midjourney-client/blob/main/example/prefer-remix.ts)

- [x] [`variation (remix mode)`](https://github.com/erictik/midjourney-client/blob/main/example/variation-ws.ts)

- [x] `/describe`

- [x] [`/shorten`](https://github.com/erictik/midjourney-client/blob/main/example/shorten.ts)

- [x] `/settings` `reset`

- [x] verify human

- [x] [proxy](https://github.com/erictik/midjourney-discord/blob/main/examples/proxy.ts)

- [x] [niji bot](https://github.com/erictik/midjourney-client/blob/main/example/imagine-niji.ts)

- [x] [custom zoom](https://github.com/erictik/midjourney-client/blob/main/example/customzoom.ts)

- [x] autoload command payload

---

## Projects

- [midjourney-ui](https://github.com/erictik/midjourney-ui/) next.js + vercel

- [midjourney-discord](https://github.com/erictik/midjourney-discord)-bot

- [phrame](https://github.com/jakowenko/phrame)

- [guapitu](https://www.guapitu.com/zh/draw?code=RRXQNF)

---

## Support

If you find it valuable and would like to show your support, any donations would be greatly appreciated. Your contribution helps me maintain and improve the program.



  







## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=erictik/midjourney-client&type=Date)](https://star-history.com/#erictik/midjourney-client&Date)