VIDEO_IS_PROCESSING | Scenes cannot be modified while composing or generating (name and metadata updates are still allowed) | Wait for the current operation to complete |
VIDEO_CANNOT_COMPOSE | Video status does not allow composition | Use resetStatus if in error state, or wait for current operation |
VIDEO_CANNOT_GENERATE | Video status does not allow generation | Ensure video is in draft or composed status |
VIDEO_IS_BEING_GENERATED | A generation is already in progress | Wait for it to complete |
CANNOT_RESET_STATUS | Only error statuses can be reset | Only compose-error and generate-error can be reset |
SCENE_NOT_FOUND | Scene index out of range | Check scene count in the video |
SCENE_EMPTY_NARRATION | Scene has no narration text | Add narration text before previewing audio |
CAPTIONS_NOT_FOUND | Source entries have no captions | Add captions/transcripts to source entries before composing |
TOO_MANY_SOURCES | Too many unique b-roll source entries across all scenes | Reduce the number of distinct entryId values. Reuse entries at different startTime offsets instead of adding new sources |
AVATAR_NOT_FOUND | Invalid avatar ID | Create an avatar with avatar.upsert first |
AVATAR_TEMPLATE_NOT_FOUND | Invalid template ID | Use an ID from avatarTemplate.list |
BACKGROUND_NOT_FOUND | Invalid library background ID | Use a valid background ID from the asset library |
VIDEO_AVATAR_NOT_CONFIGURED | Video has no avatar set | Set avatarId when creating or updating the video |
INVALID_STATUS_TRANSITION | Status change not allowed | Follow the status lifecycle diagram in section 3 |