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

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

Подробное подключение Task API для Wan 2.7 Video Edit

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

Эндпоинт

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

Как прикрепить видео

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

Не передавайте в 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.mp4"

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

2. Передать URL в модель
curl -X POST "https://api.mashagpt.ru/v1/tasks/wan-2-7-videoedit" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "video": "https://static.mashagpt.ru/dl/mashagpt/reference.mp4",
  "prompt": "Опишите желаемый результат"
}'

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

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

ПараметрТипОписание
video
stringInput video to edit (mp4/mov). Alias for videoUrl; one of video or videoUrl is required. Пример — https://example.com/video.mp4.
videoUrl
stringInput video URL to edit (mp4/mov). Alias for video; one of video or videoUrl is required. Пример — https://example.com/video.mp4.
prompt*
stringEditing instructions or style transfer description. Пример — Make the scene look like a cinematic film noir.
negativePrompt
stringNegative prompt (max 500 characters).
referenceImage
stringReference image for reference-based editing (jpg/png/bmp/webp).
resolution
stringДопустимые значения: 720p, 1080p. Output video resolution. По умолчанию — 1080p.
aspectRatio
stringДопустимые значения: auto, 16:9, 9:16, 1:1, 4:3, 3:4. Aspect ratio of the output video. 'auto' uses the input video's aspect ratio. По умолчанию — auto.
duration
integerDuration of the output video in seconds. Use 0 or omit for auto. Диапазон 0–10.
audioSetting
stringДопустимые значения: auto, origin. Audio behavior for edited video. 'auto': model decides whether to regenerate audio. 'origin': keep the original audio. По умолчанию — auto.
seed
integerRandom seed for reproducible generation (0-2147483647). Диапазон 0–2147483647.
promptExtend
booleanEnable KIE prompt expansion.
watermark
booleanAdd provider watermark.

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

Запрос
curl -X POST https://api.mashagpt.ru/v1/tasks/wan-2-7-videoedit \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "prompt": "Make the scene look like a cinematic film noir",
  "resolution": "1080p",
  "aspectRatio": "auto",
  "audioSetting": "auto"
}'
Ответ
{
  "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