# AI Content Generation Suite Documentation

Welcome to the AI Content Generation Suite documentation. This comprehensive guide covers everything you need to know to generate AI content using 73 models across 12 categories.

## Quick Navigation

### Getting Started
- [Setup Guide](guides/getting-started/setup.md) - Installation, configuration, and API keys
- [Learning Path](guides/getting-started/learning-path.md) - Structured learning journey (beginner to advanced)

### Pipelines
- [YAML Pipeline Configuration](guides/pipelines/yaml-pipelines.md) - Create custom workflows
- [Parallel Execution](guides/pipelines/parallel-execution.md) - Speed up your pipelines

### Content Creation
- [Prompting Guide](guides/content-creation/prompting.md) - Write effective prompts
- [Video Generation Tips](guides/content-creation/video-tips.md) - Create better videos
- [Video Analysis](guides/content-creation/video-analysis.md) - AI-powered video analysis

### Optimization
- [Cost Management](guides/optimization/cost-management.md) - Estimate and track costs
- [Performance Optimization](guides/optimization/performance.md) - Maximize speed and efficiency
- [Best Practices](guides/optimization/best-practices.md) - Recommended patterns

### Reference
- [Models Reference](reference/models.md) - Complete list of all 73 AI models
- [CLI Commands](reference/cli-commands.md) - Command-line interface reference
- [API Reference](api/python-api.md) - Python API documentation
- [Provider Comparison](reference/provider-comparison.md) - Compare AI providers
- [Error Codes](reference/error-codes.md) - Error codes and troubleshooting

### Examples
- [Basic Examples](examples/basic-examples.md) - Simple use cases
- [Advanced Pipelines](examples/advanced-pipelines.md) - Complex workflows
- [Real-World Use Cases](examples/use-cases.md) - Production examples
- [Integration Examples](examples/integrations.md) - Flask, FastAPI, Celery, etc.

### Architecture
- [Architecture Overview](reference/architecture.md) - System design and structure
- [Package Structure](reference/package-structure.md) - Code organization

### Support
- [Troubleshooting](guides/support/troubleshooting.md) - Common issues and solutions
- [FAQ](guides/support/faq.md) - Frequently asked questions
- [Testing Guide](guides/support/testing.md) - How to test your pipelines
- [Security Best Practices](guides/support/security.md) - Keep your setup secure

### Contributing
- [Contributing Guide](guides/contributing/contributing.md) - How to contribute
- [Migration Guide](guides/contributing/migration.md) - Upgrading between versions
- [Changelog](CHANGELOG.md) - Version history and updates

## Feature Highlights

### Multi-Model Support
Access 73 AI models from leading providers:
- **FAL AI** - Text-to-image, image-to-video, video-to-video, avatar generation
- **Google** - Veo 3/3.1 video generation, Imagen 4, Gemini image understanding
- **OpenAI** - Sora 2/Pro video, GPT Image 1.5
- **xAI** - Grok Imagine Video, Grok Video Edit
- **ElevenLabs** - Professional text-to-speech, Scribe v2 transcription
- **OpenRouter** - Prompt generation and optimization

### Unified Pipeline
Create complex workflows with simple YAML configuration:
```yaml
name: "Text to Video"
steps:
  - type: "text_to_image"
    model: "flux_dev"
  - type: "image_to_video"
    model: "kling_3_pro"
```

### Parallel Execution
Speed up your pipelines with parallel processing:
```bash
PIPELINE_PARALLEL_ENABLED=true aicp run-chain --config config.yaml
```

### Unix-Style CLI
Machine-readable output for scripting and CI:
```bash
aicp list-models --json | jq '.text_to_video[]'
aicp run-chain --config pipeline.yaml --json --quiet
```

## Quick Example

```bash
# Install the package
pip install video-ai-studio

# Generate an image
aicp generate-image --text "epic space battle" --model flux_dev

# Create a video
aicp create-video --text "serene mountain lake"
```

## Version Information

- **Current Version**: 1.0.24
- **Python**: 3.10+
- **License**: MIT

## External Resources

- [GitHub Repository](https://github.com/donghaozhang/video-agent-skill)
- [PyPI Package](https://pypi.org/project/video-ai-studio/)
- [Demo Video](https://www.youtube.com/watch?v=xzvPrlKnXqk)

---

**Last updated:** February 2026
