API-документация к Midjourney API
Разделы API
Токен и покупка запросов
Создание токенов и пополнение запросов производится через telegram-бот @Api_midjourney_bot
Попадание в бан
Используя сервис API Midjourney вы обязуетесь не отправлять в сервис запросы, в которых есть слова и фразы, нарушающие условия пользовательского соглашения с Midjourney inc., либо установить на своей стороне бан/спам-фильтр, не пропускающий такие слова.
Обычно это слова и фразы, связанные с насилием, наркотиками, преступлениями, ущемлением чьих либо прав, эротикой и, в некоторых случаях упоминание известных лиц (в основном скандальные лица и главы государств)
Денежные средства за неиспользованные запросы при полной блокировке одного из наших аккаунтов (по причине подобных запросов с Вашей стороны) не возвращаются
Обычно это слова и фразы, связанные с насилием, наркотиками, преступлениями, ущемлением чьих либо прав, эротикой и, в некоторых случаях упоминание известных лиц (в основном скандальные лица и главы государств)
Денежные средства за неиспользованные запросы при полной блокировке одного из наших аккаунтов (по причине подобных запросов с Вашей стороны) не возвращаются
Docs
Все HTTP запросы отправляются на адрес:
api.kolersky.com/api/midjourney/{task-type}Заголовок на установку токена:
x-token: 0000::****-****-****-****все запросы принимают (за исключениям GET запроса) и отвечают в JSON
Пример ответа с ошибкой:
Пример ответа с ошибкой:
{
"err": "bad request, missing prompt in request",
"code": 400
}Пример успешного ответа:
{
"task_id": "d497783b-****-****-****-0367bce42db6",
"status": "pending",
"output": {
"image_url": "",
"image_urls": null,
"temporary_image_urls": null,
"discord_image_url": "",
"actions": [], // avalibe actions to do
"progress": 100,
"intermediate_image_urls": null
},
"code":200
}Create Task
Imagine
Imagine
POST api.kolersky.com/api/midjourney/imagineЭта функция генерирует 4 уникальных изображения в сетке 2x2 из текстового описания, также известного как prompt. Функция соответствует команде /imagine из официального Midjourney.
Поля запроса:
Поля запроса:
JSON вид запроса:
{
"prompt": "new zealand wanaka",
"aspect_ratio": "16:9"
}cURL пример:
curl -X POST -H "x-token: 0000::****-****-****-****" --data-raw '{"prompt": "new zealand wanaka", "aspect_ratio": "16:9"}' api.kolersky.com/api/midjourney/imagineUpscale
POST api.kolersky.com/api/midjourney/upscaleЭта функция увеличивает разрешение выбранного изображения (и изолирует его). Функция соответствует команде увеличения масштаба из официального Midjourney.
JSON вид запроса:
{
"origin_task_id": "d497783b-****-****-****-0367bce42db6",
"index": "1"
}cURL пример:
curl -X POST -H "x-token: 0000::****-****-****-****" --data-raw '{"origin_task_id": "d497783b-****-****-****-0367bce42db6", "index": "1"}' api.kolersky.com/api/midjourney/upscaleVariation
POST api.kolersky.com/api/midjourney/variationЭта функция генерирует различные версии выбранного изображения, соответствующие командам Variations из официального Midjourney.
Поля запроса:
JSON вид запроса:
{
"origin_task_id": "d497783b-****-****-****-0367bce42db6",
"prompt": "winter new york",
"index": "3",
"aspect_ratio": "9:16"
}cURL пример:
curl -X POST -H "x-token: 0000::****-****-****-****" --data-raw '{"origin_task_id": "d497783b-****-****-****-0367bce42db6", "prompt": "winter new york", "index": "3", "aspect_ratio": "9:16"}' api.kolersky.com/api/midjourney/variation Reroll
POST api.kolersky.com/api/midjourney/rerollЭта функция регенерирует изображения на основе нового приглашения и родительской задачи. Эта конечная точка соответствует кнопке Re-run или Re-roll из официального Midjourney.
Поля запроса:
JSON вид запроса:
JSON вид запроса:
{
"origin_task_id": "d497783b-****-****-****-0367bce42db6",
"prompt": "winter new york",
"aspect_ratio": "9:16"
}cURL пример:
curl -X POST -H "x-token: 0000::****-****-****-****" --data-raw '{"origin_task_id": "d497783b-****-****-****-0367bce42db6", "prompt": "winter new york", "aspect_ratio": "9:16"}' api.kolersky.com/api/midjourney/reroll Describe
POST api.kolersky.com/api/midjourney/describeЭта функция выдает четыре подсказки на основе входного изображения. Конечная точка соответствует команде Describe из официального Midjourney.
Поля запроса:
JSON вид запроса:
{
"image_url": "http://midjourney-guigu.oss-us-west-1.aliyuncs.com/images/75ed4202402292139294887.jpg",
"process_mode": "fast",
}cURL пример:
curl -X POST -H "x-token: 0000::****-****-****-****" --data-raw '{"image_url": "http://midjourney-guigu.oss-us-west-1.aliyuncs.com/images/75ed4202402292139294887.jpg", "process_mode": "fast"}' api.kolersky.com/api/midjourney/describeSeed
POST api.kolersky.com/api/midjourney/seedЭта функция получает начальную информацию о выполненной задаче.
Поля запроса:
JSON вид запроса:
{
"origin_task_id": "d497783b-****-****-****-0367bce42db6",
}cURL пример:
curl -X POST -H "x-token: 0000::****-****-****-****" --data-raw '{"origin_task_id": "d497783b-****-****-****-0367bce42db6"}' api.kolersky.com/api/midjourney/seedBlend
POST api.kolersky.com/api/midjourney/blendЭта функция объединяет от двух до пяти входных изображений. Эта конечная точка соответствует команде Blend из официального Midjourney.
Поля запроса:
JSON вид запроса:
{
"image_urls": [
"https://aoyouer.com/posts/moyu-devlog-0/2022-11-24-00-59_hu3f1e0a40cb06392f97875a081976a63b_1192560_1600x0_resize_box_3.png",
"https://aoyouer.com/posts/hugo-with-codespace/2022-11-23%2013.34.47_hu1cc8e82c0c96924b0c8ea2f0980e2e30_140972_1600x0_resize_box_3.png"
],
"process_mode": "fast",
}cURL пример:
curl -X POST -H "x-token: 0000::****-****-****-****" --data-raw '{"image_urls": ["https://aoyouer.com/posts/moyu-devlog-0/2022-11-24-00-59_hu3f1e0a40cb06392f97875a081976a63b_1192560_1600x0_resize_box_3.png","https://aoyouer.com/posts/hugo-with-codespace/2022-11-23%2013.34.47_hu1cc8e82c0c96924b0c8ea2f0980e2e30_140972_1600x0_resize_box_3.png"], "process_mode": "fast"}' api.kolersky.com/api/midjourney/blendInpaint
POST api.kolersky.com/api/midjourney/inpaintЭта функция изменяет часть увеличенного изображения. Функция соответствует команде Vary (Region) из официального Midjourney.
Поля запроса:
JSON вид запроса:
{
"origin_task_id": "d497783b-****-****-****-0367bce42db6",
"mask": "... base64 string",
}cURL пример:
curl -X POST -H "x-token: 0000::****-****-****-****" --data-raw '{"origin_task_id": "d497783b-****-****-****-0367bce42db6", "mask": "... base64 string",}' api.kolersky.com/api/midjourney/inpaintOutpaint
POST api.kolersky.com/api/midjourney/outpaintЭта функция расширяет холст увеличенного изображения за пределы его исходного размера, сохраняя детали исходного изображения. Эта конечная точка соответствует инструменту Zoom Out из официального Midjourney.
Поля запроса:
Для zoom_ratio допустимые значения:
- Для кнопки Midjourney Discord "zoom out 1.5x" — используйте: 1,5
- Для кнопки Midjourney Discord "zoom out 2x" — используйте: 2
- Для кнопки Midjourney Discord "custom zoom" — используйте: (1, 2]
- Для кнопки Midjourney Discord "make square" — используйте: 1
JSON вид запроса:
{
"origin_task_id": "d497783b-****-****-****-0367bce42db6",
"zoom_ratio": "2",
"prompt": "flying night city",
"aspect_ratio": "16:9",
}cURL пример:
curl -X POST -H "x-token: 0000::****-****-****-****" --data-raw '{"origin_task_id": "d497783b-****-****-****-0367bce42db6","zoom_ratio": "2", "prompt": "flying night city", "aspect_ratio": "16:9"}' api.kolersky.com/api/midjourney/outpaintPan
POST api.kolersky.com/api/midjourney/panЭта функция расширяет изображение в выбранном направлении, сохраняя при этом исходное содержимое изображения и используя новую подсказку для заполнения расширенного пространства. Конечная точка соответствует инструменту Pan из официального Midjourney.
Поля запроса:
JSON вид запроса:
{
"origin_task_id": "d497783b-****-****-****-0367bce42db6",
"direction": "down",
"prompt": "flying city, night"
}cURL пример:
curl -X POST -H "x-token: 0000::****-****-****-****" --data-raw '{"origin_task_id": "d497783b-****-****-****-0367bce42db6", "direction": "down", "prompt": "flying city, night"}' api.kolersky.com/api/midjourney/panCancel Task
DELETE api.kolerksy.com/api/midjourney/cancelЭта функция закрывает задачу. Функцию можно вызвать только на задачи со статусом pending
Поля запроса:
JSON вид запроса:
{
"origin_task_id": "d497783b-****-****-****-0367bce42db6"
}cURL пример:
curl -X DELETE -H "x-token: 0000::****-****-****-****" --data-raw '{"task_id": "d497783b-****-****-****-0367bce42db6"}' api.kolersky.com/api/midjourney/cancelGet Task
GET api.kolerksy.com/api/midjourney/cancelФункция позволяет получить статус запрашиваемый задачи.
Это единственный запрос, который вместо JSON тела принимает query параметр.
Это единственный запрос, который вместо JSON тела принимает query параметр.
Поля запроса:
cURL пример:
curl -X GET -H "x-token: 0000::****-****-****-****" api.kolersky.com/api/midjourney/get_task?task_id=d497783b-****-****-****-0367bce42db6