MMashaGPT API
MMashaGPT API
МоделиДокументацияТестированиеAPI-ключиПлатежи
МоделиДокументацияТестирование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 '{
  "imageUrls": [
    "https://static.mashagpt.ru/dl/mashagpt/reference.webp"
  ]
}'

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

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

ПараметрТипОписание
studioElements
arrayOwned saved Studio profiles at exact revisions. Resolved into immutable native elements before submission. Counts together with elements.
prompt
stringText prompt describing the video (max 2000 characters). Required in single-shot mode; omitted or ignored when multiShots contains scenes. Пример — 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 '{
  "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

Сводка

Основные параметры Task API.

Модельkling-3-0-text-to-video
Провайдер
Kling
Эндпоинт/v1/tasks/kling-3-0-text-to-video
Тип ответа
видео
Стоимость
от 105 ₽