byteplus-api

BytePlus ModelArk API CLI — raw wrapper a Seedance videó-generáláshoz.

API docs: https://docs.byteplus.com/en/docs/ModelArk/2298881

Auth

export BYTEPLUS_API_KEY=...        # (vagy ARK_API_KEY)
# régió felülírása: export ARK_BASE_URL=https://ark.ap-southeast.bytepluses.com/api/v3

Parancsok

# Text-to-video (480p/5s)
byteplus-api generate -p "a rocket launching into space" \
  --ratio 16:9 --resolution 480p --duration 5 --generate_audio -o out.mp4

# Image-to-video (first frame) — ⚠️ fotorealisztikus arcot eltilt (lásd lent)
byteplus-api generate -p "camera slowly pulls out" --image @./start.png -o out.mp4

# First+last frame
byteplus-api generate -p "360 orbit" --image @./first.png --image @./last.png

# Task lekérdezése
byteplus-api status cgt-...

Aszinkron: POST /contents/generations/tasks → {id}, majd GET .../tasks/{id} poll succeeded-ig, a videó a content.video_url-ben.

Modellek

| Model ID | Megjegyzés | |---|---| | dreamina-seedance-2-0-260128 | Seedance 2.0 (default), max 1080p, native audio | | dreamina-seedance-2-0-fast-260128 | Fast, max 720p | | seedance-1-5-pro-251215 | 1.5 Pro | | seedance-1-0-pro-250528 | 1.0 Pro |

Árak

Token-alapú, csak sikeres generálásért fizetsz. Forrás: ModelArk Pricing.

tokens = (input_video_dur + output_video_dur) × W × H × fps / 1024
price  = unit_price × tokens

Unit price (USD / M token):

| Model | 480p/720p no-video | 480p/720p +video | 1080p no-video | 1080p +video | |---|---|---|---|---| | Seedance 2.0 | 7.0 | 4.3 | 7.7 | 4.7 | | Seedance 2.0 Fast | 5.6 | 3.3 | — | — |

Példa-árak (5s, 16:9, text-to-video):

| Felbontás | Seedance 2.0 | 2.0 Fast | |---|---|---| | 480p | $0.35 | $0.28 | | 720p | $0.76 | $0.60 | | 1080p | $1.87 | — |

Prepaid resource pack kell az aktiváláshoz: Standard $4.30/1M, Fast $3.30/1M token.

BytePlus (direkt) vs AtlasCloud

Ugyanaz a Seedance modell elérhető AtlasCloudon (atlas CLI) is, de ~60%-kal drágább:

# AtlasCloud (atlas CLI) — brew install AtlasCloudAI/tap/atlascloud
atlas generate cost video bytedance/seedance-2.0/text-to-video \
  --resolution 480p --duration 5 --aspect-ratio 16:9 -p "test"
atlas generate video bytedance/seedance-2.0/text-to-video \
  --resolution 480p --duration 5 --aspect-ratio 16:9 -p "..." -o out.mp4

| | BytePlus (USD/M token) | AtlasCloud (USD/M token) | |---|---|---| | 480p/720p no-video | 7.0 | 11.20 | | 480p/720p +video | 4.3 | 6.88 | | 480p/5s becsült | ~$0.35 | ~$0.48 |

AtlasCloud headline per-second ár: Seedance 2.0 $0.096/s, Fast $0.076/s (−15% kedvezménnyel). Konklúzió: sok videóhoz a BytePlus direkt olcsóbb; Atlas az unified SDK/billing kényelméért fizet.