mcpField
M
midjourney-image

midjourney-image

github.com/acedatacloud创意与媒体1769 次安装1 天前更新
代码仓库

关于 midjourney-image

这是一个通过 Ace Data Cloud API 或托管 MCP 服务使用 Midjourney 的技能，涵盖图像与视频生成、图像编辑、任务查询和凭证配置。

主要功能

  1. 01生成图像和视频
  2. 02编辑和描述图像
  3. 03混合图像
  4. 04跟踪生成任务
  5. 05配置 API 凭证

适用场景

  1. 01根据提示词创建图像
  2. 02编辑或描述图像
  3. 03生成或扩展视频
  4. 04查询已提交任务的结果

MCP 相关

可连接至 `https://midjourney.mcp.acedata.cloud/mcp` 上的托管 Streamable HTTP MCP 服务，调用生成、编辑、混合、描述、视频和任务查询工具。也可使用 `mcp-midjourney` 软件包运行本地服务。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/acedatacloud/skills --skill midjourney-image

安装后在 Claude Code 中输入/midjourney-image确认已加载。

详细介绍

通过 Ace Data Cloud 使用 Midjourney

使用 Midjourney API 或托管的 MCP 服务。

首次设置

  1. 使用 clawhub install @acedatacloud/midjourney 安装官方 Skill。确认 ClawHub 发布者是 @acedatacloud。
  2. 登录 AceDataCloud → Applications，打开 General application（如果提示，请先初始化），并检查 Midjourney 访问权限、余额和当前价格。复制其 API 密钥，或选择 Manage Keys → Create 创建单独的密钥。复制密钥值时不要包含 Bearer ；platform-... 管理令牌不是服务 API 密钥。
  3. 如果启用了 Allowed APIs 限制，首次生成图像时请加入 /midjourney/imagine 和 /midjourney/tasks。以下其他操作需要各自对应的路由。
  4. 在 OpenClaw Gateway 主机上，将 ACEDATACLOUD_API_TOKEN=your_api_key_here 放入 ~/.openclaw/.env，然后重启 Gateway 并启动新会话。若要直接在终端测试，请在该 shell 中运行 export ACEDATACLOUD_API_TOKEN="your_api_key_here"。切勿将密钥放入提示词或提交 .env 文件。
  5. 运行下方的 First image 示例。保存返回的任务 ID，并查询同一任务直到完成；不要为了检查进度而再次提交会产生费用的 imagine 请求。

令牌设置与故障排查

首张图像

提交生成请求前，请在 Ace Data Cloud 控制台查看当前 Midjourney 价格和余额。一次 imagine 请求最多可生成 2×2 网格。使用 async: true，让请求尽快返回 task_id：

curl -X POST https://api.acedata.cloud/midjourney/imagine \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"A small red sailboat on a calm lake at sunrise --ar 1:1","mode":"fast","async":true}'

保存返回的 task_id。轮询同一 ID；不要重复调用 imagine 来检查进度：

curl -X POST https://api.acedata.cloud/midjourney/tasks \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action":"retrieve","id":"TASK_ID_FROM_FIRST_CALL"}'

任务已接受不代表图像已完成。只有在查询到的任务包含 response.success: true，且包含可用的 response.image_url 或 response.raw_image_url 时，才呈现最终成品。任务失败时，请停止操作并报告错误。如果查询或网络连接中断，请保留任务 ID；查询同一 ID 不会再次提交生成请求。请参阅任务 API 指南。

其他操作

  • 使用已完成网格的 image_id，通过 POST /midjourney/imagine 执行 upscale1、variation1 或 reroll 等操作。这些是新的计费操作，不是任务查询。
  • 通过 POST /midjourney/edits 使用提示词编辑输入图像。
  • 通过 POST /midjourney/describe 描述图像。
  • 通过 POST /midjourney/videos 生成或延长视频。保存其任务 ID，并查询同一任务。
  • 仅对实时 API 文档中说明支持的版本使用 version 参数或提示词标记。Midjourney V8.1 支持 fast 和 relax，不支持 turbo，也不接受 quality 参数。

MCP 工具

托管的 Streamable HTTP 服务地址为 https://midjourney.mcp.acedata.cloud/mcp。在 MCP 客户端中私下配置 Authorization: Bearer <Ace token>。其命名工具包括 midjourney_imagine、midjourney_edit、midjourney_blend、midjourney_describe、midjourney_generate_video、midjourney_get_task 和 midjourney_get_tasks_batch。使用 midjourney_get_task 查询生成工具返回的确切 ID，直到明确任务最终成功或失败。MCP 服务源代码介绍了完整的工具集。

也可以使用已发布的 mcp-midjourney 软件包在本地运行该服务。如果某项操作失败，请勿改用其他模型或服务。

故障排查

  • 401：检查令牌值和有效期。403：检查 Midjourney 访问权限或内容政策。429：等待建议的速率限制间隔。提交任务后出现 5xx 或传输超时，不代表需要创建另一个任务；请先查询已保存的 ID。
  • 如果任务已完成但没有 URL，请检查完整的任务响应并报告缺失的产物；不要将任务 ID 当作结果。
  • 查看已完成操作对应的 Ace Data Cloud 使用记录或账单记录。查询任务不会创建另一个 imagine 请求。

评论

支持 Markdown