Перейти к основному содержанию
Base URL: https://api.apimart.aiAuth: Authorization: Bearer <token>Новые маршруты /v1/midjourney/... автоматически внедряют model=midjourney; не нужно передавать model в теле запроса.

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

# 1. Отправить задачу Imagine
curl -X POST https://api.apimart.ai/v1/midjourney/generations \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a cute cat, watercolor style --ar 16:9"}'

# 2. Опрашивайте единый API задач до status=completed
curl https://api.apimart.ai/v1/tasks/task_01JWXXXX \
  -H "Authorization: Bearer <token>"

# 3. Увеличить изображение 1
curl -X POST https://api.apimart.ai/v1/midjourney/generations/upscale \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"task_id": "task_01JWXXXX", "index": 1}'

Обзор API

Полный список полей, примеров и заметок по каждой функции — на соответствующей подстранице.
ФункцияПутьДокументация
Текст в изображение (по умолчанию)POST /v1/midjourney/generationsImagine
Текст в изображение (явный)POST /v1/midjourney/generations/imagineImagine
Смешивание нескольких изображенийPOST /v1/midjourney/generations/blendBlend
Изображение в текстPOST /v1/midjourney/generations/describeDescribe
Редактирование изображенияPOST /v1/midjourney/generations/editsEdits
Увеличить плиткуPOST /v1/midjourney/generations/upscaleUpscale
ВариацияPOST /v1/midjourney/generations/variationVariation
Сильная вариацияPOST /v1/midjourney/generations/high-variationHigh Variation
Слабая вариацияPOST /v1/midjourney/generations/low-variationLow Variation
ПерегенерацияPOST /v1/midjourney/generations/rerollReroll
Zoom outPOST /v1/midjourney/generations/zoomZoom
PanPOST /v1/midjourney/generations/panPan
InpaintPOST /v1/midjourney/generations/inpaintInpaint
Modal (доп. параметры)POST /v1/midjourney/generations/modalModal
Изображение в видеоPOST /v1/midjourney/generations/videoVideo
Remix (сильный / слабый)POST /v1/midjourney/generations/remix-strong · /remix-subtleRemix
Запрос задачиGET /v1/tasks/{task_id} · /v1/midjourney/{task_id}Запрос задачи
См. также: Лучшие практики (опрос / повторы / отладка) · Сквозные сценарии (curl-разборы + клиентские обёртки)

Сквозной поток

Ошибки

Формат response ошибки

{
  "error": {
    "type": "invalid_request_error",
    "message": "prompt is required"
  }
}

Частые ошибки

HTTPtypeЗначение
400invalid_request_errorНеверные параметры
401authentication_errorНевалидный API key
402payment_requiredНедостаточно средств
404not_foundЗадача не найдена
429rate_limit_errorПревышен rate limit
500internal_errorОшибка сервера

Сбои задач

Частые значения fail_reason:
  • Banned prompt detected — запрещённое содержимое промпта
  • Task timeout — таймаут задачи (авто-возврат после 30+ минут)
  • No available upstream — сервис временно недоступен, повторите позже

Тарификация

Единое название модели для новых MJ-маршрутов — midjourney. Ключи тарификации генерируются из action, version и speed. Обычный порядок сопоставления:
midjourney@<action>-<version>-<speed>
-> midjourney@<action>-<version>
-> midjourney@<action>-<speed>
-> midjourney@<action>
-> midjourney
ActionНазвание тарификацииЗаметки
Imaginemidjourney@imagine[-version][-speed]Текст в изображение / по образцу
Blendmidjourney@blend[-speed]Смешивание нескольких изображений
Describemidjourney@describe[-speed]Изображение в текст
Editsmidjourney@edits[-speed]Редактирование изображения
Upscalemidjourney@upscale[-version][-speed]Увеличение
Variationmidjourney@variation[-version][-speed]Вариация
High Variationmidjourney@high_variation[-version][-speed]Сильная вариация
Low Variationmidjourney@low_variation[-version][-speed]Слабая вариация
Rerollmidjourney@reroll[-version][-speed]Перегенерация
Zoommidjourney@zoom[-version][-speed]Zoom out / outpaint
Panmidjourney@pan[-version][-speed]Pan outpaint
Inpaintmidjourney@inpaint[-version][-speed]Вход в inpaint
Modalmidjourney@modal[-speed]Дополнительные параметры inpaint
Videomidjourney@video / midjourney@video-720pИзображение в видео, списывается × batch_size
Remix Strongmidjourney@remix_strong[-speed]Сильный reshape (только v8 / v8.1)
Remix Subtlemidjourney@remix_subtle[-speed]Слабый reshape (только v8 / v8.1)
Заметки:
  • speed=relax или отсутствие speed не добавляет суффикс speed; fast / turbo добавляют соответствующий суффикс.
  • Основные версии нормализуются к v8.1, v7, v6.1, v5.2, v5.1.
  • niji=true + version=7/6 нормализуется к niji7 / niji6.
См. цены в консоли. Неуспешные задачи полностью возвращаются.