Skip to main content

​
Identifier

Use the model identifier gpt-image-2 in the model field when calling /asset/start.

​
Capabilities

PropertyValue
Reference inputs0–10
Aspect ratios16:9, 9:16, 1:1, 4:3, 3:4 (default 9:16)
Resolutions1K, 2K, 4K (default 1K)
Tagsnew

​
Inputs

Pass reference media in the references array (0–10 items). Optional. Each item accepts exactly one of:
  • url — a direct, publicly accessible file URL
  • asset_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

​
Custom settings

These keys go inside the model_settings object of the request body.
KeyTypeDefaultAffects cost
qualityselectmediumyes(options: low, medium, high)

​
Pricing

Default parameters (1K): ~0.3 credits / generation. For exact pricing with your own parameters, call /asset/pricing with the model and any parameters that affect cost.

​
Example request

{
  "type": "image",
  "model": "gpt-image-2",
  "prompt": "Describe what you want to generate",
  "aspect_ratio": "9:16",
  "resolution": "1K"
}
See /asset/start for the full request/response reference, error codes, and code samples in cURL / Python / JavaScript.