Search

Filter by craft attribute

Filter frames by cinematography attributes — no text query needed. Combine any filters. Common spellings ("close-up", "magic hour") are normalised for you; anything unrecognised comes back in meta.hint rather than as a silent empty result.

Cost: 2 credits. $1 = 1,000 credits. Returns 402 when the balance is short.

post/browse

Request

  • Base URL: https://framethrower.ai/api/v1
  • URL: https://framethrower.ai/api/v1/browse
  • Auth: HTTP bearer

Request body

shot_type'medium' | 'closeup' | 'wide' | 'fullbody' | 'establishing'

Shot size

lens_character'anamorphic' | 'spherical' | 'vintage_soft'

Lens character

setting'interior' | 'exterior' | 'both'

Interior or exterior

time_of_day'night' | 'day' | 'interior_indeterminate' | 'golden_hour' | 'dusk' | 'blue_hour' | 'dawn' | 'overcast'

Time of day

camera_angle'eye_level' | 'high_angle' | 'low_angle' | 'top_down' | 'overhead' | 'worms_eye' | 'dutch_angle' | 'pov' | 'birds_eye'

Camera angle

visual_style'live_action' | 'cg_stylized' | 'anime' | 'cg_photorealistic' | 'cartoon_2d' | 'stop_motion' | 'mixed_media' | 'rotoscope' | 'noir' | 'watercolor' | 'minimalist' | 'documentary' | 'expressionist' | 'painterly' | 'surreal'

Visual style

directorstring

Free text, e.g. "Ridley Scott"

genrestring

Free text, e.g. "Science Fiction"

erastring

Depicted era, e.g. "1980s", "near_future"

year_mininteger
year_maxinteger
limitinteger

Response

Matching frames

metaobject

Changes

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