MiniMaxMiniMax H3 Max RelightVideo → Video

Relight an existing video with MiniMax H3 Max — a sphere-render reference image sets the target lighting and the output keeps the source clip's length. Sources up to 15s, output up to 2K.

RelightVideo InputImage Input2K

Playground SDK API Advanced Usage Pricing

Install the SDK

The SDK targets Node 20+ and ships with TypeScript types.

npm install @picsart/ai-sdk

Authenticate

Create a client once with your API key — it's sent as a bearer token on every request.

import { createClient } from '@picsart/ai-sdk';

const ai = createClient({
  apiKey: process.env.PICSART_API_KEY, // sent as: Authorization: Bearer <key>
  apiUrl: 'https://api.picsart.com',
});

Run the model

Call the model with its parameters. This example uses the required ones.

import { createClient } from '@picsart/ai-sdk';

const ai = createClient({
  apiKey: process.env.PICSART_API_KEY,
  apiUrl: 'https://api.picsart.com',
});

const result = await ai.generate('minimax-h3-max-relight', {
  videoUrl: "https://cdn.example.com/input.mp4",
  imageUrls: [
    "https://cdn.example.com/input.jpg"
  ],
  resolution: "768p",
  aspectRatio: "16:9"
});

console.log(result.url); // video URL

Parameters

6 parameters. Required ones must be supplied; the rest fall back to their defaults. The API takes these same names over HTTP.

Parameter	Type	Required	Default	Details
`videoUrl` Source Video	`file (video)`	yes	`—`	max 15s
`imageUrls` Lighting Reference	`file (image[])`	yes	`—`	—
`resolution`	`enum`	no	`768p`	480p, 768p, 1080p, 2k
`aspectRatio`	`enum`	no	`16:9`	adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16
`seed` Seed	`range`	no	`—`	0–2147483647 (step 1)
`enableSafetyChecker` Safety Checker	`boolean`	no	`true`	—

Output

generate() resolves once the job completes. A video URL.

Result

{
  "items": [
    {
      "url": "https://cdn.picsart.com/…/result"
    }
  ],
  "model": "minimax-h3-max-relight"
}