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/generations | Imagine |
| Текст в изображение (явный) | POST /v1/midjourney/generations/imagine | Imagine |
| Смешивание нескольких изображений | POST /v1/midjourney/generations/blend | Blend |
| Изображение в текст | POST /v1/midjourney/generations/describe | Describe |
| Редактирование изображения | POST /v1/midjourney/generations/edits | Edits |
| Увеличить плитку | POST /v1/midjourney/generations/upscale | Upscale |
| Вариация | POST /v1/midjourney/generations/variation | Variation |
| Сильная вариация | POST /v1/midjourney/generations/high-variation | High Variation |
| Слабая вариация | POST /v1/midjourney/generations/low-variation | Low Variation |
| Перегенерация | POST /v1/midjourney/generations/reroll | Reroll |
| Zoom out | POST /v1/midjourney/generations/zoom | Zoom |
| Pan | POST /v1/midjourney/generations/pan | Pan |
| Inpaint | POST /v1/midjourney/generations/inpaint | Inpaint |
| Modal (доп. параметры) | POST /v1/midjourney/generations/modal | Modal |
| Изображение в видео | POST /v1/midjourney/generations/video | Video |
| Remix (сильный / слабый) | POST /v1/midjourney/generations/remix-strong · /remix-subtle | Remix |
| Запрос задачи | GET /v1/tasks/{task_id} · /v1/midjourney/{task_id} | Запрос задачи |
См. также: Лучшие практики (опрос / повторы / отладка) · Сквозные сценарии (curl-разборы + клиентские обёртки)
Сквозной поток
Ошибки
Формат response ошибки
{
"error": {
"type": "invalid_request_error",
"message": "prompt is required"
}
}
Частые ошибки
| HTTP | type | Значение |
|---|
| 400 | invalid_request_error | Неверные параметры |
| 401 | authentication_error | Невалидный API key |
| 402 | payment_required | Недостаточно средств |
| 404 | not_found | Задача не найдена |
| 429 | rate_limit_error | Превышен rate limit |
| 500 | internal_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 | Название тарификации | Заметки |
|---|
| Imagine | midjourney@imagine[-version][-speed] | Текст в изображение / по образцу |
| Blend | midjourney@blend[-speed] | Смешивание нескольких изображений |
| Describe | midjourney@describe[-speed] | Изображение в текст |
| Edits | midjourney@edits[-speed] | Редактирование изображения |
| Upscale | midjourney@upscale[-version][-speed] | Увеличение |
| Variation | midjourney@variation[-version][-speed] | Вариация |
| High Variation | midjourney@high_variation[-version][-speed] | Сильная вариация |
| Low Variation | midjourney@low_variation[-version][-speed] | Слабая вариация |
| Reroll | midjourney@reroll[-version][-speed] | Перегенерация |
| Zoom | midjourney@zoom[-version][-speed] | Zoom out / outpaint |
| Pan | midjourney@pan[-version][-speed] | Pan outpaint |
| Inpaint | midjourney@inpaint[-version][-speed] | Вход в inpaint |
| Modal | midjourney@modal[-speed] | Дополнительные параметры inpaint |
| Video | midjourney@video / midjourney@video-720p | Изображение в видео, списывается × batch_size |
| Remix Strong | midjourney@remix_strong[-speed] | Сильный reshape (только v8 / v8.1) |
| Remix Subtle | midjourney@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.
См. цены в консоли. Неуспешные задачи полностью возвращаются.