Creatify Ad Agent

Returns a text file from the project (index.html, stage.js, ...) with line numbers. Text files only.

Uploads an image, video or audio file from the project and returns its URL. On free plans, videos are watermarked.

Renders index.html, runs the ship gate and uploads the take as an async task (1 credit, refunded if the gate fails). The finished result has video_url, take and library_url.

Returns an Ad Agent task's status, waiting up to `wait` seconds for it to finish. A finished clip's result includes `probe` and a contact `sheet` path; show_sheet=true attaches the sheet image.

Transcribes a clip or track (ElevenLabs Scribe) as an async task: word timings, plus differences from the script when one is given. 0.05 credit per minute of media, at least 0.1.

Returns an image from the project (or a video's first frame), downscaled to max_edge.

Speaks one or more lines in one voice (several lines are written as out_1.wav, out_2.wav, ...) as an async task. The voice is designed from a description or cloned from samples the user has the rights to use (e.g. a character from an earlier take). Returns task_id and the credit cost.

Creates or overwrites a text file in the project.

Upload a file to the workspace CDN — ONLY for callers that can run shell commands / send HTTP requests themselves . If you are not capable of sending HTTP requests to an endpoint, call ``upload_file_widget`` instead and ask the user to drop the file into the panel. Two modes, keyed on ``base64_content``: - ``base64_content`` OMITTED → **presigned** (preferred, any size): returns ``{"upload_url", "cdn_url", "storage_path", "content_type", "expires_in"}``. PUT the bytes to ``upload_url`` (sending ``Content-Type: <content_type>`` when provided), then reference ``cdn_url`` from other tools. Bytes stream client → S3; nothing goes through the model. NOTE: ``cdn_url`` is dead until your PUT completes — never pass it to other tools before then. This is the path the upload widget drives. If you cannot send HTTP requests or the endpoint is blocked, call ``upload_file_widget`` instead. - ``base64_content`` GIVEN → **inline** (tiny blobs only, <= ~1.5 MB): decode + upload in one call. ONLY pass bytes you actually hold — read from a real file or returned by an API. NEVER construct base64 from an image you can merely see in the chat: you do not have access to attachment bytes, and fabricated base64 fails validation or uploads corrupt data. For a file on the user's machine, call ``upload_file_widget`` instead. Returns ``{"cdn_url", "storage_path", "content_type", "bytes_uploaded"}``. Larger bodies are rejected and can exceed the transport's request-size limit, so omit it and use the presigned mode. Mirrors ``api.views.uploads.ApiUploadView``'s two modes over MCP.

Opens a panel where the user can pick a local file to upload to their workspace. The panel uploads it from the browser and posts the file's URL into the chat. For clients that cannot send HTTP requests, including files attached to the chat.