KovAPIKovAPI
POST https://kovapi.com/v1/images/generations

Модель изображений Midjourney (Beta), по умолчанию V8.2. Промпты и параметры — как на midjourney.com; каждое задание — набор из четырёх оригинальных PNG по одной цене, а апскейл, вариации, ремикс, зум и панорама идут через тот же эндпоинт.

Попробовать в песочнице →

Быстрый старт

Асинхронное задание, как и другие вызовы изображений: отправили, получили id, опрашиваете результат. Три шага ниже — текст в изображение, результат и апскейл изображения 2.

Шаг 1: отправьте текст в изображение (параметры в конце промпта)

curl
curl https://kovapi.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "midjourney", "prompt": "a red fox sitting in a snowy birch forest at dawn, soft golden light, 35mm film photograph --ar 3:2 --v 8.2", "speed": "fast"}'

Ответ (HTTP 202)

JSON
{
  "id": "img_7f3c9a1e2b4d6f8a0c1e3b5d",
  "object": "image.generation.job",
  "status": "queued",
  "created": 1795248736,
  "model": "midjourney"
}

Шаг 2 · Опрашивайте каждые 2–3 секунды, пока status не станет succeeded или failed

curl
curl https://kovapi.com/v1/images/jobs/img_7f3c9a1e2b4d6f8a0c1e3b5d \
  -H "Authorization: Bearer YOUR_API_KEY"

В data четыре оригинальных PNG (по порядку 1–4); в actions — что можно сделать дальше.

JSON
{
  "id": "img_7f3c9a1e2b4d6f8a0c1e3b5d",
  "object": "image.generation.job",
  "status": "succeeded",
  "created": 1795248736,
  "model": "midjourney",
  "data": [
    {"url": "https://img.kovapi.com/i/5b2c0e8a1f3d4c6b9a7e2d1c0b3a4f5e.png"},
    {"url": "https://img.kovapi.com/i/0c9d8e7f6a5b4c3d2e1f0a9b8c7d6e5f.png"},
    {"url": "https://img.kovapi.com/i/7a6b5c4d3e2f1a0b9c8d7e6f5a4b3c2d.png"},
    {"url": "https://img.kovapi.com/i/3e2d1c0b9a8f7e6d5c4b3a2f1e0d9c8b.png"}
  ],
  "usage": {"images": 4, "model": "midjourney", "speed": "fast", "action": "imagine"},
  "actions": ["upscale", "vary", "remix", "reroll", "zoom", "pan"]
}

Шаг 3: продолжите задание — апскейл изображения 2 (тот же эндпоинт с task_id, action и index)

curl
curl https://kovapi.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "midjourney", "task_id": "img_7f3c9a1e2b4d6f8a0c1e3b5d", "action": "upscale", "index": 2, "mode": "subtle"}'

Полный пример (Python: отправить, дождаться, сохранить на диск)

Python
import time
import requests

BASE = "https://kovapi.com/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}


def run(body):
    job = requests.post(f"{BASE}/images/generations", headers=HEADERS, json=body).json()
    if "error" in job:
        raise SystemExit(job["error"]["message"])
    while job["status"] not in ("succeeded", "failed"):
        time.sleep(5)
        job = requests.get(f"{BASE}/images/jobs/{job['id']}", headers=HEADERS).json()
    if job["status"] == "failed":
        raise SystemExit(job["error"]["message"])
    return job

# текст в изображение, затем апскейл изображения 2
grid = run({"model": "midjourney", "prompt": "a red fox sitting in a snowy birch forest at dawn, soft golden light, 35mm film photograph --ar 3:2 --v 8.2"})
print([d["url"] for d in grid["data"]], grid["actions"])
big = run({"model": "midjourney", "task_id": grid["id"], "action": "upscale", "index": 2})
with open("midjourney-2.png", "wb") as f:
    f.write(requests.get(big["data"][0]["url"]).content)

Аутентификация

Header
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Чтобы начать, создайте API-ключ в консоли.

Параметры

ПараметрТипОбязательныйОписание
modelstringДаID модели, здесь midjourney.
promptstringНетПромпт; параметры Midjourney — в конце, как на midjourney.com (--ar, --v, --niji, --s, --c, --w, --seed, --no, --sref, --oref, --cref, --iw, --raw, --tile, --hd, --draft). Обязателен для текста в изображение, remix и edit; до 6000 символов. --repeat и {a, b} не поддерживаются.
speedstringНетrelax (по умолчанию, $0.045), fast ($0.055) или turbo ($0.10). Можно писать --relax / --fast / --turbo в промпте; это поле важнее.
imagesarrayНетИзображения-подсказки, до 5, как URL, data: URI или base64; ставятся перед промптом, как в Midjourney (вес — через --iw). При action blend — 2–5 изображений для смешивания.
sizestringНетПропорция (например, 3:2) или размер в пикселях; превращается в --ar, если в промпте его нет (--ar в промпте важнее). Edit без того и другого сохраняет пропорцию исходного изображения.
task_idstringНетЗадание, которое продолжаете (img_..., завершено, не старше 7 дней).
actionstringНетupscale (2x, mode subtle / creative), vary (strength strong / subtle), remix (новый промпт), reroll, zoom (отдаление 1–2), pan (direction), inpaint (mask); без task_id — blend (2–5 изображений) и edit (одно изображение и инструкция).
indexintegerНетКакое изображение (1–4); для одного апскейла можно не указывать.
nintegerНетТолько 1: одно задание — набор из четырёх изображений, оплачивается один раз.
callback_urlstringНетКуда отправить результат, когда задача завершится; подробнее — в разделе о вебхуках ниже.

Действия (task_id + action)

Продолжение завершённого задания (не старше 7 дней), по одному действию на каждую кнопку официального приложения; результат — новое задание по цене выбранной скорости.

actionПоляЧто делает
upscaleindex, modeАпскейл 2x: mode subtle (по умолчанию, детали сохраняются) или creative (добавляет детали); одно изображение.
varyindex, strengthЧетыре вариации изображения index: strength strong (по умолчанию) или subtle.
remixindex, prompt, strengthСохраняет композицию и переделывает по новому промпту; четыре изображения.
reroll—Заново генерирует весь набор с тем же промптом; четыре изображения.
zoomindex, zoomОтдаляет кадр: zoom 1–2 (по умолчанию 2); четыре изображения.
panindex, directionРасширяет влево / вправо / вверх / вниз (left / right / up / down); четыре изображения.
inpaintindex, mask, promptПерерисовывает только белую (или прозрачную) область маски; маска в пропорции изображения масштабируется под его размер. Доступно, когда в actions задания есть inpaint.
blendimages (2–5)Без task_id: смешивает 2–5 изображений в набор из четырёх; пропорцию укажите в prompt (например, --ar 3:2).
editimage, promptБез task_id: одно изображение и фраза о том, что изменить (V8.2 / 8.1); четыре изображения в пропорции исходного, если в промпте нет --ar и не передан size.

Цена

Оплата за задание — набор из четырёх изображений (при апскейле — одно); действия стоят как одно задание на выбранной скорости. --hd (семейство V8) — вдвое дороже, --draft на V7 — за полцены (с округлением вниз до целых кредитов); вариации и перегенерация HD-набора тоже вдвое дороже. Резервируется при отправке и полностью возвращается при неудаче.

СкоростьКредитов за изображениеUSD за изображение
relax (по умолчанию)9$0.045
fast11$0.055
turbo20$0.10

Размеры, версии и ограничения

  • Вы получаете оригинальные PNG от Midjourney (с метаданными контента, которые пишет сама Midjourney), без обрезки и масштабирования. Размер зависит от пропорции: 1:1 — 1024×1024, 3:2 — 1344×896, 16:9 — 1456×816; --hd и апскейл — 2x.
  • Версии: без указания — V8.2; --v 8.1 / 8 / 7 / 6.1 / 6 или --niji 7 / 6. --hd только для семейства V8, --draft только для V7 и V8 (черновик V8 оплачивается полностью и может прийти в виде 24 изображений).
  • --repeat / --r и перестановки {a, b} (один запрос превращается в несколько заданий) не поддерживаются; n должно быть 1.
  • До 5 изображений-подсказок, они ставятся перед промптом, как в Midjourney (вес — через --iw); референсы стиля — в --sref <URL>, омни-референсы V7 — в --oref <URL>.
  • Результаты и загруженные изображения хранятся 7 дней; более старые задания продолжить нельзя.
  • Describe (изображение в промпт) и видео Midjourney пока недоступны.

Статус задачи и поля ответа

GET /v1/images/jobs/{id} возвращает эти статусы; все поля описаны в разделе Асинхронные задачи. Опрашивайте каждые 2–3 секунды или используйте вебхук.

СтатусЧто значит
queuedВ очереди. В ответе есть queue_position (сколько задач впереди) и eta_seconds (ожидаемое время ожидания).
processingГенерируется.
succeededГотово. Результат в data[0].url, детали оплаты в usage.
failedОшибка. Причина в error; зарезервированные кредиты возвращаются полностью.

Один аккаунт выполняет до 50 задач одновременно; остальные ждут в порядке отправки, а задача, не начавшаяся за 15 минут, завершается ошибкой с полным возвратом. Записи о задачах хранятся 3 дня, ссылки на изображения — 7 дней.

Сколько ждать

Замеры 11-21: четыре изображения — около 1,5–2 минут на relax и fast, около 1,5 на turbo; апскейл около 2 минут, зум и панорама около 1,3; с изображениями-подсказками или blend около 4. В часы пик дольше.

Ошибки и возвраты

Ошибка при отправке сразу возвращается как HTTP 4xx / 5xx: задача не создаётся, ничего не списывается. О неудаче после того, как задача принята, сообщает эндпоинт задачи, а резерв возвращается полностью. Все коды перечислены в разделе Коды ошибок.

Ошибки при отправке

HTTPcodeПричинаЧто делать
400invalid_requestНе удаётся прочитать референсное изображение (битая ссылка, не изображение, больше 16MB…; в message указано, какое и почему), в /v1/images/edits нет референсного изображения, тело запроса — не JSON-объект или n — не целое число.Исправьте то, что указано в message, и отправьте снова.
400unsupported_actionНе удаётся прочитать референсное изображение (битая ссылка, не изображение, больше 16MB…; в message указано, какое и почему), в /v1/images/edits нет референсного изображения, тело запроса — не JSON-объект или n — не целое число.Исправьте то, что указано в message, и отправьте снова.
404task_not_foundНе удаётся прочитать референсное изображение (битая ссылка, не изображение, больше 16MB…; в message указано, какое и почему), в /v1/images/edits нет референсного изображения, тело запроса — не JSON-объект или n — не целое число.Исправьте то, что указано в message, и отправьте снова.
401invalid_api_keyКлюч не существует, удалён или отключён, либо отключён аккаунт.Проверьте ключ на странице API Keys в консоли.
402insufficient_quotaБаланса не хватает, чтобы зарезервировать стоимость этого запроса. Шлюз сначала резервирует максимально возможную стоимость запроса, поэтому ошибка может возникнуть и при всплеске одновременных вызовов.Если был всплеск запросов, подождите несколько секунд и повторите; в остальных случаях пополните баланс.
429rate_limit_exceededПревышен лимит запросов в минуту, заданный для этого ключа (считается за последние 60 секунд). Заголовка Retry-After нет.Подождите несколько секунд и повторите или увеличьте лимит ключа в консоли.
503service_unavailableВременный сбой на нашей стороне, например при сохранении референсного файла; /v1/responses также отвечает 503 с Retry-After, когда временно не может принять запрос.Повторите чуть позже.

Неудачные задачи (status — failed)

codeКогда возникаетЧто делать
moderation_blockedИзображение: система безопасности поставщика модели отклонила промпт или референсное изображение (код может быть и content_policy_violation).Перепишите промпт или замените референс; повторная отправка без изменений обычно снова отклоняется.
upstream_errorЛюбая другая ошибка: автоматические повторы не помогли, задача ждала 15 минут и так и не запустилась, поставщик отказал без объяснения причины и т. п.; что именно произошло, указано в message.Обычно повторная отправка проходит успешно.

Вебхуки вместо опроса

Добавьте при отправке callback_url — как только задача завершится, успешно или с ошибкой, шлюз отправит на этот URL ровно то же, что возвращает эндпоинт опроса; запрос подписан, а при неудачной доставке повторяется. Общий адрес для всего аккаунта можно также задать в консоли, в разделе «Настройки → Вебхуки». Документация по вебхукам →

curl · callback_url
curl https://kovapi.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "midjourney", "prompt": "a red fox sitting in a snowy birch forest at dawn, soft golden light, 35mm film photograph --ar 3:2 --v 8.2", "callback_url": "https://your-domain.com/webhook"}'