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

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

Подробное подключение Task API для Kling 3.0 Text-to-Video

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

Эндпоинт

Базовый URLhttps://api.mashagpt.ru/v1
Эндпоинт
POST
/v1/tasks/kling-3-0-text-to-video
Авторизация
x-api-key: YOUR_API_KEY
илиAuthorization: Bearer YOUR_API_KEY

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

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

Не передавайте в 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-3-0-text-to-video" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "prompt": "Опишите желаемый результат",
  "imageUrls": [
    "https://static.mashagpt.ru/dl/mashagpt/reference.webp"
  ]
}'

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

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

ПараметрТипОписание
prompt*
stringText prompt describing the video (max 2000 characters). For multi-shot, this is ignored — use multiShots instead. Пример — A fashion model walking down a runway at a high-end fashion show.
aspectRatio
stringДопустимые значения: 1:1, 16:9, 9:16. Video aspect ratio. По умолчанию — 16:9.
duration
stringДопустимые значения: 3, 5, 10, 15. Video duration in seconds (for single-shot mode). По умолчанию — 5.
mode
stringДопустимые значения: std, pro, 4K. Output mode (kie.ai). std = 720p, pro = 1080p, 4K = 2160p. По умолчанию — std.
sound
booleanGenerate video with audio. Sound doubles the base price. По умолчанию — false.
imageUrls
string[]Optional first-frame (index 0) and last-frame (index 1) image URLs. Required by kie.ai when using element references. Multi-shot mode uses only the first image. Пример — ["https://example.com/first-frame.png"].
multiShots
arrayMulti-shot mode: array of scenes with prompts and durations (up to 5 shots, total 3-15s).
elements
arrayCharacter/object references for consistency across shots (max 3). Reference in prompts as @name.

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

Запрос
curl -X POST https://api.mashagpt.ru/v1/tasks/kling-3-0-text-to-video \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "prompt": "A fashion model walking down a runway at a high-end fashion show",
  "aspectRatio": "16:9",
  "duration": "5",
  "mode": "std",
  "sound": false
}'
Ответ
{
  "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