Video APIGRIKAI API

Developer API

Video API

Ставьте AI video jobs в очередь, отслеживайте generation status, режьте длинные видео на clips и запускайте studio tools для images, audio, lipsync, edits и ads.

Create jobs

Запускайте long-running video generation и repurpose jobs. Create requests должны включать Idempotency-Key.

Пример
curl -X POST https://api.grik.io/api/v1/generate/video \
  -H "Authorization: Bearer GRIK_API_KEY" \
  -H "Idempotency-Key: video_job_123" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling",
    "task_type": "multi-image2video",
    "prompt": "A cinematic product reveal on a black reflective table",
    "aspect_ratio": "16:9",
    "duration": "5s",
    "mode": "standard",
    "sound": "on",
    "image_list": [
      {"image": "BASE64_IMAGE_1"},
      {"image": "BASE64_IMAGE_2"}
    ]
  }'
GET/rico/workflows

Показывает recipes и разрешённые executor workflows RICO Supercomputer для web, MCP, CLI и API.

Авторизация: API keyОбласть: rico.media or videoАудитория: Разработчики
GET/rico/recipes

Показывает только recipes RICO Supercomputer.

Авторизация: API keyОбласть: rico.media or videoАудитория: Разработчики
POST/rico/sessions

Создаёт RICO Supercomputer session с brief, recipe, inputs, cost estimate, messages и pending steps.

Авторизация: API keyОбласть: rico.media or videoАудитория: Разработчики
POST/rico/sessions/:id/approve

Подтверждает RICO Supercomputer session, списывает RICO media credits и ставит deterministic execution в очередь.

Авторизация: API keyОбласть: rico.media or videoАудитория: Разработчики
POST/rico/mcp

Вызывает RICO MCP endpoint с tools вроде rico_estimate_cost, rico_apply_effect, rico_repurpose и rico_get_job.

Авторизация: API keyОбласть: rico.media or videoАудитория: Разработчики
POST/generate/video

Запускает text-to-video или image-to-video generation с model, aspect ratio, duration, mode, image URL и sound options.Передавайте Idempotency-Key только для create/retry запросов, где он реально реализован.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/kling/videos/effects

Ставит Kling Video Effects Center task в очередь по effect_scene с single-image или dual-image input.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/kling/lipsync

Ставит Kling advanced lip-sync в очередь и отслеживает его через реестр provider tasks.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/kling/multi-elements

Ставит Kling multi-elements video editing task в очередь.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/repurpose

Запускает repurposing pipeline из YouTube или file URL с optional language.Передавайте Idempotency-Key только для create/retry запросов, где он реально реализован.

Авторизация: API keyОбласть: videoАудитория: Разработчики

Проверить status

Опрашивайте generation и repurpose records, пока job не достигнет terminal status.

GET/rico/sessions

Показывает recent RICO Supercomputer sessions для authenticated account.

Авторизация: API keyОбласть: rico.media or videoАудитория: Разработчики
GET/rico/sessions/:id

Возвращает RICO Supercomputer session с messages, workflow steps, status и current assets.

Авторизация: API keyОбласть: rico.media or videoАудитория: Разработчики
GET/rico/sessions/:id/events

Возвращает polling-friendly RICO session timeline с messages, steps и assets.

Авторизация: API keyОбласть: rico.media or videoАудитория: Разработчики
POST/rico/sessions/:id/messages

Добавляет user или assistant message в существующую RICO session.

Авторизация: API keyОбласть: rico.media or videoАудитория: Разработчики
GET/rico/sessions/:id/assets

Показывает media assets, созданные RICO Supercomputer session.

Авторизация: API keyОбласть: rico.media or videoАудитория: Разработчики
GET/rico/assets

Показывает recent RICO media assets.

Авторизация: API keyОбласть: rico.media or videoАудитория: Разработчики
POST/rico/assets

Загружает или регистрирует RICO media asset через multipart file, URL или data URL.

Авторизация: API keyОбласть: rico.media or videoАудитория: Разработчики
GET/rico/assets/:id

Показывает один RICO media asset по id.

Авторизация: API keyОбласть: rico.media or videoАудитория: Разработчики
GET/generation/:id

Возвращает generation record, status, output video URL, metadata, file size и error message.

Авторизация: API keyОбласть: videoАудитория: Разработчики
GET/kling/tasks/:id

Возвращает любую Kling provider task по local task ID, provider task ID или external task ID.

Авторизация: API keyОбласть: videoАудитория: Разработчики
GET/repurpose

Показывает recent repurpose jobs.

Авторизация: API keyОбласть: videoАудитория: Разработчики
GET/repurpose/:id

Возвращает repurposing task с rendered clips, transcripts, segments, viral scores и output URLs.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/repurpose/:id/retry

Повторяет failed repurpose job.

Авторизация: API keyОбласть: videoАудитория: Разработчики
DELETE/repurpose/:id

Удаляет repurpose job по id.

Авторизация: API keyОбласть: videoАудитория: Разработчики
PUT/repurpose/:task_id/clip/:clip_id

Обновляет clip edit state для repurpose task.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/repurpose/:task_id/clip/:clip_id/render-captions

Рендерит repurpose clip с timeline edits и optional burned captions.

Авторизация: API keyОбласть: videoАудитория: Разработчики

Image tools

Generate, edit, enhance, faceswap, character и 3D-angle assets для video workflows.

POST/images/generate

Генерирует images по prompt, reference image, palette, model и resolution. Kling models идут через реестр provider tasks.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/kling/images/generations

Ставит Kling image generation в очередь напрямую с model_name, n, aspect ratio, references и provider task status.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/kling/general/ai-multi-shot

Ставит Kling AI Multi-Shot в очередь по одному frontal image и сохраняет все returned shots в media library.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/kling/images/kolors-virtual-try-on

Ставит Kling Kolors virtual try-on в очередь с human и cloth images.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/images/edit

Редактирует image по prompt и source image URL.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/images/enhance

Улучшает или upscale image asset.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/images/faceswap

Делает face swap между target и source images.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/images/3d-angles

Генерирует 3D/360-style video из image.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/images/character-gen

Создает consistent character из prompt и optional reference image.

Авторизация: API keyОбласть: videoАудитория: Разработчики

Studio tools

Запускайте speech, audio enhancement, lipsync, recast, transition, edit и ad generation operations.

POST/kling/image-recognize

Запускает Kling image recognition и segmentation utilities для object, head, face и clothing masks.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/kling/audio/text-to-audio

Ставит Kling text-to-audio generation в очередь и сохраняет audio в media library.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/kling/audio/video-to-audio

Ставит Kling video-to-audio generation в очередь для переданного video source.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/kling/lipsync/identify-face

Определяет faces для Kling lip-sync workflows перед созданием final lip-sync task.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/kling/voices

Создает Kling custom voice task.

Авторизация: API keyОбласть: videoАудитория: Разработчики
GET/kling/voices

Показывает Kling custom voices.

Авторизация: API keyОбласть: videoАудитория: Разработчики
GET/kling/voices/:id

Показывает одну Kling custom voice task по id.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/kling/voices/delete

Ставит удаление Kling custom voice в очередь.

Авторизация: API keyОбласть: videoАудитория: Разработчики
GET/kling/voices/presets

Показывает Kling preset voices для audio и avatar tools.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/kling/elements

Создает Kling advanced custom elements для multi-element video editing.

Авторизация: API keyОбласть: videoАудитория: Разработчики
GET/kling/elements

Показывает Kling advanced custom elements.

Авторизация: API keyОбласть: videoАудитория: Разработчики
GET/kling/elements/:id

Показывает один Kling advanced custom element по id.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/kling/multi-elements/init-selection

Инициализирует Kling multi-elements selections для editing workflows.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/kling/multi-elements/add-selection

Добавляет Kling multi-elements selection.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/kling/multi-elements/delete-selection

Удаляет Kling multi-elements selection.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/kling/multi-elements/clear-selection

Очищает все Kling multi-elements selections.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/kling/multi-elements/preview-selection

Preview Kling multi-elements selection.

Авторизация: API keyОбласть: videoАудитория: Разработчики
GET/kling/multi-elements

Показывает Kling multi-elements tasks.

Авторизация: API keyОбласть: videoАудитория: Разработчики
GET/kling/multi-elements/:id

Показывает одну Kling multi-elements task по id.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/repurpose/tts

Генерирует speech audio из text и voice selection.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/repurpose/enhance-audio

Ставит audio enhancement для source video в очередь.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/repurpose/lipsync

Синхронизирует video с переданным audio track.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/repurpose/recast

Заменяет или recast персонажа в source video по target image.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/video/transitions

Создаёт transitions между двумя или более input video URLs.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/video/edit

Редактирует existing video по natural-language prompt.

Авторизация: API keyОбласть: videoАудитория: Разработчики
POST/ads/generate

Генерирует ad creative из product URL.

Авторизация: API keyОбласть: videoАудитория: Разработчики
GET/broll/search

Ищет B-roll media для repurpose и editing workflows.

Авторизация: API keyОбласть: videoАудитория: Разработчики