Doitong

Director agents available to this Doitong account: its own agents and the shared default Kate, plus ready-made agents for kinds of film (under available, each with a task key and its shooting manner). Free.

list_agents

Ready-made Doitong effects and templates: name, one-line description, category, poster, preview clip, estimated price in credits and the inputs each needs (usually a photo and a choice). Free.

list_effects

Film projects on this Doitong account, newest first, with their storyboard_id. Free.

list_films

The images, videos and music this Doitong account has generated, newest first, with links. Cursor-paged. Free.

list_media_library

Trending Doitong video formats made with the person's own photos: title, what the result looks like, preview clip, format, how many photos it takes and the price at 480p and 720p. Free.

list_trends

Pauses a film shooting run after the step in progress. Nothing is lost; film_run_resume continues it. Free.

film_run_pause

Creates a short-lived upload slot for a large image or reference video. The client PUTs the file bytes to upload_url with the returned upload_headers, then passes media_url to create_storyboard. No credits.

prepare_media_upload

Reports a generated image, video or track (media_id from list_media_library) as objectionable. The Doitong team reviews every report. Free.

report_content

Resumes a paused or holding film shooting run. It goes on spending credits within the ceiling confirmed at film_run_start; if the ceiling cannot cover the next scene, nothing resumes and the reply says so.

film_run_resume

Runs an effect from list_effects on the given inputs in the person's Doitong account. Paid. Without confirm it returns the estimated price in credits and starts nothing. With confirm: true, expected_cost equal to that price and the op_id from the quote, it starts the effect and returns run_id and kind: an image is read with image_result (picture_id = run_id), a video with video_result (job_id = run_id), and a film with film_status (storyboard_id).

run_effect

Makes a trend video from list_trends with the person's photos (public https URLs, one per photo label, in order). Paid. Without confirm it returns the price in credits and starts nothing. The confirmed call carries expected_cost and op_id from the quote and rights_confirmed: true, meaning the person has the right to use the faces in the photos. Returns a job_id for video_result.

run_trend

Sets the director agent of a film, by agent_id of an agent the account has or by the task key of a ready-made agent from list_agents (the account then gets its own copy). The agent's rules shape how the film's scenes are prepared and shot. Free.

set_film_agent

Starts shooting a film with its director agent, scene by scene: prepare, shoot, check the footage, next scene. Paid. Without confirm it returns the total price in credits, the run's ceiling and a quote_id, and starts nothing. With confirm: true, expected_cost equal to that total, expected_ceiling and the quote_id it starts. Optional from and to limit the scenes, and budget_credits sets the ceiling; the run never spends past that ceiling or this connection's limit, and it holds before any decision that costs more. Credits spent on shot scenes are not returned.

film_run_start

Stops a film shooting run. Scenes already shot stay in the film and their credits are not returned; shooting again takes a new film_run_start with a new price.

film_run_stop

Uploads an image, or a 2 to 15 second video or audio clip, to the person's Doitong account for use as a reference in generate_video. Returns a public file_url. No generation, no credits.

upload_media