Skip to content

Начало работы

Важные соглашения

  • При отправке задачи необходимо указать заголовок Authorization: Bearer hk-замените_на_ваш_ключ или Mj-Api-Secret: hk-замените_на_ваш_ключ
  • Адрес API Midjourney https://api.openai-hk.com
  • В качестве DEMO используется отправка задачи Imagine Нажмите, чтобы просмотреть быструю интеграцию

Отправка задач

Точки доступа режимов

  • Смешанный режим (будет удален) https://api.openai-hk.com
  • Режим fast https://api.openai-hk.com/fast
  • Режим relax https://api.openai-hk.com/relax
  • Цены на различные режимы различаются, пожалуйста, проверьте цены в Консоль->Покупка KEY

Выполнение действия

Адрес интерфейса:/mj/submit/action

Метод запроса:POST

Тип данных запроса:application/json

Тип данных ответа:*/*

Описание интерфейса:

Пример запроса:

json
{
  "customId": "MJ::JOB::upsample::2::3dbbd469-36af-4a0f-8f02-df6c579e7011",
  "notifyHook": "",
  "state": "",
  "taskId": "14001934816969359"
}
{
  "customId": "MJ::JOB::upsample::2::3dbbd469-36af-4a0f-8f02-df6c579e7011",
  "notifyHook": "",
  "state": "",
  "taskId": "14001934816969359"
}

Параметры запроса:

Имя параметраОписание параметраТип запросаОбязательноТип данныхschema
actionDTOactionDTObodytrueПараметры действияПараметры действия
  customIdИдентификатор действияtruestring
  notifyHookАдрес обратного вызова, если пуст - используется глобальный notifyHookfalsestring
  stateПользовательский параметрfalsestring
  taskIdID задачиtruestring

Статус ответа:

Код статусаОписаниеschema
200OKРезультат отправки
201Created
401Unauthorized
403Forbidden
404Not Found

Параметры ответа:

Имя параметраОписание параметраТипschema
codeКод состояния: 1(отправка успешна), 22(в очереди), other(ошибка)integer(int32)integer(int32)
descriptionОписаниеstring
propertiesДополнительные поляobject
resultID задачиstring

Пример ответа:

json
{
  "code": 1,
  "description": "提交成功",
  "properties": {},
  "result": 1320098173412546
}
{
  "code": 1,
  "description": "提交成功",
  "properties": {},
  "result": 1320098173412546
}

Отправка задачи Blend

Адрес интерфейса:/mj/submit/blend

Метод запроса:POST

Тип данных запроса:application/json

Тип данных ответа:*/*

Описание интерфейса:

Пример запроса:

json
{
  "base64Array": ["data:image/png;base64,xxx1", "data:image/png;base64,xxx2"],
  "dimensions": "SQUARE",
  "instanceId": "",
  "modes": [],
  "notifyHook": "",
  "remix": true,
  "state": ""
}
{
  "base64Array": ["data:image/png;base64,xxx1", "data:image/png;base64,xxx2"],
  "dimensions": "SQUARE",
  "instanceId": "",
  "modes": [],
  "notifyHook": "",
  "remix": true,
  "state": ""
}

Параметры запроса:

Имя параметраОписание параметраТип запросаОбязательноТип данныхschema
blendDTOblendDTObodytrueПараметры BlendПараметры Blend
  base64ArrayМассив изображений base64truearraystring
  dimensionsСоотношение: PORTRAIT(2:3); SQUARE(1:1); LANDSCAPE(3:2), доступные значения:PORTRAIT,SQUARE,LANDSCAPEfalsestring
  instanceIdID экземпляра аккаунта, указывает аккаунт для выполнения задачиfalsestring
  modesРежим аккаунта, фильтрует аккаунт для выполнения задачиfalsearraystring
  notifyHookАдрес обратного вызова, если пуст - используется глобальный notifyHookfalsestring
  remixRemix аккаунта, фильтрует аккаунт для выполнения задачиfalseboolean
  stateПользовательский параметрfalsestring

Статус ответа:

Код статусаОписаниеschema
200OKРезультат отправки
201Created
401Unauthorized
403Forbidden
404Not Found

Параметры ответа:

Имя параметраОписание параметраТипschema
codeКод состояния: 1(отправка успешна), 22(в очереди), other(ошибка)integer(int32)integer(int32)
descriptionОписаниеstring
propertiesДополнительные поляobject
resultID задачиstring

Пример ответа:

json
{
  "code": 1,
  "description": "提交成功",
  "properties": ,
  "result": 1320098173412546
}
{
  "code": 1,
  "description": "提交成功",
  "properties": ,
  "result": 1320098173412546
}

Отправка задачи преобразования изображения в текст

Адрес интерфейса:/mj/submit/describe

Метод запроса:POST

Тип данных запроса:application/json

Тип данных ответа:*/*

Описание интерфейса:

Пример запроса:

json
{
  "base64": "data:image/png;base64,xxx",
  "instanceId": "",
  "modes": [],
  "notifyHook": "",
  "remix": true,
  "state": ""
}
{
  "base64": "data:image/png;base64,xxx",
  "instanceId": "",
  "modes": [],
  "notifyHook": "",
  "remix": true,
  "state": ""
}

Параметры запроса:

Имя параметраОписание параметраТип запросаОбязательноТип данныхschema
describeDTOdescribeDTObodytrueПараметры DescribeПараметры Describe
  base64Изображение base64truestring
  instanceIdID экземпляра аккаунта, указывает аккаунт для выполнения задачиfalsestring
  modesРежим аккаунта, фильтрует аккаунт для выполнения задачиfalsearraystring
  notifyHookАдрес обратного вызова, если пуст - используется глобальный notifyHookfalsestring
  remixRemix аккаунта, фильтрует аккаунт для выполнения задачиfalseboolean
  stateПользовательский параметрfalsestring

Статус ответа:

Код статусаОписаниеschema
200OKРезультат отправки
201Created
401Unauthorized
403Forbidden
404Not Found

Параметры ответа:

Имя параметраОписание параметраТипschema
codeКод состояния: 1(отправка успешна), 22(в очереди), other(ошибка)integer(int32)integer(int32)
descriptionОписаниеstring
propertiesДополнительные поляobject
resultID задачиstring

Пример ответа:

json
{
  "code": 1,
  "description": "提交成功",
  "properties": {},
  "result": 1320098173412546
}
{
  "code": 1,
  "description": "提交成功",
  "properties": {},
  "result": 1320098173412546
}

Отправка задачи Imagine

Адрес интерфейса:/mj/submit/imagine

Метод запроса:POST

Тип данных запроса:application/json

Тип данных ответа:*/*

Описание интерфейса:

Пример запроса:

json
{
  "base64Array": [],
  "instanceId": "",
  "modes": [],
  "notifyHook": "",
  "prompt": "Cat",
  "remix": true,
  "state": ""
}
{
  "base64Array": [],
  "instanceId": "",
  "modes": [],
  "notifyHook": "",
  "prompt": "Cat",
  "remix": true,
  "state": ""
}

Параметры запроса:

Имя параметраОписание параметраТип запросаОбязательноТип данныхschema
imagineDTOimagineDTObodytrueПараметры ImagineПараметры Imagine
  base64ArrayМассив изображений-подложек base64falsearraystring
  instanceIdID экземпляра аккаунта, указывает аккаунт для выполнения задачиfalsestring
  modesРежим аккаунта, фильтрует аккаунт для выполнения задачиfalsearraystring
  notifyHookАдрес обратного вызова, если пуст - используется глобальный notifyHookfalsestring
  promptПромптtruestring
  remixRemix аккаунта, фильтрует аккаунт для выполнения задачиfalseboolean
  stateПользовательский параметрfalsestring

Статус ответа:

Код статусаОписаниеschema
200OKРезультат отправки
201Created
401Unauthorized
403Forbidden
404Not Found

Параметры ответа:

Имя параметраОписание параметраТипschema
codeКод состояния: 1(отправка успешна), 22(в очереди), other(ошибка)integer(int32)integer(int32)
descriptionОписаниеstring
propertiesДополнительные поляobject
resultID задачиstring

Пример ответа:

json
{
  "code": 1,
  "description": "提交成功",
  "properties": {},
  "result": 1320098173412546
}
{
  "code": 1,
  "description": "提交成功",
  "properties": {},
  "result": 1320098173412546
}

Отправка Modal

Адрес интерфейса:/mj/submit/modal

Метод запроса:POST

Тип данных запроса:application/json

Тип данных ответа:*/*

Описание интерфейса:

Пример запроса:

json
{
  "maskBase64": "",
  "prompt": "",
  "taskId": "14001934816969359"
}
{
  "maskBase64": "",
  "prompt": "",
  "taskId": "14001934816969359"
}

Параметры запроса:

Имя параметраОписание параметраТип запросаОбязательноТип данныхschema
modalDTOmodalDTObodytrueПараметры ModalПараметры Modal
  maskBase64Маска base64 для локальной перерисовкиfalsestring
  promptПромптfalsestring
  taskIdID задачиtruestring

Статус ответа:

Код статусаОписаниеschema
200OKРезультат отправки
201Created
401Unauthorized
403Forbidden
404Not Found

Параметры ответа:

Имя параметраОписание параметраТипschema
codeКод состояния: 1(отправка успешна), 22(в очереди), other(ошибка)integer(int32)integer(int32)
descriptionОписаниеstring
propertiesДополнительные поляobject
resultID задачиstring

Пример ответа:

json
{
  "code": 1,
  "description": "提交成功",
  "properties": {},
  "result": 1320098173412546
}
{
  "code": 1,
  "description": "提交成功",
  "properties": {},
  "result": 1320098173412546
}

Отправка задачи замены лица swap_face

Адрес интерфейса:/mj/insight-face/swap

Метод запроса:POST

Тип данных запроса:application/json

Тип данных ответа:*/*

Описание интерфейса:

Пример запроса:

javascript
{
  "sourceBase64": "data:image/png;base64,xxx1",
  "targetBase64": "data:image/png;base64,xxx2",
  "accountFilter": {
    "instanceId": ""
  },
  "notifyHook": "",
  "state": ""
}
{
  "sourceBase64": "data:image/png;base64,xxx1",
  "targetBase64": "data:image/png;base64,xxx2",
  "accountFilter": {
    "instanceId": ""
  },
  "notifyHook": "",
  "state": ""
}

Параметры запроса:

Параметры запроса:

Имя параметраОписание параметраТип запросаОбязательноТип данныхschema
swapFaceDTOswapFaceDTObodytrueПараметры SwapFaceПараметры SwapFace
  sourceBase64Исходное изображение лица base64truestring
  targetBase64Целевое изображение base64truestring
  accountFilterФильтр аккаунта для выполнения задачи, установите null или удалите параметр если фильтрация не нужнаfalseFilterFilter
    instanceIdID экземпляра аккаунтаfalsestring
  notifyHookАдрес обратного вызова, если пуст - используется глобальный notifyHookfalsestring
  stateПользовательский параметрfalsestring

Статус ответа:

Код статусаОписаниеschema
200OKMessage«string»
201Created
401Unauthorized
403Forbidden
404Not Found

Параметры ответа:

Имя параметраОписание параметраТипschema
codeinteger(int32)integer(int32)
descriptionstring
resultstring

Пример ответа:

javascript
{
	"code": 0,
	"description": "",
	"result": ""
}
{
	"code": 0,
	"description": "",
	"result": ""
}

Отправка задачи Shorten

Адрес интерфейса:/mj/submit/shorten

Метод запроса:POST

Тип данных запроса:application/json

Тип данных ответа:*/*

Описание интерфейса:

Пример запроса:

json
{
  "instanceId": "",
  "modes": [],
  "notifyHook": "",
  "prompt": "Cat",
  "remix": true,
  "state": ""
}
{
  "instanceId": "",
  "modes": [],
  "notifyHook": "",
  "prompt": "Cat",
  "remix": true,
  "state": ""
}

Параметры запроса:

Имя параметраОписание параметраТип запросаОбязательноТип данныхschema
shortenDTOshortenDTObodytrueПараметры ShortenПараметры Shorten
  instanceIdID экземпляра аккаунта, указывает аккаунт для выполнения задачиfalsestring
  modesРежим аккаунта, фильтрует аккаунт для выполнения задачиfalsearraystring
  notifyHookАдрес обратного вызова, если пуст - используется глобальный notifyHookfalsestring
  promptПромптtruestring
  remixRemix аккаунта, фильтрует аккаунт для выполнения задачиfalseboolean
  stateПользовательский параметрfalsestring

Статус ответа:

Код статусаОписаниеschema
200OKРезультат отправки
201Created
401Unauthorized
403Forbidden
404Not Found

Параметры ответа:

Имя параметраОписание параметраТипschema
codeКод состояния: 1(отправка успешна), 22(в очереди), other(ошибка)integer(int32)integer(int32)
descriptionОписаниеstring
propertiesДополнительные поляobject
resultID задачиstring

Пример ответа:

json
{
  "code": 1,
  "description": "提交成功",
  "properties": {},
  "result": 1320098173412546
}
{
  "code": 1,
  "description": "提交成功",
  "properties": {},
  "result": 1320098173412546
}

Создание задачи видео

Адрес интерфейса:/mj/submit/video

Метод запроса:POST

Тип данных запроса:application/json

Пример запроса:

  • image поддерживает base64 или url
  • videoType по умолчанию vid_1.1_i2v_480, цена в 7.5 раз больше цены генерации изображения
  • Для видео высокой четкости нужно videoType= vid_1.1_i2v_720, цена в 26 раз больше цены генерации изображения
json
{
  "prompt": "飞来一只蜜蜂",
  "motion": "low",
  "image": "https://cdn.discordapp.com/attachments/1372468820912115716/1388566717961338880/hyper_realistic_3d_rendering_pink_tulip_style_686021570d5ec4451c1c120a.jpg?ex=68617307&is=68602187&hm=f939f10d79de24e3ed0f2c4dc1453c902ee6b383d13d9a1787eacfccfadb9488&",
  "notifyHook": "https://sse.open-hk.com/openai/mjapi/9-8/",
  "videoType": "vid_1.1_i2v_480"
}
{
  "prompt": "飞来一只蜜蜂",
  "motion": "low",
  "image": "https://cdn.discordapp.com/attachments/1372468820912115716/1388566717961338880/hyper_realistic_3d_rendering_pink_tulip_style_686021570d5ec4451c1c120a.jpg?ex=68617307&is=68602187&hm=f939f10d79de24e3ed0f2c4dc1453c902ee6b383d13d9a1787eacfccfadb9488&",
  "notifyHook": "https://sse.open-hk.com/openai/mjapi/9-8/",
  "videoType": "vid_1.1_i2v_480"
}

Тело ответа:

json
{
  "code": 1,
  "description": "Submit Success",
  "result": "1751352955547075"
}
{
  "code": 1,
  "description": "Submit Success",
  "result": "1751352955547075"
}
  • Получите результат через result 1751352955547075
  • get https://api.openai-hk.com/mj/task/1751275590720680/fetch

Результат задачи:

  • Результат в videoUrls содержит 4 ссылки на видео
json
{
  "id": "1751275590720680",
  "action": "VIDEO",
  "customId": "",
  "botType": "",
  "prompt": "缠斗",
  "promptEn": "",
  "description": "Submit Success",
  "state": "",
  "mode": "",
  "proxy": "",
  "submitTime": 1751275590720,
  "startTime": 1751275590720,
  "finishTime": 1751275670864,
  "imageUrl": "https://abc.om/upload_1751275589663574690.jpg",
  "imageUrls": null,
  "imageHeight": 624,
  "imageWidth": 624,
  "videoUrl": "",
  "videoUrls": [
    {
      "url": "https://cdn.discordapp.com/video/5938067e-b820-4938-b3ad-69d81778cbc4/0_0.mp4"
    },
    {
      "url": "https://cdn.discordapp.com/video/5938067e-b820-4938-b3ad-69d81778cbc4/0_1.mp4"
    },
    {
      "url": "https://cdn.discordapp.com/video/5938067e-b820-4938-b3ad-69d81778cbc4/0_2.mp4"
    },
    {
      "url": "https://cdn.discordapp.com/video/5938067e-b820-4938-b3ad-69d81778cbc4/0_3.mp4"
    }
  ],
  "status": "SUCCESS",
  "progress": "100%",
  "failReason": "",
  "buttons": [],
  "maskBase64": "",
  "properties": {
    "notifyHook": "",
    "flags": 0,
    "messageId": "",
    "messageHash": "5938067e-b820-4938-b3ad-69d81778cbc4",
    "nonce": "",
    "customId": "",
    "finalPrompt": "https://cdn.discordapp.com/upload_1751275589663574690.jpg 缠斗 --ar 1:1 --v 7 --stylize 100 --relax",
    "progressMessageId": "",
    "messageContent": "",
    "discordInstanceId": "1372468820912115716",
    "discordChannelId": "1372468820912115716"
  }
}
{
  "id": "1751275590720680",
  "action": "VIDEO",
  "customId": "",
  "botType": "",
  "prompt": "缠斗",
  "promptEn": "",
  "description": "Submit Success",
  "state": "",
  "mode": "",
  "proxy": "",
  "submitTime": 1751275590720,
  "startTime": 1751275590720,
  "finishTime": 1751275670864,
  "imageUrl": "https://abc.om/upload_1751275589663574690.jpg",
  "imageUrls": null,
  "imageHeight": 624,
  "imageWidth": 624,
  "videoUrl": "",
  "videoUrls": [
    {
      "url": "https://cdn.discordapp.com/video/5938067e-b820-4938-b3ad-69d81778cbc4/0_0.mp4"
    },
    {
      "url": "https://cdn.discordapp.com/video/5938067e-b820-4938-b3ad-69d81778cbc4/0_1.mp4"
    },
    {
      "url": "https://cdn.discordapp.com/video/5938067e-b820-4938-b3ad-69d81778cbc4/0_2.mp4"
    },
    {
      "url": "https://cdn.discordapp.com/video/5938067e-b820-4938-b3ad-69d81778cbc4/0_3.mp4"
    }
  ],
  "status": "SUCCESS",
  "progress": "100%",
  "failReason": "",
  "buttons": [],
  "maskBase64": "",
  "properties": {
    "notifyHook": "",
    "flags": 0,
    "messageId": "",
    "messageHash": "5938067e-b820-4938-b3ad-69d81778cbc4",
    "nonce": "",
    "customId": "",
    "finalPrompt": "https://cdn.discordapp.com/upload_1751275589663574690.jpg 缠斗 --ar 1:1 --v 7 --stylize 100 --relax",
    "progressMessageId": "",
    "messageContent": "",
    "discordInstanceId": "1372468820912115716",
    "discordChannelId": "1372468820912115716"
  }
}

video

mjVideo

  • Результат - 4 видео

    mjVideo

Создание задачи редактирования изображения

Адрес интерфейса:/mj/submit/edits

Метод запроса:POST

Тип данных запроса:application/json

Пример запроса:

  • image поддерживает base64 или url
json
{
  "prompt": "改为白色背景",
  "image": "https://cdn.discordapp.com/attachments/1372468820912115716/1388566717961338880/hyper_realistic_3d_rendering_pink_tulip_style_686021570d5ec4451c1c120a.jpg?ex=68617307&is=68602187&hm=f939f10d79de24e3ed0f2c4dc1453c902ee6b383d13d9a1787eacfccfadb9488&",
  "notifyHook": "https://yourback.com/",
  "state": "abc"
}
{
  "prompt": "改为白色背景",
  "image": "https://cdn.discordapp.com/attachments/1372468820912115716/1388566717961338880/hyper_realistic_3d_rendering_pink_tulip_style_686021570d5ec4451c1c120a.jpg?ex=68617307&is=68602187&hm=f939f10d79de24e3ed0f2c4dc1453c902ee6b383d13d9a1787eacfccfadb9488&",
  "notifyHook": "https://yourback.com/",
  "state": "abc"
}

Тело ответа:

json
{
  "code": 1,
  "description": "Submit Success",
  "result": "1751342042863641"
}
{
  "code": 1,
  "description": "Submit Success",
  "result": "1751342042863641"
}
  • Получите результат через result 1751342042863641
  • get https://api.openai-hk.com/mj/task/1751342042863641/fetch

Результат задачи:

  • Результат в imageUrls содержит 4 ссылки на изображения
json
{
  "id": "1751342042863641",
  "action": "EDITS",
  "customId": "",
  "botType": "",
  "prompt": "Change to a white background.",
  "promptEn": "Change to a white background.",
  "description": "Submit Success",
  "state": "9",
  "submitTime": 1751342042863,
  "startTime": 1751342044141,
  "finishTime": 1751342065872,
  "imageUrl": "https://mjimg.open-hk.com/attachments/1372468820912115716/1389454090576072754/change_white_background_1651da63-85c6-45c7-9679-f42381c73c78.png?ex=6864ad76&is=68635bf6&hm=88ef2edb071faa5821250879489a3ea348b4f5504a73614ff30a81f05b1dee44&",
  "status": "SUCCESS",
  "progress": "100%",
  "failReason": "",
  "buttons": [],
  "imageUrls": [
    {
      "url": "https://cdn.midjourney.com/1651da63-85c6-45c7-9679-f42381c73c78/0_0.png"
    },
    {
      "url": "https://cdn.midjourney.com/1651da63-85c6-45c7-9679-f42381c73c78/0_1.png"
    },
    {
      "url": "https://cdn.midjourney.com/1651da63-85c6-45c7-9679-f42381c73c78/0_2.png"
    },
    {
      "url": "https://cdn.midjourney.com/1651da63-85c6-45c7-9679-f42381c73c78/0_3.png"
    }
  ],
  "videoUrls": null,
  "videoUrl": "",
  "maskBase64": "",
  "properties": {
    "finalPrompt": "Change to a white background. --ar 1:1 --v 7 --stylize 100 --fast --dref https://mjimg.open-hk.com/upload_1751342040607222256.png--fast",
    "finalZhPrompt": ""
  }
}
{
  "id": "1751342042863641",
  "action": "EDITS",
  "customId": "",
  "botType": "",
  "prompt": "Change to a white background.",
  "promptEn": "Change to a white background.",
  "description": "Submit Success",
  "state": "9",
  "submitTime": 1751342042863,
  "startTime": 1751342044141,
  "finishTime": 1751342065872,
  "imageUrl": "https://mjimg.open-hk.com/attachments/1372468820912115716/1389454090576072754/change_white_background_1651da63-85c6-45c7-9679-f42381c73c78.png?ex=6864ad76&is=68635bf6&hm=88ef2edb071faa5821250879489a3ea348b4f5504a73614ff30a81f05b1dee44&",
  "status": "SUCCESS",
  "progress": "100%",
  "failReason": "",
  "buttons": [],
  "imageUrls": [
    {
      "url": "https://cdn.midjourney.com/1651da63-85c6-45c7-9679-f42381c73c78/0_0.png"
    },
    {
      "url": "https://cdn.midjourney.com/1651da63-85c6-45c7-9679-f42381c73c78/0_1.png"
    },
    {
      "url": "https://cdn.midjourney.com/1651da63-85c6-45c7-9679-f42381c73c78/0_2.png"
    },
    {
      "url": "https://cdn.midjourney.com/1651da63-85c6-45c7-9679-f42381c73c78/0_3.png"
    }
  ],
  "videoUrls": null,
  "videoUrl": "",
  "maskBase64": "",
  "properties": {
    "finalPrompt": "Change to a white background. --ar 1:1 --v 7 --stylize 100 --fast --dref https://mjimg.open-hk.com/upload_1751342040607222256.png--fast",
    "finalZhPrompt": ""
  }
}

Запрос задач

Получение задачи по указанному ID

Адрес интерфейса:/mj/task/{id}/fetch

Метод запроса:GET

Тип данных запроса:application/x-www-form-urlencoded

Тип данных ответа:*/*

Описание интерфейса:

Параметры запроса:

Имя параметраОписание параметраТип запросаОбязательноТип данныхschema
idID задачиpathfalsestring

Статус ответа:

Код статусаОписаниеschema
200OKЗадача
401Unauthorized
403Forbidden
404Not Found

Параметры ответа:

Имя параметраОписание параметраТипschema
actionТип задачи, доступные значения:IMAGINE,UPSCALE,VARIATION,ZOOM,PAN,DESCRIBE,BLEND,SHORTENstring
buttonsarrayДоступные кнопки
  customIdИдентификатор действияstring
  emojiИконкаstring
  labelТекстstring
  styleСтиль: 2(Primary)、3(Green)integer(int32)
  typeТип, используется системой внутреннеinteger(int32)
descriptionОписание задачиstring
failReasonПричина ошибкиstring
finishTimeВремя завершенияinteger(int64)integer(int64)
idIDstring
imageUrlURL изображенияstring
progressПрогресс задачиstring
promptПромптstring
promptEnПромпт-английскийstring
propertiesobject
startTimeВремя начала выполненияinteger(int64)integer(int64)
stateПользовательский параметрstring
statusСтатус задачи, доступные значения:NOT_START,SUBMITTED,MODAL,IN_PROGRESS,FAILURE,SUCCESSstring
submitTimeВремя отправкиinteger(int64)integer(int64)

Пример ответа:

json
{
  "action": "",
  "buttons": [
    {
      "customId": "",
      "emoji": "",
      "label": "",
      "style": 0,
      "type": 0
    }
  ],
  "description": "",
  "failReason": "",
  "finishTime": 0,
  "id": "",
  "imageUrl": "",
  "progress": "",
  "prompt": "",
  "promptEn": "",
  "properties": {},
  "startTime": 0,
  "state": "",
  "status": "",
  "submitTime": 0
}
{
  "action": "",
  "buttons": [
    {
      "customId": "",
      "emoji": "",
      "label": "",
      "style": 0,
      "type": 0
    }
  ],
  "description": "",
  "failReason": "",
  "finishTime": 0,
  "id": "",
  "imageUrl": "",
  "progress": "",
  "prompt": "",
  "promptEn": "",
  "properties": {},
  "startTime": 0,
  "state": "",
  "status": "",
  "submitTime": 0
}

Получение seed изображения задачи

Адрес интерфейса:/mj/task/{id}/image-seed

Метод запроса:GET

Тип данных запроса:application/x-www-form-urlencoded

Тип данных ответа:*/*

Описание интерфейса:

Параметры запроса:

Имя параметраОписание параметраТип запросаОбязательноТип данныхschema
idID задачиpathfalsestring

Статус ответа:

Код статусаОписаниеschema
200OKMessage«string»
401Unauthorized
403Forbidden
404Not Found

Параметры ответа:

Имя параметраОписание параметраТипschema
codeinteger(int32)integer(int32)
descriptionstring
resultstring

Пример ответа:

json
{
  "code": 0,
  "description": "",
  "result": ""
}
{
  "code": 0,
  "description": "",
  "result": ""
}

Запрос задач по списку ID

Адрес интерфейса:/mj/task/list-by-condition

Метод запроса:POST

Тип данных запроса:application/json

Тип данных ответа:*/*

Описание интерфейса:

Пример запроса:

json
{
  "ids": []
}
{
  "ids": []
}

Параметры запроса:

Имя параметраОписание параметраТип запросаОбязательноТип данныхschema
conditionDTOconditionDTObodytrueПараметры запроса задачПараметры запроса задач
  idsМассив ID задачfalsearraystring

Статус ответа:

Код статусаОписаниеschema
200OKЗадача
201Created
401Unauthorized
403Forbidden
404Not Found

Параметры ответа:

Имя параметраОписание параметраТипschema
actionТип задачи, доступные значения:IMAGINE,UPSCALE,VARIATION,ZOOM,PAN,DESCRIBE,BLEND,SHORTENstring
buttonsarrayДоступные кнопки
  customIdИдентификатор действияstring
  emojiИконкаstring
  labelТекстstring
  styleСтиль: 2(Primary)、3(Green)integer(int32)
  typeТип, используется системой внутреннеinteger(int32)
descriptionОписание задачиstring
failReasonПричина ошибкиstring
finishTimeВремя завершенияinteger(int64)integer(int64)
idIDstring
imageUrlURL изображенияstring
progressПрогресс задачиstring
promptПромптstring
promptEnПромпт-английскийstring
propertiesobject
startTimeВремя начала выполненияinteger(int64)integer(int64)
stateПользовательский параметрstring
statusСтатус задачи, доступные значения:NOT_START,SUBMITTED,MODAL,IN_PROGRESS,FAILURE,SUCCESSstring
submitTimeВремя отправкиinteger(int64)integer(int64)

Пример ответа:

json
[
  {
    "action": "",
    "buttons": [
      {
        "customId": "",
        "emoji": "",
        "label": "",
        "style": 0,
        "type": 0
      }
    ],
    "description": "",
    "failReason": "",
    "finishTime": 0,
    "id": "",
    "imageUrl": "",
    "progress": "",
    "prompt": "",
    "promptEn": "",
    "properties": {},
    "startTime": 0,
    "state": "",
    "status": "",
    "submitTime": 0
  }
]
[
  {
    "action": "",
    "buttons": [
      {
        "customId": "",
        "emoji": "",
        "label": "",
        "style": 0,
        "type": 0
      }
    ],
    "description": "",
    "failReason": "",
    "finishTime": 0,
    "id": "",
    "imageUrl": "",
    "progress": "",
    "prompt": "",
    "promptEn": "",
    "properties": {},
    "startTime": 0,
    "state": "",
    "status": "",
    "submitTime": 0
  }
]