Ciyo practical guide

Seedance Frames vs Reference: Which Ciyo Input Mode Fits Your Shot?

Ivory apertures and a charcoal ribbon suggest different ways to guide motion.

A product photo can play two different jobs in an AI video: establish a shot's starting composition, or show the model what the product should look like. Attaching the right image in the wrong role can leave you correcting the prompt when the real decision is the input mode.

This guide uses Ciyo's current Frames and Reference controls, reviewed on October 20, 2026. Our running example is a fictional ivory mug with a charcoal handle and amber band. Mode support varies by selected model, and neither mode guarantees pixel-perfect product continuity.

Quick choice: composition or identity?

Choose Frames when the supplied opening composition is part of the brief. Choose Reference when the image should guide the subject or visual treatment while the shot can be composed differently. If the opening and the product identity both matter, start with Frames and inspect the whole result; a mode name is not a substitute for that inspection.

A decision about the image's role
NeedStart withCheck in the output
Begin from this product compositionFramesOpening crop, scale and position
Guide the appearance of the productReferenceShape, color and distinctive details
Move between two prepared compositionsFrames, if an end image is supportedBoth boundaries and the transition
Copy an existing clip's movementA supported reference-video workflowAvailability, input limits and actual motion

Frames: give the model a visual starting point

Frames uses a start image and, where supported, an optional end image. Prepare the start image at the intended composition: the mug's handle should be visible, the base should not touch the crop, and the product should have room for the requested camera move.

The advantage is a clear visual boundary. The limitation is what happens between boundaries: a convincing opening frame does not prove that a handle stays attached or an amber band remains the same width throughout the clip. An end image adds another constraint, not a guarantee that the model will solve the transition cleanly.

For a simple product reveal, begin with one start image. Add an end image only when you can explain why the second composition matters. Large differences in viewpoint, scale or background give the transition more to invent.

Ciyo's Video Generator with the fictional mug attached as a start frame.
Live Ciyo setup, October 20: Seedance 2.5, Frames, five seconds, 720p setting and audio off. This clean setup capture was recreated after the first run.

Reference: guide the subject without prescribing the first frame

Reference inputs provide visual guidance for supported models. Select images that agree about the product. A front view of one mug and a side view of a different handle design create an ambiguous brief, even when both look like the same product category.

This mode suits a new composition or a scene that needs to keep recognizable product traits. Describe which traits matter: the charcoal handle, ivory body and narrow amber band. Avoid writing that the model will preserve every pixel; guidance and a protected pixel layer are different things.

Reference is often easier to brief when the opening is flexible. Frames is easier to evaluate when an approved still must be the starting composition. Neither has an inherent price or quality advantage across all models.

The same mug photo attached as a Reference image in Ciyo's Video Generator.
Reference setup using the same source and motion wording. Auto aspect did not produce the same framing as the Frames run.

Prepare one comparison before producing a campaign

Create an isolated Ciyo project and retain the unedited source. Open Video Generator, select a model that offers both required modes, and record its exact name. Hold duration, aspect ratio, output settings and motion request constant.

Make one Frames request with the mug as the start image. Make one Reference request using the same mug as a reference. Do not put an image into a similarly named field and assume its role is unchanged. If the model does not expose both modes, choose a supported model or document that a direct comparison is unavailable.

Shared motion brief
The ivory mug remains stationary on the tabletop. The camera makes one slow, shallow push-in toward the mug. Keep the charcoal handle, ivory body and narrow amber band recognizable throughout. Maintain the same soft left-side light. One continuous shot, with the whole mug remaining in view.

Judge the middle of the clip as carefully as the opening

Pause near the start, middle and end, then scrub through any moment where the camera changes direction. Compare the handle opening, rim, band and contact with the table. Watch the full clip at normal speed as well: a discontinuity can be easier to spot in motion than in three selected stills.

Keep a short decision log. If Frames preserves the intended opening but introduces a new back surface, simplify the move. If Reference captures the color palette but changes the mug geometry, try a clearer reference or a narrower scene request. A faithful still is a better product asset than an attractive clip of a different object.

Review before accepting a result
CheckAccept whenRevise when
OpeningThe shot serves the intended compositionThe product is cropped or unexpectedly repositioned
IdentityVisible distinguishing details remain plausibleHandle, rim or decoration materially changes
MotionThe requested move reads clearlyThe product spins when only the camera should move
EndingThe final image is usable in the editThe clip ends on distortion or an accidental cut

Our live pilot: the same source, two different output frames

On October 20 we ran both modes in dev.ciyo.ai with Seedance 2.5, the same fictional mug source, the shared motion brief above, five seconds, the 720p setting and audio off. Each request displayed a Generation quote of 197 Ciyo credits.

Frames took its aspect ratio from the attached image and returned 1180 × 786. Reference with Auto aspect returned 1280 × 720. Both files measured 5.04 seconds. Because the framing differed, this is a workflow pilot rather than a controlled ranking of the two modes.

The lesson is to inspect the input role and the actual export. A shared preset name does not prove identical output dimensions. Our original downloaded reference was 1024 × 682; it was converted from AVIF to PNG because the Frames upload rejected AVIF.

Observed October 20 pilot; one output per mode
ModeDisplayed quoteActual fileWhat to inspect
Frames197 Ciyo credits1180 × 786; 5.04 secondsOpening composition and the growing product scale
Reference197 Ciyo credits1280 × 720; 5.04 secondsWider composition and subtler visible movement

Watch the Frames result

In one-second samples, the mug grows visibly larger while the handle and amber band remain recognizable. The source composition provides a useful opening. Inspect the full video yourself before accepting it for a particular product.

The generated mug video displayed inside the Ciyo canvas.
The Frames request completed. The downloaded file is 1180 × 786 and 5.04 seconds; the preset name is not an exact pixel-size guarantee.
Silent Ciyo demonstration generated October 20, 2026. Seedance 2.5, one fictional mug, one continuous push-in request. This single result is not a reliability benchmark.

Watch the Reference result

The Reference clip starts with more surrounding space and shows less obvious push-in in the sampled frames. That does not establish that Reference is generally worse at motion. It shows why a request must be judged against the shot you actually need.

Ciyo displays the completed Reference-mode mug video.
The Reference result is 1280 × 720 and 5.04 seconds. Different output framing limits a direct comparison.
Silent Reference-mode trial with the same source and motion brief. Its wider composition and much smaller visible push-in are observations about this sample.

Choose by the job and the total task cost

For a merchant with an approved hero still, Frames is the practical first trial. For a creative team exploring a fresh scene around a recognizable subject, Reference is a reasonable starting point. A team needing both can keep two separate requests and choose the usable result after review.

Check the Generation quote for each request. Ciyo credits for generation depend on the model and settings, and Design agent planning can also incur Billable LLM usage. Count rejected attempts when comparing cost. The input mode alone does not tell you which route is cheaper.

Practical questions

Does Frames guarantee an exact first or last frame?

It supplies visual boundary guidance. Check the actual exported frames, especially after a resize, crop or model change. An optional end image is available only for supported model configurations.

Can I mix start frames and Reference attachments?

Use the controls and input contract of the selected model. Frames and Reference images are different input roles; do not assume that attaching both produces a supported combined request.

Which mode is cheaper?

There is no universal answer. Compare the displayed Generation quotes for equivalent settings and include the retries needed to obtain an acceptable clip.

Can I switch modes without changing my prompt?

A shared motion prompt is useful for a controlled comparison, but recheck image roles and supported settings after switching. The visual starting constraint changes.

Choose the input role before generating

Start with one approved product photo and one short motion request. Inspect the complete clip before expanding the batch.