Comfy-Org/ComfyUI · error · ValueError

sync.so generation {generation.status.lower()}{code}: {gener

Error message

sync.so generation {generation.status.lower()}{code}: {generation.error or 'no error details provided'}

What it means

Raised by the sync.so node after polling when the generation's terminal status is FAILED or REJECTED (poll_op treats all three terminal statuses as completed; failed_statuses is empty). The message includes the lowercased status, optional errorCode in brackets, and the generation.error text or a placeholder. This is the unified failure surface for sync.so server-side rejections.

Source

Thrown at comfy_api_nodes/nodes_sync_so.py:196

                options=SyncGenerationOptions(
                    sync_mode=model["sync_mode"],
                    active_speaker_detection=speaker_detection,
                ),
            ),
        )
        generation = await poll_op(
            cls,
            ApiEndpoint(path=f"/proxy/synclabs/v2/generate/{generation.id}"),
            response_model=SyncGeneration,
            status_extractor=lambda g: g.status,
            completed_statuses=["COMPLETED", "FAILED", "REJECTED"],
            failed_statuses=[],
            queued_statuses=["PENDING"],
            poll_interval=10.0,
        )
        if generation.status != "COMPLETED":
            code = f" [{generation.errorCode}]" if generation.errorCode else ""
            raise ValueError(
                f"sync.so generation {generation.status.lower()}{code}: "
                f"{generation.error or 'no error details provided'}"
            )
        if not generation.outputUrl:
            raise ValueError("sync.so generation completed but no output URL was returned.")
        return IO.NodeOutput(await download_url_to_video_output(generation.outputUrl))


class SyncTalkingImageNode(IO.ComfyNode):
    @classmethod
    def define_schema(cls) -> IO.Schema:
        return IO.Schema(
            node_id="SyncTalkingImageNode",
            display_name="sync.so Talking Image",
            category="partner/video/sync.so",
            description=(
                "Animate a still portrait into a talking video driven by speech audio, "
                "using sync.so's sync-3 model. The output duration matches the audio. "

View on GitHub (pinned to 1c6d8d45b3)

Solutions

Match the bracketed errorCode/error text to the sync.so docs — REJECTED usually means input issues, FAILED means server-side
Verify the video contains a clear, visible face and the audio has real speech for the full video duration
Trim audio to video length and re-submit
For repeated FAILED with no details, retry later or contact sync.so support

Defensive patterns

Strategy: try-catch

Validate before calling

face_ok = video_has_clear_face(video)
audio_ok = audio_has_speech(audio) and audio_duration(audio) <= video_duration(video)
if not (face_ok and audio_ok):
    raise ValueError("sync.so inputs likely to be REJECTED: need visible face and matching speech audio")

Try / catch

try:
    out = await syncso_generate(...)
except ValueError as e:
    msg = str(e)
    if "rejected" in msg:
        raise ValueError(f"Fix inputs: {msg}") from e  # input problem, do not retry
    if "failed" in msg:
        await asyncio.sleep(10)
        out = await syncso_generate(...)  # server-side, retry once
    else:
        raise

Prevention

Trim audio to the video duration and verify speech content before submitting
REJECTED = fix inputs; FAILED = possibly transient — handle them differently
Map errorCode values against sync.so docs in your error handler

When it happens

Trigger: Submitting a lipsync generation whose video/audio pair is rejected (mismatched durations, no face detected, unsupported codec) or that fails server-side; poll returns status FAILED or REJECTED with errorCode/error populated.

Common situations: Audio longer than the video or silent audio; video without a detectable face; content moderation rejection; sync.so internal failures; free-tier limits.

Related errors

AI-assisted analysis of Comfy-Org/ComfyUI@1c6d8d45b3 (2026-08-14). Data as JSON: /api/errors/2f548959322a3d0f. Report an issue: GitHub.