start_agent_chat
Start a chat with the editor agent in a video you can edit. WithoutvideoId, it first makes a new, empty video for the chat. Returns the chatId, the videoId and the url that opens the chat in the editor.
What the agent should do, in full: it is all the agent knows. Up to 20,000 characters.
The model the agent runs on, as in the editor’s model picker:
claude-fable-5-2, claude-opus-5-5, claude-sonnet-5-5, claude-haiku-5-5, gpt-6-astra, gpt-6.1-sol, gpt-6.1-terra or gpt-6-luna. Left out, claude-sonnet-5-5. claude-fable-5-2 isn’t available to workspaces set up for zero data retention.How hard the model thinks:
low, medium, high, xhigh or max. More effort takes longer and spends more AI Credits. Left out, the model’s usual effort (medium for most). gpt-6.1-terra stops at high.list_agent_chats
List the agent chats in a video, most recently active first. Each has astatus: running while a turn is working, waiting_for_answer when the agent asked something (answer it at the chat’s url), and idle once its turn ended. lastReply is the agent’s last reply. Call it every minute or so to follow a chat you started.