POST https://openapi.akool.com/api/open/v4/headswap/task/create. Authenticate with x-api-key or Bearer authorization. Account, plan and feature availability apply.
Regions
Published personal-data storage: AWS in the EEA or United States unless otherwise specified. This is not a guarantee of a selectable inference region.
Customer Content is stored for 365 days and users can clear it; other data categories and contractual/legal exceptions have separate retention rules.Source for Data retention (opens in a new tab)
mapping
Requires prior person analysis of the identical video URL. Supply 1–5 mappings, each using an obj_id from analysis and one reference-face image. keep_original_sound defaults true. Account entitlement is required.Source for mapping (opens in a new tab)
Endpoint pricing has not been collected. Check the provider for applicable rates.
Data & enterprise terms
Terms state customer content and usage data will not be used by Akool or third parties to train machine-learning models. Privacy policy gives Customer Content a 365-day retention period with user deletion, and AWS storage in the EEA or US unless otherwise specified. Generated-resource expiry is separate from storage retention. Contract-specific and legal exceptions apply.
Exact selector in the anonymous public application catalog. Not a guaranteed public OpenAPI model_name or immutable native checkpoint ID.
Access
Select Akool premium in the signed-in Akool web workflow. The selector is present in the public model catalog; account entitlements, credits and input validation apply. No generation was executed during review.
Regions
Published personal-data storage: AWS in the EEA or United States unless otherwise specified. This is not a guarantee of a selectable inference region.
{"prompt":{"required":false,"type":"string","default":"Generate a character animation","maxLength":500},"mappings":{"required":true,"type":"array","description":"Character images Object obj_id(Number) & img_url (PNG or JPEG)"},"video_url":{"required":true,"type":"string","maxDuration":20,"minDuration":3,"description":"Upload a front-facing video with a clearly visible face, Video length up to 120s"},"batch_count":{"required":false,"type":"number","default":1,"enum":[1],"description":"Number of videos to generate in batch"},"resolution":{"required":true,"type":"string","default":"720p","enum":["480p","720p"],"configs":[{"value":"480p","label":"480p"},{"value":"720p","label":"720p","default":true}]}}Source for parameterContract (opens in a new tab)
Public app schema, not a universal native-model limit. Conflicting descriptions and numeric fields are retained.
Numeric schema says 3–20 seconds, while its description says up to 120 seconds. Keep the stricter numeric app range visible and confirm upload validation; do not apply this range globally to the public API.Source for durationConflict (opens in a new tab)
Prices retain their published currencies and billing units below.
Published billing units · original currency · observed 14 Oct 2026
Category
Usage
Rate
Unit
Akool web application
Akool premium · 480p1
5 credits
5 seconds
Akool web application
Akool premium · 720p1
10 credits
5 seconds
Rate conditions
Published price_config unit_credit and unit_duration for this hosted selector. Native-provider API prices, cash conversion, minimum billing blocks, rounding and final account discounts are not inferred.
Terms state customer content and usage data will not be used by Akool or third parties to train machine-learning models. Privacy policy gives Customer Content a 365-day retention period with user deletion, and AWS storage in the EEA or US unless otherwise specified. Generated-resource expiry is separate from storage retention. Contract-specific and legal exceptions apply.
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.
Akool
akool-premium
Not verified
Saved media, avatar templates, voice assets and temporary result URLs do not establish prompt caching or discounted cached-input pricing.
How it works
Not collected
Saved media, avatar templates, voice assets and temporary result URLs do not establish prompt caching or discounted cached-input pricing.
Minimum reusable input
Not collected
Saved media, avatar templates, voice assets and temporary result URLs do not establish prompt caching or discounted cached-input pricing.
Lifetime & refresh
Not collected
Saved media, avatar templates, voice assets and temporary result URLs do not establish prompt caching or discounted cached-input pricing.
How to enable it
Not collected
Saved media, avatar templates, voice assets and temporary result URLs do not establish prompt caching or discounted cached-input pricing.
Usage fields
Not collected
Saved media, avatar templates, voice assets and temporary result URLs do not establish prompt caching or discounted cached-input pricing.
Billing rules
Not collected
Saved media, avatar templates, voice assets and temporary result URLs do not establish prompt caching or discounted cached-input pricing.
Limits & data boundaries
Not collected
Saved media, avatar templates, voice assets and temporary result URLs do not establish prompt caching or discounted cached-input pricing.
No verified cache rate for this endpoint. An empty rate is not a zero charge.
Caching reviewed 14 Oct 2026
Akool web app
akool-premium
Not verified
Saved media, avatar templates, voice assets and temporary result URLs do not establish prompt caching or discounted cached-input pricing.
How it works
Not collected
Saved media, avatar templates, voice assets and temporary result URLs do not establish prompt caching or discounted cached-input pricing.
Minimum reusable input
Not collected
Saved media, avatar templates, voice assets and temporary result URLs do not establish prompt caching or discounted cached-input pricing.
Lifetime & refresh
Not collected
Saved media, avatar templates, voice assets and temporary result URLs do not establish prompt caching or discounted cached-input pricing.
How to enable it
Not collected
Saved media, avatar templates, voice assets and temporary result URLs do not establish prompt caching or discounted cached-input pricing.
Usage fields
Not collected
Saved media, avatar templates, voice assets and temporary result URLs do not establish prompt caching or discounted cached-input pricing.
Billing rules
Not collected
Saved media, avatar templates, voice assets and temporary result URLs do not establish prompt caching or discounted cached-input pricing.
Limits & data boundaries
Not collected
Saved media, avatar templates, voice assets and temporary result URLs do not establish prompt caching or discounted cached-input pricing.
No verified cache rate for this endpoint. An empty rate is not a zero charge.
Caching reviewed 14 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 named hosted service, product or voice-engine selector. The underlying native checkpoint is undisclosed or explicitly supplied by a third party, so this record does not assert independent proprietary Akool weights.
