image-video-generation
Unified cookbook for TeamDay's AI image + video production stack. Models (Seedream 5, Seedream 4, Flux 2, Kling, Wan, Seedance 2.0), endpoints (ByteDance ModelArk direct, FAL AI, Gemini, OpenAI, Grok)
SKILL.mdskills/teamday/image-video-generation/SKILL.md
GitHubImage + Video Generation Cookbook
The full TeamDay stack for AI media production. Read this first before starting any cinematic or multi-scene project. It points to real scripts in generate-image/, image-to-video/, and video-editor/ — this skill is the map, not the machinery.
The pipeline (typical flow)
idea → keyframe image(s) → motion video(s) → post (grade + text + xfade + endcard + music)
├─ generate-image skill ├─ seedance-specialist agent └─ video-editor skill
└─ generate-image-*.py └─ image-to-video skill (Kling/Wan)
Model selection (what to use when)
Image generation
| Need | Model | Endpoint | Script |
|---|---|---|---|
| Cinematic keyframes, premium marketing, complex scenes with figures — the default | Seedream 5.0 (via ModelArk) | ark.ap-southeast.bytepluses.com direct |
generate-image-seedream-modelark.py |
| Cinematic scenes (fallback if ModelArk down) | Seedream 4.0 (via FAL) | fal.run/fal-ai/bytedance/seedream/v4/text-to-image |
generate-image-seedream.py |
| Abstract / blog-cover visuals, fast | Flux 2 | FAL | generate-image.ts |
| Brainstorm / quick drafts | Gemini Flash | generate-image-gemini.ts |
|
| Photorealistic UGC / lifestyle | Grok Image Pro | xAI | generate-image-grok.ts |
| Logos / icons with text | OpenAI GPT Image 1.5 | OpenAI | generate-image-openai.ts |
Seedream 4.5 is the default (cheaper than 5.0, same quality tier for most work). Use 5.0 only when 4.5 visibly under-delivers on a hero shot. Seedream 4.0 is 25% cheaper than 4.5 if cost matters more than quality delta.
Cost monitoring (MANDATORY for any agent using this skill)
ModelArk's dashboard is opaque and lags — we must log our own costs. After every Seedance or Seedream call:
- Read
usage.output_tokens(Seedance) orusage.generated_images(Seedream) from the response. - Append to
video_projects/.cost-log.csv:timestamp, model, mode, resolution, tokens_or_pcs, est_cost_usd, project. - Rates (2026-04-18, verify against ModelArk UI if pricing shifts):
- Seedance 2.0 Fast: $0.0033/1K (with-video) · $0.0056/1K (t2v) — default
- Seedance 2.0 full: $0.0047/1K (with-video) · $0.0077/1K (t2v)
- Seedream 4.5: $0.04/piece (200 free pcs/month)
- Seedream 4.0: $0.03/piece (200 free pcs/month)
- Seedream 5.0: token-priced, premium
- Report cumulative spend at the end of each session.
- Flag to user when a single session crosses $20 or cumulative crosses $100.
Don't use legacy Seedance 1.0/1.5 for new work. The Fast variant of 2.0 is cheaper and higher quality than the old generations — the 2M free tokens on each legacy tier aren't worth the quality downgrade.
Video generation (image-to-video)
| Need | Model | Via | Agent |
|---|---|---|---|
| Cinematic motion, first+last frame control, multimodal refs, native audio — the default | Seedance 2.0 Fast (draft=true) | ByteDance ModelArk MCP | seedance-specialist |
| Hero shot where Fast visibly under-delivers | Seedance 2.0 Pro (draft=false) | ByteDance ModelArk MCP | seedance-specialist |
| Fast motion, audio sync, talking head | Kling V2.6 Pro | FAL | ai-video-creator |
| Fast + cheap | Wan V2.6 | FAL | ai-video-creator |
| Avatar animation (short loops) | Kling/LTX/Veo | FAL | animate-avatar skill |
Music / audio
| Need | Model | Via | Notes |
|---|---|---|---|
| Cinematic instrumental (best quality) | ElevenLabs Music | FAL fal-ai/elevenlabs/music |
$0.80/min, ~24s generation for 2min track. Do NOT name real artists — content moderation rejects. Use genre/mood descriptors. |
| Voiceover | ElevenLabs TTS | ElevenLabs direct | ELEVENLABS_API_KEY |
Post-production
See video-editor skill. Key scripts:
extract_frames.py— 1fps / N-samples frame extraction for vision analysiscompose_scenes.py— multi-scene library (per-scene grade + text overlay + xfade)append_endcard.py— attach TeamDay logo endcard (with Vector-3 emblem)mux_audio.py— add music with fade in/out, no video re-encode
ByteDance ModelArk — direct API
Use this when you need Seedream 5 or when FAL doesn't have a model yet.
Auth
export ARK_API_KEY="..." # in ~/.bash_profile
Endpoint base: https://ark.ap-southeast.bytepluses.com/api/v3/
Known model IDs (verified 2026-04-18)
Query live with: curl -sS "https://ark.ap-southeast.bytepluses.com/api/v3/models?limit=200" -H "Authorization: Bearer $ARK_API_KEY" | jq
Image generation (POST /api/v3/images/generations):
seedream-5-0-260128— newest, ~Jan 2026 release, best composition. Default.seedream-4-5-251128— Nov 2025seedream-4-0-250828— Aug 2025seedream-3-0-t2i-250415— Apr 2025, retiringseededit-3-0-i2i-250628— image-to-image editing, shutdown
Video generation (via Seedance MCP, or /api/v3/contents/generations/tasks):
seedance-1-5-pro-251215— newestseedance-1-0-pro-fast-251015— faster variantseedance-1-0-pro-250528seedance-1-0-lite-i2v-250428— retiring
Image generation call
curl -sS -X POST "https://ark.ap-southeast.bytepluses.com/api/v3/images/generations" \
-H "Authorization: Bearer $ARK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream-5-0-260128",
"prompt": "cinematic night shot of manhattan skyline, glowing amber tower...",
"size": "2560x1440",
"watermark": false,
"response_format": "url"
}'
Response:
{
"model": "seedream-5-0-260128",
"data": [{"url": "https://...tos-ap-southeast-1.volces.com/...jpeg", "size": "2560x1440"}],
"usage": {"generated_images": 1, "output_tokens": 17800}
}
Parameters
| Param | Values | Notes |
|---|---|---|
model |
see list above | seedream-5-0-260128 for cinematic |
prompt |
string | Detailed, English works best |
size |
WxH like 2560x1440, or generic 2K/4K |
2K=2560×1440 for 16:9, 4K=3840×2160 |
watermark |
true / false |
Default false in our script — true adds "AI generated" corner mark |
seed |
int | Reproducibility |
response_format |
url / b64_json |
URL expires in 24h — download immediately |
Aspect → native size cheatsheet (2K)
16:9→2560×14409:16→1440×25601:1→2048×20484:3→2048×153621:9→2688×1152
Our script generate-image-seedream-modelark.py handles all this — just pass --aspect 16:9 --size 2K.
Full worked example — 5-scene cinematic with TeamDay branding
PROJECT=~/teamday/video_projects/my_video
mkdir -p $PROJECT/{scenes,raw,processed,final,assets}
# 1. Keyframes via Seedream 5 (use for-loop, one per scene)
for i in 1 2 3 4 5; do
PROMPT=$(cat scene${i}_prompt.txt)
python3 ~/teamday/.claude/skills/generate-image/scripts/generate-image-seedream-modelark.py \
"$PROMPT" --out $PROJECT/scenes/scene${i}.png --aspect 16:9 --size 2K
done
# 2. Seedance i2v — delegate to seedance-specialist agent
# (Task tool with subagent_type=seedance-specialist, one call, 5 motion prompts)
# 3. Compose: write a 60-line compose.py importing from video-editor skill
cat > $PROJECT/compose.py << 'EOF'
import sys; sys.path.insert(0, '<HOME>/teamday/.claude/skills/video-editor/scripts')
from compose_scenes import Scene, compose
scenes = [
Scene('raw/scene1_raw.mp4', title='Scene 1 copy', subtitle='Sub 1',
contrast=1.35, sat=1.3, r_curve='...', g_curve='...', b_curve='...'),
# ... 4 more
]
compose(scenes, out='final/video.mp4', dur=4.0, xfade=0.5, W=1920, H=1080)
EOF
python3 $PROJECT/compose.py
# 4. Endcard
python3 ~/teamday/.claude/skills/video-editor/scripts/append_endcard.py \
$PROJECT/final/video.mp4 --out $PROJECT/final/video_branded.mp4 \
--tagline "Your AI workforce."
# 5. Music
python3 $PROJECT/generate_music.py # local script that calls ElevenLabs via FAL
# 6. Mux
python3 ~/teamday/.claude/skills/video-editor/scripts/mux_audio.py \
$PROJECT/final/video_branded.mp4 $PROJECT/assets/score.mp3 \
--out $PROJECT/final/video_final.mp4
Proven colour-grade presets (Jam/SuperScale premium pattern, ported)
| Mood | contrast | sat | bright | r_curve | g_curve | b_curve |
|---|---|---|---|---|---|---|
| Warm anticipation (amber) | 1.35 | 1.20 | -0.04 | 0/0 0.4/0.32 1/0.88 |
0/0 0.45/0.48 1/0.92 |
0/0.05 0.35/0.45 0.75/0.9 1/0.98 |
| Teal-amber reveal | 1.40 | 1.35 | -0.02 | 0/0.02 0.5/0.5 1/0.94 |
0/0 0.5/0.5 1/0.92 |
0/0.08 0.45/0.6 1/1 |
| Balanced warm-cool | 1.30 | 1.40 | 0.00 | 0/0 0.55/0.48 1/0.86 |
0/0 0.5/0.52 1/0.93 |
0/0.06 0.45/0.62 1/1 |
| Golden hero | 1.25 | 1.30 | 0.02 | 0/0.02 0.5/0.6 1/1 |
0/0 0.5/0.5 1/0.9 |
0/0 0.5/0.35 1/0.76 |
| High-tech cool | 1.35 | 1.20 | 0.00 | 0/0 0.6/0.5 1/0.82 |
0/0 0.5/0.52 1/0.95 |
0/0.06 0.4/0.65 1/1 |
Pitfalls (learned the hard way)
- Don't name real artists in ElevenLabs Music prompts — "Hans Zimmer" / "John Williams" etc. trigger
content_policy_violation. Paraphrase: "cinematic trailer-style orchestra", "monumental film-score feel". - Seedance 2.0 flags close-up human faces/silhouettes as privacy risk. Keep humans distant / back-turned; or fall back to text-to-video with a keyframe description.
- Seedream 5 returns JPEG with watermark by default — always pass
watermark: false(our script does). - FAL
image_sizeenum ≠ ModelArksize— FAL usessquare_hd, landscape_16_9, auto_2K, ...; ModelArk usesWxHlike2560x1440or2K/4K. Don't mix. - Seedance outputs 720p regardless of keyframe resolution (2K keyframe → 720p clip). Expected; the post pipeline upscales via
force_original_aspect_ratio=increase + crop. - ModelArk image URLs expire in 24h — always download immediately with
curl -sSL(our scripts do). - macOS Python urllib SSL can choke on some FAL/ModelArk certs. Our scripts fall back to
curlsubprocess. Don't useurllib.request.urlretrieve. - ffmpeg scale syntax is
W:HnotWxH— our CLI accepts both and translates. - Raw text overlays in video pipelines become pixel-burnt — can't remove later. If the brand might change, keep overlays as separate PNG layers muxed on xfade (which our
compose_scenes.pydoes). - Use the official TeamDay logo only —
docs/brand/A_4/Vector-3.png(the "Y" tulip emblem with gradient). Mirror copy in.claude/skills/video-editor/assets/teamday_logo.png. Never substitute.
Copy / tagline conventions
- "Your AI workforce." — primary endcard tagline
- "Always on. Never tired." — secondary
- "The team behind every great team." — alternate
- Don't use "conductor" — deprecated framing. Founders lead, AI works alongside, not under.
Related
.claude/skills/generate-image/— all image-gen scripts (Flux, Seedream 4+5, Grok, Gemini, OpenAI).claude/skills/image-to-video/— Kling/Wan i2v.claude/skills/video-editor/— post-production pipeline + Jam's reference scripts.claude/skills/animate-avatar/— short avatar loops.claude/skills/screenshot/— web/UI screenshots for product marketing.claude/agents/ai-image-creator.md— "Pixel" image agent.claude/agents/ai-video-creator.md— "Reel" video agent.claude/agents/seedance-specialist.md— Seedance 2.0 expert
Provenance
Most of this stack was reverse-engineered from Jam Alinson's SuperScale cinematic work on superscale (superscale_premium_showcase.mp4 and siblings). Scripts in video-editor/reference/ are his originals; compose_scenes.py is the reusable port. Seedream 5 discovery was a user prompt 2026-04-18 to check ModelArk docs — auth key was already on superscale's computer-blue container, just hadn't been surfaced in local env.