Skip to main content
GET
/
api
/
public
/
v1
/
asset
/
status
/
{assetId}
curl -X GET "https://app.hoox.video/api/public/v1/asset/status/662f8c1d3a4b5e6f70123456" \
  -H "Authorization: Bearer your_api_key"

{
  "asset_id": "662f8c1d3a4b5e6f70123456",
  "status": "generating",
  "type": "video",
  "generation_params": {
    "model": "veo-3.1",
    "prompt": "A cinematic shot of a fox running through autumn leaves at sunrise.",
    "aspect_ratio": "9:16",
    "resolution": "720p",
    "duration": 8
  }
}

​
Overview

Returns the current state of an asset (generating, completed, or failed) along with its result URL and metadata once ready. Poll this endpoint to wait for a generation to complete. This endpoint reads the asset state from the database only — it does not poll the underlying provider (FAL/Kie). The asset state is kept up to date by webhooks.

​
Authentication

This endpoint requires API key authentication. Include your API key in the Authorization header.

​
Path Parameters

​
assetId
string
required
Asset ID returned by /asset/start in the asset_ids array.

​
Response

​
asset_id
string
The asset ID that was queried.
​
status
string
One of generating, completed, failed, or pending.
​
type
string
Media type: image, video, or audio.
​
url
string
URL of the generated media. Present when status is completed.
​
thumbnail_url
string
Preview thumbnail URL (first frame of the video). Videos only — omitted for images, where it would just repeat url.
​
width
number
Width in pixels of the generated media (when known).
​
height
number
Height in pixels of the generated media (when known).
​
duration_seconds
number
Duration in seconds (videos only).
​
cost
number
Credits debited for this generation.
​
created_at
string
ISO 8601 creation timestamp.
​
generation_params
object
The parameters used to generate the asset.
​
error
object
Present when status is failed.

​
Example

curl -X GET "https://app.hoox.video/api/public/v1/asset/status/662f8c1d3a4b5e6f70123456" \
  -H "Authorization: Bearer your_api_key"

{
  "asset_id": "662f8c1d3a4b5e6f70123456",
  "status": "generating",
  "type": "video",
  "generation_params": {
    "model": "veo-3.1",
    "prompt": "A cinematic shot of a fox running through autumn leaves at sunrise.",
    "aspect_ratio": "9:16",
    "resolution": "720p",
    "duration": 8
  }
}

​
Polling guidance

A typical pattern is to poll every 2–5 seconds until status is completed or failed. Most generations complete in under 2 minutes. If you provided a webhook_url when submitting, you can avoid polling entirely.