Artboard Mockups

Author 3D model animation keyframes, duration, easing and animated backgrounds in one validated edit. Use for make the phone rotate once over three seconds, open the laptop lid, animate the lighting or move a keyframe. Pose uses current keys such as rx/ry/rz in degrees, px/py/pz position, lid/lid2 hinges, light, fov and exposure from live context. A complete turn spans 0 to 360 degrees; allowed pose ranges and existing keyframes are included in current project state. replace=true explicitly replaces the existing timeline; otherwise frames at matching times are updated and other frames remain. Motion templates are procedural; use update_project_settings for their motion instead.

edit_model_timeline

Delete the explicitly selected native generated result from this project using Artboard’s existing deletion workflow. The result disappears from its gallery; media still referenced by a project or retained history follows the existing storage cleanup rules.

delete_project_generation

Delete one of the user's Artboard projects. Confirm with the user first; it is removed from their projects.

delete_project

Distribute two or more mockup layers with equal non-overlapping edge gaps along the horizontal (x) or vertical (y) axis. Uses stable layer ids or aliases from live context. Applies one validated canvas change.

distribute_canvas_group

Duplicate an existing mockup, image or video layer using the editor’s native offset. The original remains unchanged. Use a stable target from current context, or omit target for the selected layer. Use update_canvas_layer afterward for explicit placement.

duplicate_canvas_layer

Duplicate the specified image/video card in the existing motion canvas. Use a stable card id or card-N alias from live context. The native motion engine recalculates duration; inspect the returned actual duration rather than assuming it increases.

duplicate_motion_card

Make a copy of one of the user's Artboard projects.

duplicate_project

Duplicate the specified existing mockup, image or video layers in one validated change. Resolves stable target ids before changes and uses the native duplication offset. One undo removes the entire duplicate batch; originals remain unchanged.

duplicate_canvas_layers

Render the current Artboard canvas as an image or video, preserving its artwork, colors and view. Returns export metadata, a temporary download, and an image reference when supported. Downloads expire after first opening or 1 hour. Available formats and resolution follow the user's Artboard plan.

export_project

Adjust an existing image/video background in any editor: fit/fill it, tile it, rotate tiles, change tile scale or offset, and choose its anchor. Use for make the background repeat, fit the whole image, or shift the tiles. Scale is a percentage of original media size and offsets are percentages of a scaled tile. Set a new background image through set_project_background first.

style_project_background

Run the native Artboard image-editing or image-to-video workflow for this project. Uses the actual rendered canvas or existing owned image references. The result is a separate generated asset; the editable project remains intact. max_credits caps the account credits this run may consume. Image references: one total. Video references: first and optional last. References can be ChatGPT attachments or owned Artboard files. Prompt-only attachments are not added to Your files.

generate_project_media

Creates an optional logical change group for a multi-tool design request. Consecutive native edits carrying the returned history_group are recorded as one undo step, provided the project state stays contiguous. This does not change the canvas.

begin_project_edit

Read the actual current mockup, 3D or motion frame as an image for visual inspection. Preserves the project and does not consume an export allowance. The preview is reduced for inspection; it is not the original export or an image-generation reference.

inspect_project

List the images and videos in the user's Artboard "Your files" library. Pass a fileId to set_project_image or set_project_background to reuse one; reusing a file never counts against upload limits.

list_my_files

List the user's recent Artboard projects and display their real saved thumbnails in the Artboard Projects view. Do not embed thumbnail image links in chat; the host may not display them. Use openUrl verbatim for public links; never construct one from openPath, which is only for open_project. Do not substitute catalog thumbnails for saved project previews.

list_projects

Open a template from search_templates in the Artboard editor. Each call creates a new project in the user's account; to return to it, use open_project.

open_template

Open a mockup from search_mockups in the Artboard editor so it can be customized and exported. Each call creates a new project in the user's account; to return to it, use open_project.

open_mockup

Reopen one of the user's existing projects (openPath from list_projects) in the editor.

open_project

Place an attached image or video on the actual open Artboard project: logos on mockups, screenshots or MP4 videos on device screens, and media in motion cards. Targets are mockup surfaces, 3D screens, or motion cards. Use the ChatGPT attachment file parameter, a public HTTPS link, or an existing Artboard file. New images and videos are saved to the user's "Your files" and count as an upload on limited plans.

set_project_image

Control the actual 3D or motion timeline: play it, pause it, or seek to a specific time in seconds. A seek pauses playback. Mockup video surfaces support play/pause of the selected video. Use for pause at two seconds or preview the animation, without asking the user to operate the timeline.

control_project_playback

Open a completed owned generation in the existing Artboard Preview dialog, including video playback and Download. Does not modify canvas layers or consume another generation credit.

show_project_generation

Read whether this account can use Artboard AI and the credit cost of one image or video generation. Image generation supports one canvas or owned-file reference; video supports a first frame and optional last frame. References are transient and do not become uploads.

get_project_ai_options

Read the latest 50 native Artboard generation jobs and their real queued, processing, completed or failed status. Completed results include an owned result URL; pending jobs have no completed file.

list_project_generations

Describe the project: saved mockup projects can be read before the Artboard view loads; 3D and animation require the view. Reports which editor it is (mockup, 3D or animation), image targets, background, aspect ratio, every editable setting with its range or options, and export formats. Includes current live Artboard state when the view is connected.

get_open_project

Internal: issues a fresh session ticket for the Artboard app view.

artboard_session

Remove the requested mockup/image/video layer from the existing canvas. Use the selected layer or an exact target from current context. Does not delete the project or its uploaded file.

remove_canvas_layer

Remove the requested image/video card from the existing animation. Does not delete its uploaded media or the project.

remove_motion_card

Remove the image from a mockup surface or 3D screen, or remove an animation card (target required for animations).

clear_project_image

Rename one of the user's Artboard projects.

rename_project

Move an existing canvas layer to a specific stacking position. Position 1 is the back/bottom. Use stable layer ids from live context because positional aliases change after reordering; omit target only for the selected layer.

reorder_canvas_layer

Move an existing image/video card to a specific position in the motion canvas; position 1 is first. Resolve stable card ids from live context before reordering. The native motion engine returns the actual duration.

reorder_motion_card

Set the stacking positions of existing canvas layers in the listed sequence, validating the whole batch before applying it once. Position 1 is the back/bottom. Resolve stable layer ids from live context before reordering; one undo restores the batch.

reorder_canvas_layers

Retry a failed native generation using its original prompt and output settings, with current canvas or owned-file references. Requires a credit budget for the retry; the original asset and project remain intact.

retry_project_generation

Search Artboard 3D model templates or animation templates. Returns template ids to pass to open_template. Templates with isFree=false need a paid Artboard plan. To show results visually, call open_artboard with view "3d" or "animations" and the same search.

search_templates

Search the Artboard mockup catalog (t-shirts, packaging, devices, print, etc.). Returns mockup ids to pass to open_mockup. Items marked isFree=false need a paid Artboard plan. Thumbnail links do not display in chat: to show results visually, call open_artboard with view "mockups" and the same search.

search_mockups

Select what the user is referring to in the actual editor, e.g. the second mockup, its print area, or the second device screen. Read the current live context to identify the exact target. Selection is shared back with ChatGPT.

select_project_target

Select two or more mockup, image or video layers in the open mockup canvas. Targets use stable layer ids or aliases from live context. Changes the native selection without changing artwork or creating a saved group layer.

select_canvas_group

Set the frame of the open project, e.g. 1:1, 4:5, 9:16 or 16:9 (get_open_project lists the options).

set_aspect_ratio

Set the background of the open project to a solid color, a gradient, or an image (attached file, link, or one of the user's files). Pass exactly one of color, gradient or an image source.

set_project_background

Recolor a mockup product surface or device screen; change mockup design opacity and blending; fit/fill, move, resize or rotate placed artwork on a mockup or 3D screen. Use for make the shirt blue, make the logo smaller, move it higher, rotate the print, or fill the device screen. Transform uses surface pixels for left/top, scale factors for scaleX/scaleY, degrees for angle. 3D screens support solid color and artwork transforms; mockups also support gradients, opacity and blend modes. Obtain current targets/transform from live context or get_open_project yourself.

style_project_surface