青云TOP API使用教程&开发文档小白用户&专业开发者快速使用指南
控制台
返回模型调用 API 参考
POST/mj/submit/upload-discord-images

上传图片

上传图片到 Discord 获取可访问图片链接，常用于 Imagine 垫图和后续图片任务。

API Key application/json
MJ 异步任务协议

调用与返回说明

提交 上传图片到 Discord。MJ 接口采用“提交任务 → 保存任务 ID → 查询/回调 → 读取结果或执行后续动作”的异步模式，不是同步返回图片或视频。

请求时注意

  • 所有 MJ 接口都要在 Header 中发送 Authorization: Bearer <API_KEY>。生产环境请从服务端环境变量读取 Key。
  • 请求地址使用当前站点配置的 API Base URL 拼接本文 endpoint；不要把 /v1 误加到 /mj 路径，也不要重复拼接 Base URL。
  • 不要在 URL 中直接传输未经授权的临时文件；图片链接必须能被服务端访问。

返回时注意

  • 先检查 HTTP 状态，再检查响应体中的 code 或 status。提交接口的 code=1 通常表示成功接收，result 才是后续查询使用的任务 ID。
  • 保存返回链接并检查 code；不要把上传接口的 result 当成 MJ 任务 ID。
  • 任务查询的终态包括 SUCCESS、FAILURE、CANCEL；MODAL 表示需要继续提交 Modal。不要只根据 progress=100% 判定成功。
Request

请求

/mj/submit/upload-discord-images

Body

可选
Bodyapplication/json
Bodyobject
base64Arrayarray<string>

Base64 字符串数组。外部文档将其标为可选；至少应提供一个可用图片才有实际意义。

示例["data:image/png;base64,..."]
元素string

路径、查询与 Header 参数

参数位置类型必填说明示例
AuthorizationHeaderstring是必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。Bearer YOUR_API_KEY
Response

返回响应 200

HTTP 成功不等于任务成功；请继续检查响应体中的 code 或 status。
响应 200json
响应 200object
codeinteger

业务状态码。

descriptionstring

结果描述。

resultarray<string>

上传后的图片链接列表；具体返回形状以当前网关实际响应为准。

元素string
MJ 异步任务协议

调用与返回说明

提交 上传图片到 Discord。MJ 接口采用“提交任务 → 保存任务 ID → 查询/回调 → 读取结果或执行后续动作”的异步模式，不是同步返回图片或视频。

请求时注意

  • 所有 MJ 接口都要在 Header 中发送 Authorization: Bearer <API_KEY>。生产环境请从服务端环境变量读取 Key。
  • 请求地址使用当前站点配置的 API Base URL 拼接本文 endpoint；不要把 /v1 误加到 /mj 路径，也不要重复拼接 Base URL。
  • 不要在 URL 中直接传输未经授权的临时文件；图片链接必须能被服务端访问。

返回时注意

  • 先检查 HTTP 状态，再检查响应体中的 code 或 status。提交接口的 code=1 通常表示成功接收，result 才是后续查询使用的任务 ID。
  • 保存返回链接并检查 code；不要把上传接口的 result 当成 MJ 任务 ID。
  • 任务查询的终态包括 SUCCESS、FAILURE、CANCEL；MODAL 表示需要继续提交 Modal。不要只根据 progress=100% 判定成功。