feat: move Seedance and Omni video onto the job contract

[kiyeonjeon21]

Third PR of the provider interface work (after #349 and #350). With this, every video provider except Veo (shutting down 2026-10-22) is on the contract.

Seedance

• fal's queue API instead of the blocking subscribe. A paid job keeps its request ID from the moment it is accepted, so it can be polled or cancelled after a crash. Before, a crash mid-wait lost it.
• "COMPLETED but failed" is handled. fal documents that a COMPLETED status can still be a failure, so error is checked first. A rejection raised when the result is read, like the likeness 422, is reported as a failed job of kind likeness (code content_policy_violation).
• Bug fix: local frames are no longer dropped. A data-URI first frame used to be ignored, so image-to-video silently became text-to-video. It is now uploaded to fal storage, as references already were.
• Tests run the real @fal-ai/client SDK against the fake network instead of mocking subscribe. Every earlier assertion is kept.

Omni

• Background mode: submits with background: true and polls GET /interactions/{id}, then the Files API until the video is ACTIVE.
  • The docs list background only for text models, but Omni accepts it.
  • The completed interaction carries the video URI, contrary to the docs' note.
  • Both were probed live and recorded in google.md.
• The job handle is the session handle: edit and extend chain with previous_interaction_id. Cancel uses the documented POST /interactions/{id}/cancel.
• A filtered result reads as moderation: a completed interaction with no video is reported as moderation. Omni's filter can finish that way.

Compatibility

Both keep a blocking generateVideo that submits and waits, so CLI callers are unchanged until the CLI moves to the contract (next PR).

Verification

• Contract suite: Seedance and Omni both pass.
• Provider-specific tests:
  • Seedance: endpoint routing for fast and 2.5, duration clamping, data-URI upload, reference grouping, the likeness 422 at result time, and the blocking wrapper.
  • Omni: request shape, inline frames, refusing a URL frame, edit and extend chaining, and file PROCESSING before ACTIVE.
• Checks: pnpm build, lint, typecheck, tests (providers 205, CLI 1215, MCP 73), pre-push gate.
• Live:
  • vibe generate video -p seedance --seedance-model fast --resolution 480p --duration 4: 4.1 s, 864x496.
  • vibe generate video -p omni --resolution 360p: 10.0 s, 640x360.
  • Omni edit through the contract ("make it a snowy night") on that interaction: same boat and framing, now snowing at night, 70 s end to end.
  • About $2.3 in total.

https://claude.ai/code/session_011S1BLTaFctZNQzGERpkCuA

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
vibeframe	Ready	Preview	Oct 4, 2026 2:26pm UTC