Skip to content
Model infoModelsSnapshot: 15 Oct 2026

Higgsfield / Genjutsu

Genjutsu Restyle 1.0

Applies one selected visual style to existing footage while retaining source motion and audio, with optional character references.

availableClosed-source managed componentVideo editing
Official documentation (opens in a new tab)Reviewed 15 Oct 2026
12 of 27 specification fields collected
Output resolution480p, 720p, 1080pSee specification notes below
Clip durationFollows the prepared source; at most 30 seconds.See specification notes below
Input billingSee ratesHiggsfield API
Output billingSee ratesPublished units and conditions below

Specifications

Provider-documented facts. “Not collected” means we have not verified that field yet, not that the feature is unsupported.

Context / input limit
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Maximum input tokens
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Maximum output
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Reasoning
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Tool calling
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Structured output
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Streaming
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Batch processing
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Fine-tuning
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Knowledge cutoff
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Release date
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Parameters
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Architecture
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Languages
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Context caching
Not collected

No model-specific contract established. Workflow options do not prove foundation-model capabilities.

Input modalities
Text, Image, VideoSource for Input modalities (opens in a new tab)
Maximum prompt characters
10,000Source for Maximum prompt characters (opens in a new tab)

Optional prompt; default empty string.

Video input duration
At least 4 seconds; videos longer than 30 seconds use their first 30 seconds.Source for Video input duration (opens in a new tab)
Video duration
Follows the prepared source; at most 30 seconds.Source for Video duration (opens in a new tab)
Output resolutions
480p, 720p, 1080pSource for Output resolutions (opens in a new tab)

Default 720p.

Reference images
0–5 optional character images.Source for Reference images (opens in a new tab)
Input video limits
Maximum 200 MiB download, including files that will be trimmed.Source for Input video limits (opens in a new tab)
Reference image limits
Maximum 64 MiB per image; direct downloadable media URLs. Reference dimensions do not determine video dimensions.Source for Reference image limits (opens in a new tab)
Source audio handling
Original audio retained when present; no new-soundtrack control.Source for Source audio handling (opens in a new tab)
Image styles
One currently visible system preset UUID; custom/personal and multiple simultaneous styles are not exposed.Source for Image styles (opens in a new tab)
Controls not exposed
No duration, aspect ratio, FPS, seed, batch size, scene mode, provider selection or separate background-image input.Source for Controls not exposed (opens in a new tab)

Access & pricing

Prices belong to an endpoint and billing tier. A provider listing does not guarantee access for every account or region.

API model ID
higgsfield/genjutsu/restyle/v1.0
Access
Documented hosted generation route; workspace credentials, API balance and model access required. No generation submitted.
Regions
Not established
Authentication
Authorization: Key KEY_ID:KEY_SECRET; JSON requests from a server-side application.Source for Authentication (opens in a new tab)
Processing workflow
Asynchronous submission returns request_id and status_url. Poll for completed images; only queued work can be canceled.Source for Processing workflow (opens in a new tab)
Request quotas
Account- and model-specific concurrency, counting queued and processing requests. Dashboard limits are authoritative; current guide describes HTTP 400 on saturation and no standard rate-limit or Retry-After headers.Source for Request quotas (opens in a new tab)

The introductory blog advertises 20 concurrent requests after key creation. This is not assumed to be every account or model limit.

Safe request retries
Optional Idempotency-Key: 1–255 visible ASCII characters without whitespace. Same account, endpoint, body and webhook reuse the original request ID; mismatches return 422. Read status_url for current state.Source for Safe request retries (opens in a new tab)

Generation submissions only. Replays are not new generations and are not prompt caching; no expiry interval is established.

Pricing coverage
Published USD model tariffs; authenticated /estimate/{model-path} gives a configuration quote. Example credits/usd values in shared documentation are illustrative, not this model’s rate.Source for Pricing coverage (opens in a new tab)
Billing basis
Approximate source-video second rates; round source duration up after trimming to 30 seconds.Source for Billing basis (opens in a new tab)
API endpoint URL
POST https://api.higgsfield.ai/higgsfield/genjutsu/restyle/v1.0Source for API endpoint URL (opens in a new tab)
Model controls
prompt, preset_id, video_url, image_urls, resolutionSource for Model controls (opens in a new tab)
Preset catalog
GET /models/higgsfield/genjutsu/restyle/v1.0/presets, authenticated. No pagination. Invalid, hidden or unavailable styles fail preparation; no automatic substitute.Source for Preset catalog (opens in a new tab)
Reference guidance
References describe character appearance, not style preview images. Public API has no explicit reference-to-person mapping.Source for Reference guidance (opens in a new tab)

Prices retain their published currencies and billing units below.

Published billing units · original currency · observed 15 Oct 2026
CategoryUsageRateUnit
Approximate media pricing480p approximate editing1$0.318source-video second
Approximate media pricing720p approximate editing1$0.681source-video second
Approximate media pricing1080p approximate editing1$1.632source-video second

Rate conditions

  1. Approximate price, not a total quote. Source is trimmed to 30 seconds before rounding up; 8.1 seconds bills as 9.
Pricing source (opens in a new tab)

Data & enterprise terms

API content may be used for training unless the workspace opts out; processing can take 10 business days and is prospective. Enterprise agreements can differ. Request records remain while the account is active; generated files are available for at least seven days. Zero retention requires an eligible enterprise addendum. Partner/excluded-model policies can differ.

Read the service policy (opens in a new tab)

Caching

Caching can reuse earlier input processing. Availability, lifetime and billing depend on the endpoint. A cache hit still generates a new response.

01 / INITIAL INPUTProcess & retain

The system processes eligible input and retains reusable state.

02 / LATER REQUESTCheck available state

Reuse depends on matching input, session state and the cache policy.

03 / CACHE HITReuse & generate

Reusing state can reduce repeated work. Any charges follow the billing rules below.

Higgsfield API

higgsfield/genjutsu/restyle/v1.0
Not verified

No prompt-cache contract or discount established. Reusing a request ID or trained identity is not inference caching.

How it works
Not collected

No prompt-cache contract or discount established. Reusing a request ID or trained identity is not inference caching.

Minimum reusable input
Not collected

No prompt-cache contract or discount established. Reusing a request ID or trained identity is not inference caching.

Lifetime & refresh
Not collected

No prompt-cache contract or discount established. Reusing a request ID or trained identity is not inference caching.

How to enable it
Not collected

No prompt-cache contract or discount established. Reusing a request ID or trained identity is not inference caching.

Usage fields
Not collected

No prompt-cache contract or discount established. Reusing a request ID or trained identity is not inference caching.

Billing rules
Not collected

No prompt-cache contract or discount established. Reusing a request ID or trained identity is not inference caching.

Limits & data boundaries
Not collected

No prompt-cache contract or discount established. Reusing a request ID or trained identity is not inference caching.

No verified cache rate for this endpoint. An empty rate is not a zero charge.

Caching reviewed 15 Oct 2026

What the measurements say

No benchmark observations have been added for this model. We do not turn a vendor description into a performance score.

Latency and throughput depend on the host, request size, reasoning settings and load. There is no measured speed or global usage figure in this record.

The record behind the model

Why it is included

Documented hosted creative workflow with a named API contract. The sources do not establish a separately released proprietary foundation checkpoint or its exact upstream model identity; it is counted as a managed component, not a new private base model.

Classification evidence (opens in a new tab)

Sources reviewed