Video generation
Generate video synchronously with Gemini Omni or through the Seedance 2.0 asynchronous task API.
HopBase provides two video APIs. Gemini Omni returns a 3-10 second, 720p, 24 FPS base64 MP4 synchronously through POST /v1/interactions. Seedance 2.0 uses the asynchronous task API below and supports more resolutions, durations, and reference-image options. Use the matching plan-group key and check GET /v1/models first.
Seedance 2.0 asynchronous task API
1. Submit a generation task
curl https://api.hop-base.com/v1/video/generate \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{
"model": "dreamina-seedance-2-0-hc",
"content": [
{ "type": "text", "text": "An orange cat runs across sunlit grass as the camera follows" }
],
"duration": 5,
"resolution": "720p",
"ratio": "16:9",
"generate_audio": false,
"watermark": false
}'The response contains a task.id such as vt... for later status queries. For image-to-video, append this object to content:
{
"type": "image_url",
"image_url": { "url": "asset://asset-id" },
"role": "reference_image"
}| Parameter | Description |
|---|---|
model | Video model; see the model table below (required) |
content | Input array containing a text prompt and optional image_url reference images; use role to identify each reference |
duration | Video duration in seconds, such as 5, 10, or 15 |
resolution | 480p, 720p, 1080p, or 4k; only standard models support 1080p and 4k |
ratio | 16:9, 9:16, 1:1, 4:3, and other supported aspect ratios |
generate_audio | Whether to generate audio with the video |
watermark | Whether to add a watermark |
Other model parameters pass through unchanged, so new upstream options do not require a gateway update.
2. Poll task status
# Single task; polling every 5 seconds is recommended
curl https://api.hop-base.com/v1/video/tasks/vt-your-task-id \
-H "Authorization: Bearer sk-your-key"
# Task list; optionally append ?page=1&limit=20
curl https://api.hop-base.com/v1/video/tasks \
-H "Authorization: Bearer sk-your-key"status is pending, processing, completed, or failed. When complete, read the video URL from outputs. usage.completion_tokens contains the billable token count. 480p and 720p generation usually takes 2-5 minutes; 1080p and 4k take longer.
Video URL expiration
outputs contains a direct video URL on api.hop-base.com with browser playback and Range requests. HopBase does not retain the video file permanently. The URL expires 24 hours after generation, so download the result promptly.
3. Upload a reference image asset (optional)
curl https://api.hop-base.com/v1/sd/assets \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{
"URL": "https://example.com/your-image.jpg",
"Name": "character_front",
"AssetType": "Image"
}'The returned data.Id is the asset ID. Reference it as asset://asset-id during generation. URL must be publicly accessible. Query the asset with GET /v1/sd/assets/{asset-id}.
Models and current standard pricing
Prices are in USD per million video tokens.
| Tier | Model ID | Resolution | Text-to-video | Image-to-video |
|---|---|---|---|---|
| Standard | dreamina-seedance-2-0-hcdreamina-seedance-2-0-epdreamina-seedance-2-0-260128 | 480p / 720p | $6.30 | $3.87 |
| Standard | Same as above | 1080p | $6.93 | $4.23 |
| Standard | Same as above | 4k | $3.60 | $2.16 |
| Fast | dreamina-seedance-2-0-fast-hcdreamina-seedance-2-0-fast-epdreamina-seedance-2-0-fast-260128 | 480p / 720p | $5.04 | $2.97 |
| Mini | dreamina-seedance-2-0-mini-hcdreamina-seedance-2-0-mini-epdreamina-seedance-2-0-mini-260615 | 480p / 720p | $3.15 | $1.89 |
The current standard price is 90% of the official benchmark price, based on a 6.12 group multiplier and a 6.8 reference exchange rate. Billable tokens grow with resolution and duration, approximately pixels x frame rate x duration / 1024. The lower 4k token price is offset by a much larger token count. A 480p, 5-second Mini video is approximately 48,400 tokens or $0.15. The signed-in model catalog and actual task usage are authoritative.