Identifier
Use the model identifierkling-v3-standard in the model field when calling /asset/start.
Capabilities
Inputs
This model takes named media inputs. Pass each one as a top-level field in the request body. Each field accepts exactly one ofurl, asset_id, or avatar_id.
url— a direct, publicly accessible file URLasset_id— the ID of an existing asset in your Hoox space (e.g. a previous generation)avatar_id— the ID of an avatar defined in your Hoox space
references array is also accepted, mapped onto the slots in the order above.
Elements
Elements are named characters or objects you inject in the generation, each described by several images of the same subject. You then refer to them in the prompt with@name, so the model knows exactly which subject a sentence is about.
Pass up to 4 of them in the elements array:
Rules enforced by the API:
- Each element needs at least 2 images.
- The prompt must reference every element as
@name— otherwise the element would be ignored and the generation charged for nothing. - Names must be unique, and cannot be
refNorelementN(reserved for the internal rewriting of prompt references). first_frameis required whenever you use elements.
Example with elements
Custom settings
These keys go inside themodel_settings object of the request body.
Pricing
Default parameters (5s): ~13 credits / generation. For exact pricing with your own parameters, call/asset/pricing with the model and any parameters that affect cost.
Example request
/asset/start for the full request/response reference, error codes, and code samples in cURL / Python / JavaScript.
