Get Asset Generator items

Retrieve a list of records. Optionally filter by ids (UUIDs) and/or a creation time window [created_after, created_before). The window selects records by when they were created; status and credits_used reflect their current state and can change until the job finishes (failed jobs are refunded and report 0 credits).

GET /api/asset_generator/

cURL

cURL

curl --request GET \
  --url https://api.creatify.ai/api/asset_generator/ \
  --header 'X-API-ID: <api-key>' \
  --header 'X-API-KEY: <api-key>'

200

[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "model_name": "<string>",
    "gen_type": "<string>",
    "failed_reason": "<string>",
    "assets": "<string>",
    "duration": 123,
    "input_params": {},
    "credits_used": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "status": "initializing",
    "aspect_ratio": "<string>",
    "output_nums": -1,
    "resolution": "<string>",
    "webhook_url": "<string>"
  }
]

Authorizations

X-API-ID · string · header · required

API ID, from your settings page.

X-API-KEY · string · header · required

API Key, from your settings page.

Query Parameters

created_after · string<date-time>

Only return records created at or after this time (inclusive). ISO 8601, e.g. 2026-09-27T00:00:00Z or 2026-09-27T00:00:00+08:00 (URL-encode '+' as %2B). Timestamps without an offset are treated as UTC.

created_before · string<date-time>

Only return records created before this time (exclusive). Same format as created_after.

ids · string

Comma-separated list of UUIDs to filter. Maximum 100 entries allowed.

Minimum string length: 1

Response

200 - application/json

id · string<uuid> · required · read-only

model_name · string · required · read-only

Name of the AI generation model used.

gen_type · string · required

Type of the AI generation model used.

failed_reason · string · required · read-only

Reason for failure if the generation failed.

assets · string · required · read-only

List of generated assets.

duration · integer · required · read-only

input_params · object · required · read-only

Input parameters used for AI generation.

credits_used · number · required · read-only

Credits used in this API call

created_at · string<date-time> · required · read-only

updated_at · string<date-time> · required · read-only

status · enum<string>

• initializing - initializing
• generating - generating
• done - done
• failed - failed

Available options: initializing, generating, done, failed

aspect_ratio · string | null

Aspect ratio of the asset

Maximum string length: 128

output_nums · integer

Number of outputs

Required range: -2147483648 <= x <= 2147483647

resolution · string | null

e.g., 1080x1920

Maximum string length: 128

webhook_url · string<uri> | null

Webhook URL for status updates. Default is null.

Maximum string length: 200