docs: update mj

timerring · timerring · commit de2dab263b15 · 2025-05-13T19:52:36.000+08:00
diff --git a/docs/zh/models/midjourney/api/index.md b/docs/zh/models/midjourney/api/index.md
@@ -0,0 +1,22 @@
+---
+title: API 文档
+category: Index
+gitChangelog: false
+updatedAt: 2025-05-08
+---
+
+
+# API 文档
+
+> [!TIP]
+> 可以查看 [midjourney 模型能力一览](../overview.md) 了解 midjourney 模型。
+
+
+## 查询任务接口
+
+- [查询任务](query-task-api.md)
+
+## 提交任务接口
+
+
+
diff --git a/docs/zh/models/midjourney/api/query-task-api.md b/docs/zh/models/midjourney/api/query-task-api.md
@@ -0,0 +1,146 @@
+---
+title: 查询任务
+gitChangelog: false
+updatedAt: 2025-05-08
+---
+
+
+# 查询任务
+
+## 接口描述
+
+查询已提交的任务的状态和结果。
+
+## 请求
+
+> [!TIP]
+> `{api_url}` 为你实际使用的 API 节点，请根据实际情况填写。例如：
+> - `www.dmxapi.cn`
+> - `www.dmxapi.com`
+> - `ssvip.dmxapi.com`
+
+
+- 请求方式: GET
+
+- 请求地址: `/mj/task/{task_id}/fetch`
+- 例如针对 [提交任务 API](./submit-task-api.md)：
+  - `https://{api_url}/mj/task/{task_id}/fetch`
+
+
+## 请求参数
+
+| 参数名 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| task_id | string | 是 | 任务ID |
+
+## 代码示例
+
+> 深色背景为可以修改的参数，非必选参数已经注释，可以按照自己的需求启用。
+
+
+<<< @/zh/snippets/midjourney/api/query-task-api.py{5-6,32}
+
+## 响应参数示例
+
+```
+{
+    "id": "1747132423020537", 
+    "action": "IMAGINE", 
+    "customId": "", 
+    "botType": "", 
+    "prompt": "这是一个视频截图，请生成对应的吉卜力风格的图片", 
+    "promptEn": "http://upload.mjdjourney.top/fileSystem/mj/133/2025/05/13/1747132422998780679_3218.png This is a video screenshot, please generate the corresponding Ghibli style image", 
+    "description": "提交成功", 
+    "state": "", 
+    "mode": "", 
+    "proxy": "", 
+    "submitTime": 1747132423020, 
+    "startTime": 1747132424482, 
+    "finishTime": 1747132463701, 
+    "imageUrl": "https://cdn.gptbest.vip/mj/attachments/1371679336578420847/1371797719932469310/bodnarovataisiia_This_is_a_video_screenshot_please_generate_the_6dc7beb8-8310-4fd4-b46c-716b422ddffc.png?ex=682471af&is=6823202f&hm=f7bcaa9bf369b81525fda9c1320bd98633c20e21bbbf7c003dbc99911a317f2c&", 
+    "imageHeight": 0, 
+    "imageWidth": 0, 
+    "status": "SUCCESS", 
+    "progress": "100%", 
+    "failReason": "", 
+    "buttons": [
+        {
+            "customId": "MJ::JOB::upsample::1::6dc7beb8-8310-4fd4-b46c-716b422ddffc", 
+            "emoji": "", 
+            "label": "U1", 
+            "type": 2, 
+            "style": 2
+        }, 
+        {
+            "customId": "MJ::JOB::upsample::2::6dc7beb8-8310-4fd4-b46c-716b422ddffc", 
+            "emoji": "", 
+            "label": "U2", 
+            "type": 2, 
+            "style": 2
+        }, 
+        {
+            "customId": "MJ::JOB::upsample::3::6dc7beb8-8310-4fd4-b46c-716b422ddffc", 
+            "emoji": "", 
+            "label": "U3", 
+            "type": 2, 
+            "style": 2
+        }, 
+        {
+            "customId": "MJ::JOB::upsample::4::6dc7beb8-8310-4fd4-b46c-716b422ddffc", 
+            "emoji": "", 
+            "label": "U4", 
+            "type": 2, 
+            "style": 2
+        }, 
+        {
+            "customId": "MJ::JOB::reroll::0::6dc7beb8-8310-4fd4-b46c-716b422ddffc::SOLO", 
+            "emoji": "🔄", 
+            "label": "", 
+            "type": 2, 
+            "style": 2
+        }, 
+        {
+            "customId": "MJ::JOB::variation::1::6dc7beb8-8310-4fd4-b46c-716b422ddffc", 
+            "emoji": "", 
+            "label": "V1", 
+            "type": 2, 
+            "style": 2
+        }, 
+        {
+            "customId": "MJ::JOB::variation::2::6dc7beb8-8310-4fd4-b46c-716b422ddffc", 
+            "emoji": "", 
+            "label": "V2", 
+            "type": 2, 
+            "style": 2
+        }, 
+        {
+            "customId": "MJ::JOB::variation::3::6dc7beb8-8310-4fd4-b46c-716b422ddffc", 
+            "emoji": "", 
+            "label": "V3", 
+            "type": 2, 
+            "style": 2
+        }, 
+        {
+            "customId": "MJ::JOB::variation::4::6dc7beb8-8310-4fd4-b46c-716b422ddffc", 
+            "emoji": "", 
+            "label": "V4", 
+            "type": 2, 
+            "style": 2
+        }
+    ], 
+    "maskBase64": "", 
+    "properties": {
+        "notifyHook": "string", 
+        "flags": 0, 
+        "messageId": "1371797720431464448", 
+        "messageHash": "6dc7beb8-8310-4fd4-b46c-716b422ddffc", 
+        "nonce": "1922238820857864192", 
+        "customId": "", 
+        "finalPrompt": "<https://s.mj.run/RdNm0xs6fRI> This is a video screenshot, please generate the corresponding Ghibli style image --fast", 
+        "progressMessageId": "1371797720431464448", 
+        "messageContent": "**<https://s.mj.run/RdNm0xs6fRI> This is a video screenshot, please generate the corresponding Ghibli style image --fast** - <@1364921896055083058> (fast)", 
+        "discordInstanceId": "1371679336578420847", 
+        "discordChannelId": "1371679336578420847"
+    }
+}
+```
diff --git a/docs/zh/models/midjourney/index.md b/docs/zh/models/midjourney/index.md
@@ -0,0 +1,60 @@
+---
+title: midjourney
+category: Index
+gitChangelog: false
+updatedAt: 2025-05-08
+---
+
+# midjourney 文档
+
+> [!TIP][官方 API 文档](https://docs.midjourney.com/hc/en-us/articles/33329261836941-Getting-Started-Guide)
+> 我们**持续同步** API 变更，如发现任何不可用的地方，[请及时联系客服](https://dmxapi.cn/models.html#contact)。
+
+## 案例文档
+
+
+## API 文档
+
+### 查询任务接口
+
+- [查询任务](./api/query-task-api.md)
+
+### 提交任务接口
+
+
+## 模型介绍
+
+> [!NOTE]
+> 通过 **DMXAPI** 接入 Midjourney AI，您可以轻松将这些强大的图像生成功能集成到自己的应用和工作流程中，无需处理复杂的 API 对接流程。详细对比可以查看 [Midjourney 模型能力一览](./overview.md) 了解 Midjourney 模型。
+
+### midjourney-v5
+
+Midjourney 的第五代模型，提供了卓越的图像生成能力和更高的质量。该模型对细节处理、构图和色彩表现有了显著提升，能够更准确地理解和执行复杂提示词，生成更加逼真、精细和艺术性强的图像。V5 模型特别在以下方面表现出色：
+
+- **照片级真实感**：能够生成极为逼真的照片级图像，细节丰富，质感精准。
+- **更强的文本理解**：对复杂指令和提示词的理解能力显著提升，可以更精确地执行用户的创意想法。
+- **艺术风格多样化**：支持更广泛的艺术风格和设计美学，从写实到抽象，从古典到现代。
+- **构图能力增强**：生成的图像构图更加平衡和美观，画面元素排布更加合理。
+
+### midjourney-v6
+
+Midjourney V6 是当前最先进的版本，在 V5 的基础上进行了全面升级，代表了 AI 图像生成技术的最新水平。该版本有以下突出特点：
+
+- **超高分辨率输出**：支持生成更高分辨率的图像，满足专业设计和印刷需求。
+- **革命性细节表现**：在细节渲染上达到了新的高度，尤其在人物面部表情、服装纹理、自然场景和建筑细节方面表现出色。
+- **多元文化理解**：对全球不同文化元素的理解更加深入，能够准确呈现不同地域和民族的特色元素。
+- **复杂场景处理**：能够处理更加复杂的场景描述，包括多人物互动、复杂光影效果和动态氛围营造。
+- **精准色彩控制**：对色彩的把握更加精准，用户可以通过提示词更好地控制图像的色调和氛围。
+- **创意参数扩展**：提供了更多创意参数选项，让用户能够更精细地控制生成结果，实现更个性化的创作。
+
+### midjourney-niji
+
+Midjourney Niji 是专为动漫和插画风格设计的特殊模型，与日本主要插画公司 Spellbrush 合作开发。该模型具有以下特点：
+
+- **专业动漫风格**：专注于生成高质量的动漫和插画风格图像，风格范围从传统日式动漫到现代插画。
+- **角色设计优化**：在角色设计方面经过特别优化，能够生成具有鲜明个性和情感表达的角色形象。
+- **多样化艺术风格**：支持多种动漫和插画风格，包括赛博朋克、奇幻、科幻、日常生活等多种题材。
+- **色彩鲜明**：生成的图像色彩鲜明、对比度强，符合动漫作品的视觉特点。
+- **线条细节**：注重线条的流畅性和精细程度，呈现出专业插画的质感。
+
+Midjourney 的各个版本都为创意工作者、设计师、艺术家和内容创作者提供了强大的创作工具，通过 DMXAPI 平台，您可以便捷地将这些先进的图像生成能力整合到您的应用和服务中，开启无限创意可能。
diff --git a/docs/zh/snippets/midjourney/api/query-task-api.py b/docs/zh/snippets/midjourney/api/query-task-api.py
@@ -0,0 +1,33 @@
+import http.client
+import json
+
+# 配置全局变量
+API_URL = "www.dmxapi.cn" # API 节点
+DMX_API_TOKEN = "sk-XXXXXXXXXXXXX" # API 密钥
+
+# 创建HTTP连接对象，用于后续所有API请求
+conn = http.client.HTTPSConnection(API_URL)
+
+def query_midjourney_task_api(task_id):
+    # 设置 Request headers
+    headers = {
+        'Authorization': f'Bearer {DMX_API_TOKEN}',
+        'Content-Type': 'application/json'
+    }
+    # 根据请求接口，构建完整的查询路径，包含task_id参数
+    query_path = f"/mj/task/{task_id}/fetch"
+
+    try:
+        # request 请求规范：方法, URL, body, headers
+        conn.request("GET", query_path, None, headers)
+        # 获取响应并解析JSON数据
+        res = conn.getresponse()
+        json_data = json.loads(res.read().decode("utf-8"))
+        return json_data
+
+    except Exception as e:
+        print(f"query midjourney task api error: {e}")
+
+if __name__ == "__main__":
+    task_id = "1747132423020537"  # 替换为你的实际任务ID
+    print(query_midjourney_task_api(task_id))
