ATH-MaaS/Pixelle-Video · error · ValueError

Unknown pipeline: ' '. Available pipelines

Error message

Unknown pipeline: '{pipeline}'. Available pipelines: {available}

What it means

generate_video_wrapper looks up the requested pipeline name in self.pipelines and raises ValueError for names not registered. The message lists all registered pipelines so the caller can pick a valid one.

Solutions

Use one of the names listed in the error's 'Available pipelines' message
Check service.pipelines.keys() before calling to confirm the exact name
Register a custom pipeline first if you intend to use one: service.pipelines['custom'] = my_pipeline
Fix casing/underscores to match the exact registered key

Example fix

# before
await service.generate_video(pipeline="text_to_vid")
# after
await service.generate_video(pipeline="text2video")

Defensive patterns

Strategy: validation

Validate before calling

if pipeline_name not in service.pipelines:
    raise ValueError(f"{pipeline_name!r} not in {list(service.pipelines)}")

Type guard

def is_valid_pipeline(service, name: str) -> bool:
    return isinstance(name, str) and name in service.pipelines

Try / catch

try:
    video = await service.generate_video(pipeline=name)
except ValueError as e:
    logger.error("pipeline lookup failed: %s", e)
    raise

Prevention

Discover pipeline names dynamically from service.pipelines.keys() instead of hardcoding
Define pipeline name constants shared between caller and registration code
Add a startup check that all pipeline names your app uses are registered

When it happens

Trigger: service.generate_video(pipeline='<typo>', ...) where pipeline is not a key in self.pipelines (e.g. 'image2video' vs 'image_to_video').

Common situations: Typos in pipeline names; calling a custom pipeline before it was registered; version change removed/renamed a pipeline; case mismatch ('Text2Video' vs 'text2video').

Understand the failure class

Background: Invalid enum value errors: "Unknown type", "Invalid scope", "must be one of" — when a string is not on the library's allowed list — this error's family across 23 libraries.

Related errors

AI-assisted analysis of ATH-MaaS/Pixelle-Video@848b054e4f (2026-08-30). Data as JSON: /api/errors/72e493a5dd5f3295. Report an issue: GitHub.

Appendix: source

Thrown at pixelle_video/service.py:292

                VideoGenerationResult
            
            Examples:
                # Use standard pipeline (default)
                result = await pixelle_video.generate_video(
                    text="如何提高学习效率",
                    n_scenes=5
                )
                
                # Use custom pipeline
                result = await pixelle_video.generate_video(
                    text=your_content,
                    pipeline="custom",
                    custom_param_example="custom_value"
                )
            """
            if pipeline not in self.pipelines:
                available = ", ".join(self.pipelines.keys())
                raise ValueError(
                    f"Unknown pipeline: '{pipeline}'. "
                    f"Available pipelines: {available}"
                )
            
            pipeline_instance = self.pipelines[pipeline]
            return await pipeline_instance(text=text, **kwargs)
        
        return generate_video_wrapper
    
    @property
    def project_name(self) -> str:
        """Get project name from config"""
        return self.config.get("project_name", "Pixelle-Video")
    
    def __repr__(self) -> str:
        """String representation"""
        status = "initialized" if self._initialized else "not initialized"
        pipelines = f"pipelines={list(self.pipelines.keys())}" if self._initialized else ""

View on GitHub (pinned to 848b054e4f)