# midjourney-api

非官方的 MidJourney api 的 Node.js 客户端。

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

<div align="center">
	<p>
		<a href="https://discord.gg/GavuGHQbV4"><img src="https://img.shields.io/discord/1082500871478329374?color=5865F2&logo=discord&logoColor=white" alt="Discord server" /></a>
		<a href="https://www.npmjs.com/package/midjourney"><img src="https://img.shields.io/npm/v/midjourney.svg?maxAge=3600" alt="npm version" /></a>
	</p>
</div>

## 最近更新

- [换脸](https://github.com/erictik/midjourney-api/blob/main/example/faceswap.ts)
- [支持 niji bot](https://github.com/erictik/midjourney-api/blob/main/example/imagine-niji.ts)
- [custom zoom](https://github.com/erictik/midjourney-api/blob/main/example/customzoom.ts)
- [remix mode](https://github.com/erictik/midjourney-api/blob/main/example/variation-ws.ts)

## 快速开始

运行本项目需要安装 [Node.js](https://nodejs.org/en/)，然后在本项目的根目录运行以下命令：

1. 下载项目代码

   ```bash
   git clone https://github.com/erictik/midjourney-api.git
   cd midjourney-api
   ```

2. 安装依赖

   ```bash
   yarn
   # or npm
   npm install
   ```

3. 设置环境变量

- 获取 Discord TOKEN
  [登录 Discor](https://discord.com/channels/@me) F12 或者 [Ctrl + Shift + I] 或者 [Command + Option + I] 打开开发者工具，然后在 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(`%您的Token在剪贴板了!`, "font-size: 16px");
  ```

  也可以通过 查看 network [获取 discord token](https://www.androidauthority.com/get-discord-token-3149920/)

- [加入我的 Discord 服务器](https://discord.com/invite/GavuGHQbV4)
  ```
  export SERVER_ID="1082500871478329374"
  export CHANNEL_ID="1094892992281718894"
  ```
- 或者 [创建一个 Discord 服务器](https://discord.com/blog/starting-your-first-discord-server) 并邀请 [Midjourney Bot](https://docs.midjourney.com/docs/invite-the-bot)

  ```bash
  # 在浏览器中复制你的服务器网址
  # `https://discord.com/channels/$SERVER_ID/$CHANNEL_ID`
  export SERVER_ID="your-server-id"
  export CHANNEL_ID="your-channel-id"
  ```

- 将环境变量写入`.env`文件或者 在控制台中设置

  ```bash
  #example variables, please set up yours

  export SERVER_ID="1082500871478329374"
  export CHANNEL_ID="1094892992281718894"
  export SALAI_TOKEN="your-discord-token"
  ```

4.  现在可以运行示例了

    ```bash
    npx tsx example/imagine-ws.ts
    ```

    或者

    ```bash
    yarn example:imagine
    # or npm
    npm run example:imagine
    ```

5.  更多使用案例
    - [more example](./example/)

## 在项目中使用

1. 安装

   ```bash
   npm i midjourney
   # or
   yarn add midjourney
   ```

2. 使用 Imagine 、Variation 和 Upscale

   ```typescript
   import { Midjourney } from "midjourney";
   const client = new Midjourney({
     ServerId: <string>process.env.SERVER_ID,
     ChannelId: <string>process.env.CHANNEL_ID,
     SalaiToken: <string>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: <string>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: <string>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: <string>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-api/blob/main/example/prefer-remix.ts)
- [x] [`variation (remix mode)`](https://github.com/erictik/midjourney-api/blob/main/example/variation-ws.ts)
- [x] `/describe`
- [x] [`/shorten`](https://github.com/erictik/midjourney-api/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-api/blob/main/example/imagine-niji.ts)
- [x] [custom zoom](https://github.com/erictik/midjourney-api/blob/main/example/customzoom.ts)
- [x] autoload command payload

---

## 应用项目

- [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)

---

## 支持一下我吧

如果您觉得它很有价值，可以通过以下方式支持作者

<span style="word-spacing:20px">
<img src="images/ali.png" height="300"/>  
<img src="images/wechat.png" height="300"/>
<a href='https://ko-fi.com/erictik' target='_blank'><img height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi1.png?v=3' border='0' alt='Buy Me a Coffee' /></a>
</span>

## Star History

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