CRcreatify
asset_generator

GET /api/asset_generator/

Changed on

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).

Request

  • The document declares no server URL.
  • Auth
    API key in header X-API-ID and API key in header X-API-KEY

Query parameters

created_afterstring 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_beforestring date-time

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

idsstring

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

Response

idstring uuid required
model_namestring required

Name of the AI generation model used.

gen_typestring required

Type of the AI generation model used.

status'initializing' | 'generating' | 'done' | 'failed'
  • initializing - initializing
  • generating - generating
  • done - done
  • failed - failed
failed_reasonstring required

Reason for failure if the generation failed.

assetsstring required

List of generated assets.

aspect_ratiostring nullable

Aspect ratio of the asset

output_numsinteger

Number of outputs

durationinteger required
resolutionstring nullable

e.g., 1080x1920

input_paramsobject required

Input parameters used for AI generation.

webhook_urlstring uri nullable

Webhook URL for status updates. Default is null.

api_key_idstring uuid nullable required

ID of the API key that created this generation.

api_key_namestring nullable required

Name of the API key that created this generation.

credits_usednumber required

Credits used in this API call

created_atstring date-time required
updated_atstring date-time required

Changes

  • 8423ba73b422Revision changes
    • info

      added the new optional query request parameter created_after

    • info

      added the new optional query request parameter created_before

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status