GRIKAI
API
Video APIGRIKAI API

Developer API

Video API

Queue AI video jobs, track generation status, repurpose long videos into clips, and run studio tools for images, audio, lipsync, edits, and ads.

Create jobs

Start long-running video generation and repurpose jobs. Create requests should include Idempotency-Key.

Example
curl -X POST https://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",
    "prompt": "A cinematic product reveal on a black reflective table",
    "aspect_ratio": "16:9",
    "duration": "5s",
    "mode": "standard",
    "sound": "on"
  }'
MethodEndpoint
POST/generate/video

Start text-to-video or image-to-video generation with model, aspect ratio, duration, mode, image URL, and sound options.

POST/repurpose

Start a repurposing pipeline from a YouTube or file URL with optional language.

Check status

Poll generation and repurpose records until the job reaches a terminal status.

MethodEndpoint
GET/generation/:id

Fetch a generation record, status, output video URL, metadata, file size, and any error message.

GET/repurpose/:id

Fetch a repurposing task with rendered clips, transcripts, segments, viral scores, and output URLs.

Image tools

Generate, edit, enhance, faceswap, and create character or 3D-angle assets for video workflows.

MethodEndpoint
POST/images/generate

Generate images from a prompt, reference image, palette, model, and resolution.

POST/images/edit

Edit an image with a prompt and source image URL.

POST/images/enhance

Enhance or upscale an image asset.

POST/images/faceswap

Swap a face between target and source images.

POST/images/3d-angles

Generate a 3D/360-style video from an image.

POST/images/character-gen

Generate a consistent character from a prompt and optional reference image.

Studio tools

Run speech, audio enhancement, lipsync, recast, transition, edit, and ad generation operations.

MethodEndpoint
POST/repurpose/tts

Generate speech audio from text and a voice selection.

POST/repurpose/enhance-audio

Queue audio enhancement for a source video.

POST/repurpose/lipsync

Synchronize a video with a supplied audio track.

POST/repurpose/recast

Replace or recast a character in a source video with a target image.

POST/video/transitions

Create transitions across two or more input video URLs.

POST/video/edit

Edit an existing video with a natural-language prompt.

POST/ads/generate

Generate an ad creative from a product URL.