videos

Enhance a video prompt from optional multimodal context

Create an asynchronous text-only prompt-enhancement task. Successful tasks are charged after completion from actual input and output tokens; this call does not generate a video. The compatibility model field is ignored.

post/v1/videos/prompts/enhance

Request

  • Base URL: https://api.beatra.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.beatra.ai/v1/videos/prompts/enhance
  • Auth: none declared. Required headers: Idempotency-Key

Headers

x-request-idstring nullable
Idempotency-Keystring required
authorizationstring nullable

Request body

metadataobject nullable

Caller-supplied metadata; ≤16 keys, key ≤64 chars, value ≤512 chars

callback_urlstring nullable

HTTPS URL beatra will POST the final Task envelope to when the Task reaches a terminal state

callback_signing_key_idstring nullable

Optional standalone callback signing key. Omit for unsigned callback delivery; requires callback_url when provided.

modelstring

Compatibility input only. Its value and type are ignored in the first release; Beatra resolves the available prompt-enhancement model internally.

promptstring required

Required creative intent to expand into a production-ready video prompt.

durationinteger required

Target video duration in integer seconds.

aspect_ratio'adaptive' | '21:9' | '16:9' | '4:3' | '1:1' | '3:4' | '9:16' required

Target video aspect ratio. Text-only requests cannot use adaptive.

Response

Task accepted

object'task'
task_idstring required
status'queued' | 'running' | 'succeeded' | 'failed' | 'canceled' required
capabilitystring required
workload_type'model' | 'social_operation'
modelstring nullable

Caller-requested model verbatim (may be 'auto'). Null for social_operation tasks.

resolved_modelstring nullable

Actual model that ran (null until execution starts; equals model for explicit-model calls)

model_selection_reasonunknown
metadataobject nullable
inputobject nullable
outputobject nullable
created_atstring date-time required
started_atstring date-time nullable
deadline_atstring date-time nullable
completed_atstring date-time nullable
cancel_requested_atstring date-time nullable

Changes

No recorded changes to this operation across all 1 revision of this API.