MMashaGPT API
К обзору модели

API-документация

Подробное подключение Task API для Kling 2.6 Motion Control

API-документация

Эндпоинт

Базовый URLhttps://api.mashagpt.ru/v1
Эндпоинт
POST
/v1/tasks/kling-2-6-motion-control
Авторизация
x-api-key: YOUR_API_KEY
илиAuthorization: Bearer YOUR_API_KEY

Как прикрепить изображение

В запрос модели файл не отправляется напрямую. Сначала загрузите файл в MashaGPT storage, получите публичный URL и передайте его в параметр inputUrls, videoUrls.

Не передавайте в JSON blob:, file://, data:, base64 или сырые байты. Storage принимает multipart/form-data с одним полем file. Подробный контракт: /v1/storage/upload.

1. Загрузить файл
curl -X POST "https://api.mashagpt.ru/v1/storage/upload" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "file=@./reference.png"

Ответ вернет URL вида https://static.mashagpt.ru/...

2. Передать URL в модель
curl -X POST "https://api.mashagpt.ru/v1/tasks/kling-2-6-motion-control" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "inputUrls": [
    "https://static.mashagpt.ru/dl/mashagpt/reference.webp"
  ]
}'

Если файл уже доступен по публичному URL, его можно передать сразу. Загрузка через MashaGPT storage надежнее для файлов с компьютера.

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

ПараметрТипОписание
prompt
stringText prompt describing the desired motion/action (max 2500 characters). Пример — The cartoon character is dancing..
inputUrls*
string[]Exactly one character reference image URL (JPEG/PNG, max 10MB, >300px, aspect ratio 2:5–5:2). Пример — ["https://example.com/character.png"].
videoUrls*
string[]Exactly one motion reference video URL (MP4/MOV, max 100MB, 3-30s duration). Пример — ["https://example.com/motion.mp4"].
characterOrientation*
stringДопустимые значения: image, video. Character orientation mode: "image" (max 10s output) or "video" (max 30s output). Пример — video.
mode
stringДопустимые значения: 720p, 1080p. Output resolution. По умолчанию — 720p.
duration*
integerExpected video duration in seconds (3-30s for video orientation, 3-10s for image orientation). Used for cost calculation. Диапазон 3–30. Пример — 10.

Пример запроса и ответа

Запрос
curl -X POST https://api.mashagpt.ru/v1/tasks/kling-2-6-motion-control \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "inputUrls": [
    "https://example.com/character.png"
  ],
  "videoUrls": [
    "https://example.com/motion.mp4"
  ],
  "characterOrientation": "image",
  "mode": "720p",
  "duration": 3
}'
Ответ
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "550e8400-e29b-41d4-a716-446655440000",
    "state": "queued"
  }
}

Асинхронная обработка

Модель работает асинхронно. После запроса вы получите taskId задачи для отслеживания статуса.

GET
/v1/tasks/{id}статус задачи
Проверка статуса задачи:
curl -X GET "https://api.mashagpt.ru/v1/tasks/{task_id}" \
  -H "x-api-key: YOUR_API_KEY"

Жизненный цикл задачи:

queued→processing→completed|failed