Waste To Diy Analyzer

A production-ready Apify Actor that analyzes an image to identify waste or discarded raw materials (e.g., plastic bottles, cardboard, metal cans, fabric scraps, glass, wood) and suggests creative DIY art, craft, or useful product ideas. It then uses the official YouTube Data API v3 to find 3 relevant tutorial videos showing how those materials can be reused.

Features

• Image Analysis: Uses OpenAI Vision to detect waste materials in images
• Material Identification: Identifies specific materials like plastic, paper, metal, fabric, glass, wood
• DIY Suggestions: Provides creative reuse ideas like art projects, crafts, home utilities, storage solutions
• YouTube Integration: Finds relevant tutorial videos using the official YouTube Data API v3
• Test Mode: Includes test mode for validation without API calls

Input Schema

Field	Type	Required	Description
imageUrl	String	Yes	Public URL of the image to analyze for waste materials
openaiApiKey	String	Yes	Your OpenAI API key for AI analysis (stored as secret)
model	String	No	Vision-capable OpenAI model (default: "gpt-4o-mini")
language	String	No	Preferred language for YouTube videos (default: "en")
testMode	Boolean	No	Enable test mode (default: false)

imageUrl must be provided (except in testMode).

Output Schema

The actor outputs a structured object containing:

{
  "isWasteMaterial": true,
  "materialsIdentified": ["plastic bottle", "cardboard"],
  "reuseIdeas": ["planter", "desk organizer", "wall decor"],
  "youtubeTutorials": [
    {
      "videoTitle": "...",
      "channelName": "...",
      "videoUrl": "https://www.youtube.com/watch?v=..."
    }
  ],
  "disclaimer": "This analysis is for creative and educational purposes only."
}

Requirements

• OpenAI API key with vision capabilities
• YouTube Data API v3 key (set as ACTOR_YOUTUBE_API_KEY environment variable in Apify)
• Publicly accessible image URL

Architecture

1. Image Analysis: OpenAI Vision analyzes the provided image to identify waste materials
2. Material Processing: Identifies specific materials and suggests reuse ideas
3. YouTube Search: Searches for relevant DIY tutorial videos based on materials and ideas
4. Output Generation: Formats and outputs the complete analysis

Test Mode

When testMode is enabled, the actor skips API calls and returns mock data with sample materials, reuse ideas, and YouTube links.

Error Handling

• Validates image input requirements
• Fails fast if OpenAI or YouTube API keys are missing
• Handles API errors gracefully
• Includes timeout protection (5 minutes max)

Deployment

Deploy as an Apify Actor with the provided configuration files. Ensure the YouTube API key is set in the actor environment variables.