Chat commands

Type @ in the composer to point the agent at something specific. You can mention an object in your Blender scene, turn on image or video generation, or name a reference image.

The @ menu

Type @ at the start of the prompt or after a space. Keep typing to filter the menu.

It lists these groups, in order:

The item you pick becomes a chip in the prompt. Press Backspace right after a chip to delete it.

Mention scene objects

The menu lists every object in your open scene, hidden ones included, grouped by type. Type the start of a name to find it:

The agent gets the object’s exact name, so it acts on the right one even when names look alike, like Cube.001 and Cube.002.

• The list is read from Blender each time you open the menu.
• If an object is missing, check its name in Blender’s Outliner, then click Refresh.

Only objects are listed. For materials, collections or anything else, describe them in words, or select them in Blender and say the selected objects.

@image

Pick @image to make one image from your words or from up to 3 pictures. The message goes straight to the image model, without the agent. See Generate images.

@video

Pick @video to make one short video with Seedance, from words, pictures, a clip or audio. The message goes straight to the video model, without the agent. The composer shows the video settings and inputs, and the Method setting decides which inputs: for example a first frame, a first and last frame, or reference images and a motion clip. See Generate videos.

Put a person in a video

Seedance, the video model, doesn’t accept photos of real people as frames or reference images. It refuses them with Seedance doesn't accept pictures of real people. Make the person with Seedream 5.0 in Image, then use that picture.

To put a person in a video:

1. Turn on @image, pick Seedream 5.0 as the model, and describe the person, without adding source pictures.
2. Turn on @video and use that picture as a frame or a reference image.

Seedance accepts people that Seedream 5.0 made from a description alone. A picture made from your own source pictures, or with GPT Image 2, can be refused the same way as a photo.

Use a Blender animation as the motion reference

When the agent renders an animation in Blender and links the video in its reply, the clip shows as a card under the reply and plays on its own. Click the folder icon on the card to find the file.

Open @video on the card and pick Motion reference. The clip is copied into the chat, the method switches to References, and Duration matches the clip’s length. Edit clip and Extend take the clip the same way on models that support them. Nothing is sent until you write your prompt and send it.

Build on a generated video

A finished video’s card has the same chips as an image card: Chat, @image and @video. Each one opens a menu, and nothing is sent until you write your prompt and send it.

• Chat gives the video to the agent for Blender. This frame adds the frame on screen as a picture, so the agent can build that scene; pause the video where you want it first. Last frame adds where the video ends. The clip writes a message asking the agent to load the video behind the Blender camera, so you can match its motion.
• @image puts This frame or Last frame into an @image message, to edit that frame as a picture.
• @video uses the video in the next one. Motion reference copies its motion, Edit clip changes it and Extend continues it; Edit clip and Extend need Seedance 2.5. Next shot starts a new video on this video’s last frame, with any model, so the scene continues with a new prompt.

On a draft, Make 1080p final sits first in the same row. Videos in the Library have the same chips; there, This frame is the video’s first frame.

Mention reference images

While @video is in the prompt, the menu lists your reference images first, with how many of the 5 you’ve used. Pick one to name it in the prompt, like @video Make @hero walk into @kitchen and wave.

Pick Add reference… to add another one. Hover a reference chip to see its image.

What isn’t a command

• @image and @video only work as chips. Pick one from the menu, click Image or Video in the toolbar, or type the whole word followed by a space.
• Each message needs its own @image or @video chip. They don’t carry over to the next message.
• There are no slash commands. A message that starts with / is sent as plain text.
• An @ inside a word, like in an email address, doesn’t open the menu.

Next steps