Prompt Pack Format

Prompt Packs are the core export format for Elcine Studios—structured JSON files containing everything needed to generate your visual content.

What's in a Prompt Pack?

A Prompt Pack is a complete, portable specification for an AI generation project. It includes:

  • Project metadata — Title, version, creation date
  • Creative brief — Goals, audience, tone
  • Style bible — Visual specifications that apply to all shots
  • Shots array — Individual generation specifications
  • Generation settings — Default provider and model configurations

Schema Reference

Root Object

FieldTypeDescription
project_titlestringName of the project
versionstringSemantic version (e.g., "1.0.0")
created_atstringISO 8601 timestamp
creative_briefobjectProject goals and context
style_bibleobjectVisual style specifications
shotsarrayArray of shot specifications
generation_settingsobjectDefault generation parameters

Shot Object

FieldTypeDescription
shot_idstringUnique shot identifier
scenestringScene or sequence name
camerastringFraming (wide, medium, close-up, etc.)
lensstringLens focal length
movementstringCamera movement description
lightingstringLighting setup description
subjectstringWhat's in frame
environmentstringBackground/setting
actionstringWhat's happening
promptstringFull generation prompt
negativestringNegative prompt
duration_snumberDuration in seconds
aspect_ratiostringAspect ratio (16:9, 1:1, etc.)
provider_paramsobjectProvider-specific overrides

Example Prompt Pack

{
  "project_title": "TechFlow Product Launch",
  "version": "1.0.0",
  "created_at": "2024-01-15T10:30:00Z",
  "creative_brief": {
    "description": "Launch video for TechFlow productivity app",
    "target_audience": "Creative professionals, 25-45",
    "tone": "Modern, energetic, aspirational",
    "key_message": "Work smarter, not harder"
  },
  "style_bible": {
    "palette": "Deep navy, electric blue accents, warm highlights",
    "lighting": "Soft key light from left, subtle rim light",
    "lens": "35mm equivalent, shallow depth of field",
    "pacing": "Dynamic with moments of stillness",
    "references": "Apple product launches, Linear brand"
  },
  "shots": [
    {
      "shot_id": "001",
      "scene": "Opening",
      "description": "Product hero shot of app interface",
      "camera": "Medium close-up",
      "lens": "35mm",
      "movement": "Slow push in",
      "lighting": "Soft key from camera left, blue rim right",
      "subject": "Floating device showing TechFlow interface",
      "environment": "Abstract dark gradient background",
      "action": "Interface elements animate subtly",
      "prompt": "Professional product photography of a floating smartphone displaying a modern productivity app interface, dark navy gradient background, soft key lighting from left, blue rim light from right, shallow depth of field, 35mm lens, 4K, cinematic",
      "negative": "hands, fingers, people, text overlay, watermark, low quality, blurry",
      "duration_s": 3,
      "aspect_ratio": "16:9",
      "provider_params": {
        "openai": {
          "model": "dall-e-3",
          "quality": "hd",
          "style": "vivid"
        },
        "grok": {
          "model": "grok-vision",
          "steps": 50
        }
      }
    },
    {
      "shot_id": "002",
      "scene": "Feature showcase",
      "description": "Task management feature in use",
      "camera": "Over-the-shoulder",
      "lens": "50mm",
      "movement": "Static with subtle drift",
      "lighting": "Natural window light, monitor glow",
      "subject": "Professional at desk using app",
      "environment": "Modern home office setup",
      "action": "User drags task card, satisfied expression",
      "prompt": "Over-the-shoulder shot of creative professional at minimalist desk, modern home office with large window, using productivity app on laptop, natural lighting, warm tones, 50mm lens, shallow depth of field, lifestyle photography",
      "negative": "cluttered, messy, dark, harsh shadows, artificial looking",
      "duration_s": 2,
      "aspect_ratio": "16:9",
      "provider_params": {}
    }
  ],
  "generation_settings": {
    "default_provider": "openai",
    "default_model": "dall-e-3",
    "default_quality": "hd",
    "default_size": "1792x1024"
  }
}

Using Prompt Packs

Exporting

You can export a Prompt Pack at any time from the workflow builder. Click "Export JSON" to download the file. Prompt Packs can also be saved to your library for later use.

Importing

Import a Prompt Pack by dragging the JSON file into the app or using the import dialog in the dashboard. Imported packs create a new project with all artifacts pre-populated.

Versioning

Use semantic versioning to track iterations. When you make significant changes to a Prompt Pack, bump the version number. This makes it easy to compare results across different versions.

Sharing

Prompt Packs are portable. Share them with collaborators, publish templates, or archive them for future reference. The format is human-readable JSON, so it can be version-controlled in Git.