Skip to content

Commit b1d6011

Browse files
committed
docs(changelog): prepare Start a fal.ai video from a reference image
1 parent 343a5cc commit b1d6011

1 file changed

Lines changed: 88 additions & 0 deletions

File tree

Lines changed: 88 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,88 @@
1+
# Start a fal.ai video from a reference image
2+
3+
Status: editorial draft. Availability and media require review before an article is added.
4+
5+
## Editorial selection
6+
7+
Story type: feature
8+
9+
The fal.ai start-frame (image-to-video) feature in the Video Generator block is the strongest lead: it unlocks a genuinely new creative capability—using a reference image to anchor video generation—for most fal.ai video models. It is a complete, user-visible workflow capability extending an existing block. Alternatives: Higgsfield integration (v0.9.47, different release tag), security hardening (internal, no user-visible capability change), CSV leading-zero fix (narrower scope), Chat Human-in-the-Loop fix (bug restoration), Atlassian/Notion multi-account fix (secondary). No candidates share the v0.9.48 tag, so no 'Also in' section.
10+
11+
## Proposed article
12+
13+
Sim's Video Generator block accepts a start frame image for fal.ai models with image-to-video support, so agents can generate video that begins from a chosen image.
14+
15+
The Video Generator block accepts an optional start frame for fal.ai models that support image-to-video. When available, a start frame input appears in the block panel. Attach an image and the block switches to the model's image-to-video mode—duration, aspect ratio, resolution, audio, and prompt optimizer settings update to match, and options the image mode does not accept are hidden. Models such as Kling and Veo support start frames; selecting a model without image-to-video support returns a clear error.
16+
17+
Connect your fal.ai account and open the Video Generator block. [Video Generator block docs](https://docs.sim.ai/workflows/blocks/agent). Check each model's fal.ai documentation for specific supported settings.
18+
19+
## Editorial review
20+
21+
- Removed 'now' from summary, body, social, and email per editorial policy against rollout language in automatic drafts.
22+
- Simplified 'endpoint' language to 'mode' in public copy for readability; kept 'endpoint' only in claims where precision matters.
23+
- Named Kling and Veo as representative model families based on PR test cases (Kling v3 Pro and Veo 3.1); asked question to confirm these are the best examples.
24+
- The docs link points to the generic agent block page—question asks whether a dedicated Video Generator page exists. This is the only verified link that appears relevant.
25+
- Added note in proof_limit about verifying model-switching behavior after a frame is attached, matching the PR's reviewer guidance.
26+
- The PR states 94 of 112 catalog models have image-to-video support; this count is kept in claims for evidence but excluded from public copy per operation-count guideline.
27+
28+
## Source evidence
29+
30+
- The Video Generator block routes to a fal.ai model's image-to-video endpoint when a start frame is attached and hides settings the image endpoint does not accept. — simstudioai/sim#9761
31+
- Models without an image-to-video endpoint reject a start frame with a clear error instead of a generic 'Unknown model' failure. — simstudioai/sim#9761
32+
- Duration, aspect ratio, resolution, audio, and prompt optimizer dropdowns update to reflect the endpoint that will run when a start frame is present. — simstudioai/sim#9761
33+
- The start frame input is shown in the block UI only for fal.ai models that have an image-to-video sibling endpoint (94 of 112 catalog models per PR). — simstudioai/sim#9761
34+
35+
- https://github.com/simstudioai/sim/pull/9761
36+
37+
## Availability and open questions
38+
39+
- [ ] Can the start frame be provided as a workflow variable or only via direct upload/URL input in the block UI?
40+
- [ ] Is the 5 MB start frame size limit enforced at the block UI level, the tool level, or both?
41+
- [ ] Which fal.ai model families are most commonly used with image-to-video—Kling and Veo are named in test cases; are there others worth highlighting?
42+
- [ ] Has conditional field visibility been verified in a running build, as the PR requests?
43+
- [ ] Is there a dedicated docs page for the Video Generator block, or should the generic agent block docs link be used?
44+
45+
## Links checked during drafting
46+
47+
- [Video Generator block docs](https://docs.sim.ai/workflows/blocks/agent)
48+
49+
## Media production
50+
51+
Format: video · 25 seconds
52+
Subject: Video Generator block with fal.ai model and start frame image attached
53+
Starting state: Video Generator block open in a workflow, fal.ai model selected, no start frame attached
54+
Action: User attaches a start frame image; block UI updates to show image-to-video-compatible settings
55+
Visible result: Block panel shows start frame thumbnail and updated settings (duration, aspect ratio, etc.) ready to run
56+
Poster: Block panel with start frame thumbnail visible and settings dropdowns updated for image-to-video
57+
Framing: Block panel at 390px width, settings clearly readable, start frame thumbnail visible
58+
Demonstration limits: Capture requires a real fal.ai credential configured in settings and a fal.ai model with image-to-video support selected (e.g. Kling v3 Pro or Veo 3.1). Do not use placeholder keys or fabricate UI state. Verify conditional field visibility: start frame input should appear only for supported models, and switching models after a frame is attached should update or hide settings correctly.
59+
60+
Record a short screen capture of the Video Generator block with a fal.ai model selected, showing a start frame image attached and block settings updating to reflect image-to-video mode. End on the configured block ready to run, with the start frame thumbnail and applicable settings visible.
61+
62+
1. Open a workflow with a Video Generator block and a fal.ai model selected (e.g. Kling v3 Pro or Veo 3.1)
63+
2. Attach a sample start frame image—show the block panel updating to display image-to-video settings (duration, aspect ratio, resolution dropdowns appropriate to the image endpoint)
64+
3. Hold on the configured block showing the start frame thumbnail and active settings, ready to run
65+
66+
Suggested alt text: Sim Video Generator block with a fal.ai model selected and a start frame image attached, showing image-to-video settings in the block panel
67+
68+
- [ ] Independently verify the feature and rollout; record evidence and limitations.
69+
- [ ] Review a product capture, verified diagram, or original editorial illustration; retain capture or generation provenance.
70+
- [ ] Choose the final image or video poster; verify it reads clearly at 390px. Candidate assets are not approved media.
71+
- [ ] Add optimized versioned media, captions if spoken, and index.mdx with draft: true.
72+
- [ ] Verify the final media on desktop and mobile and run the content audit.
73+
- [ ] Feature owner confirms availability; editor approves copy and links.
74+
- [ ] After the approved site deployment, verify article, media, RSS and sitemap before marking published.
75+
76+
## Announcement drafts
77+
78+
**Social**
79+
80+
Sim's Video Generator block supports start frame images for fal.ai models with image-to-video. Attach a reference image and the block switches to image-to-video mode, updating available settings to match. Connect your fal.ai account to try it.
81+
82+
**Email**
83+
84+
The Video Generator block in Sim accepts a start frame image for fal.ai models that support image-to-video. Attach an image and the block switches to the correct mode, showing only applicable settings. Open the Video Generator block in your workflow to use it.
85+
86+
Final canonical URL is assigned when the reviewed article slug is chosen. Do not distribute these drafts before publication.
87+
88+
Editorial contract: apps/sim/content/changelog/README.md and editorial-standard.md. This brief is public repository content; keep private operational evidence in Sim.

0 commit comments

Comments
 (0)