CRcreatify
ai_editing

GET /api/ai_editing/

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.

orderingstring

Which field to use when ordering the results.

Response

idstring uuid required
status'pending' | 'in_queue' | 'running' | 'failed' | 'done' | 'rejected' required
  • pending - Pending
  • in_queue - In Queue
  • running - Running
  • failed - Failed
  • done - Done
  • rejected - Rejected
failed_reasonstring required

Failed reason

video_outputstring nullable required

Video output URL

previewstring nullable required

Preview URL

editor_urlstring nullable required

Editor URL for the video. Expires in 24 hours. Available only if your API account has API editor access enabled. , expires in 24 hours.

is_hiddenboolean required

Is the video hidden in the website projects page

progressnumber double required

Progress of the job

credits_usednumber required

Credits used in this API call

durationinteger required

Duration of the video in seconds

media_jobstring nullable required
permission_type'private' | 'workspace' | 'public' required
  • private - Private
  • workspace - Workspace
  • public - Public
created_atstring date-time required
updated_atstring date-time required
namestring
scriptstring nullable

Text to be converted to video

is_talking_videoboolean

Whether the video is talking video or not

is_one_person_in_videoboolean

Whether the video is one person video or not

audio_urlstring nullable

Audio to be used for the video

video_urlstring nullable

Video to be used for the video

sizenumber double

Size of the video

created_from_apiboolean

Flow is created from api or not

caption_settingunknown
background_music_urlstring uri nullable

Background music URL for the video. Default is null, video will use random music.

background_music_volumenumber double nullable

Volume of the background music, ranging from 0.0 to 1.0. Default is null, video will use default music volume of visual_style.

voiceover_volumenumber double nullable

Volume of the voiceover, ranging from 0.0 to 1.0. Default is null, video will use default voiceover volume of visual_style.

webhook_urlstring uri nullable

Webhook URL for status updates. Default is null.

userinteger nullable required
workspacestring uuid nullable required
brandstring uuid nullable

Changes

  • 8423ba73b422Revision changes
    • info

      added the new optional query request parameter created_after

    • info

      added the new optional query request parameter created_before