Generation Troubleshooting
Separate bad inputs, provider access, asynchronous status, and quality problems.
Inspect the graph before the network
A wire only expresses a possible dependency; it does not prove the source produced a valid URL or that the selected model accepts the target media type.
- Open the failing node and identify its model, visible input ports, and selected @ material thumbnails.
- Preview each upstream item; remove empty sources and reconnect any edge whose kind no longer matches the model after switching.
Translate validation into an action
“Exactly one image and one audio” points to OmniHuman or a MiniMax reference path, whereas “video needs an audio track” points to MiniMax video-reference mode. More references usually worsen these errors.
- For MiniMax, clear @ and rebuild either image plus audio or one to three videos with native sound, never both.
- For OmniHuman, deselect every surplus image or audio and remove videos entirely; read the current error again before retrying.
Check server availability safely
A model listed in the canvas only proves integration exists. Actual calls depend on configured server credentials, provider entitlement, quota, region, storage reachability, and upstream service health.
- Ask an administrator whether the relevant HKGAI Seedance, HKGAI Music/TTS, TokenStar, DashScope, 302AI, or Volcengine route is enabled; provide only the error code and model name.
- Never publish key values, paste secrets into prompts, or put them in screenshots shared for debugging.
Distinguish queued from completed
Many video providers return a task identifier before they return playable media. A submitted or running status is not itself a broken file; a completed task without a usable result calls for inspection.
- Watch the node’s status until a result URL and preview appear; avoid submitting duplicates while the same task is pending.
- If the task ends in error, preserve its error message and model selection; retry a single short node rather than the entire graph.
Fix the smallest cause first
A playable but poor result is different from a rejected request. Compare it against one concrete acceptance criterion: subject identity, shot movement, speech accuracy, or sound balance.
- For a drifting face, replace the portrait or reduce competing visual references; for a mistimed cut, correct Video Edit in/out points.
- Save the useful version, change one variable, run one new take, and compare at normal playback speed before scaling to a longer sequence.