Video overview

Video generation is asynchronous: submit a task to get a task ID, poll until it finishes, then download the clip before its link expires.

# 1. Submit a task and keep the returned task.id (shaped like vt…)
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-5-260628",
    "content": [
      {
        "type": "text",
        "text": "An orange cat runs across sunlit grass as the camera follows"
      }
    ]
  }'

# 2. Query every 5 seconds until task.status is completed
#    The clip URL is in task.outputs
curl https://api.hop-base.com/v1/video/tasks/vt-your-task-id \
  -H "Authorization: Bearer sk-your-key"

Choose a family

HopBase sells six video model families. Every family follows the same async flow below: submit → poll → download.

The price column shows each family's lowest starting tier; full tiers are on each family page and the model cards, and special modes such as Kling lip sync are priced separately. Your own rate is the one shown in the signed-in Model Plaza.

Model IDs and groups

Each family sits in its own group, so call it with a key that includes that group.

Kling also has motion control, avatar, and lip sync variants; see the Kling page. Each family's minimum request and result location:

MiniMax text-only requests also require ratio. Kling's special modes are on the Kling page. Seedance content[] usually carries text and image_url items.

Task flow: submit → poll → download

Every video model follows these three steps.

Submit

HopBase hands each request to the right family based on its model and the key's groups. Request bodies and status values differ by family, so follow each family's page. Families return different success codes on submit, so treat any 2xx as a successful submission.

A key reaches only the families whose groups it includes; one key can include several video groups. Call GET /v1/models with the key you intend to use and take the complete model ID from the response. Model IDs are exact: an unknown name is rejected, never routed to a near match.

Poll

Query the task ID returned on submit until the task succeeds or fails. Seedance, Grok Imagine, MiniMax, and Kling also have a task list:

GET /v1/video/tasks?page=1&limit=20

Wan 3.0 and HappyHorse have no list endpoint, so keep track of task IDs on your side.

Download

Output URLs are signed URLs on api.hop-base.com, valid from the moment the task completes:

Querying again returns the same URL without extending it, and an expired URL returns 410. Download and save results promptly.

Balance and billing

A video submit checks available balance minus the estimates for in-flight tasks minus this request's estimate. If that falls short you get a 402 with code insufficient_balance. The estimate is released automatically when the task ends.

Insufficient balance: available $X, reserved in flight $Y, this request estimated $Z
Insufficient quota: …    # an enterprise member with a spending quota; the message starts with this

Kling lip sync cannot be estimated and reserves nothing.

Failed video tasks are never billed. Once a task is finished, the single-task query also returns a top-level usage:

A failed task that was not charged shows 0. The field is absent while the task is running, and a single-task query returns it only to the key that created the task; amounts in the examples are illustrative. In the task list (GET /v1/video/tasks without a task ID), every finished task carries the same cost, cost_usd, and currency in its usage; the list covers the whole account, so tasks created by other keys of the same account carry the amount too.

Official list prices are on the pricing page. Your own rate is the one shown in the signed-in Model Plaza, and each request's actual charge is on the Usage page in the console.

Failures, timeouts, and cancellation

A 2xx submit only means the task was accepted. A failed generation still queries as HTTP 200 with a failed status and an English reason, but no stable error code.

Seedance puts the reason in task.error.message; for other families, see their pages. The console Usage page shows the failure category and a suggested fix. See Errors.

The time limit for running tasks differs by family; see each family's page. A Seedance task still unfinished 24 hours after creation is failed automatically with this message:

The task did not finish within 24 hours and was terminated automatically

Video tasks cannot be cancelled.

Reference media comparison

How many references each model accepts:

• Seedance takes at most 2 first/last-frame images; on 2.0, frame mode is separate from reference mode.
• On MiniMax-H3, frames and references are exclusive; H3-Max takes no reference_* inputs.
• Wan 3.0 takes ≤1 document or webpage (exclusive), and frames exclude the reference group.
• Kling usage and special modes depend on the variant's contract; see the Kling page.
• Grok Imagine content is text only.

Which encodings each model accepts:

The Seedance 2.0 library registration URL accepts HTTP(S) only. On MiniMax-H3-Max, encoding does not bypass type restrictions. HappyHorse takes no video/audio references.

A Data URL is data:media-MIME;base64,encoded-content, not raw base64.

Next steps

• Seedance: Seedance 2.0 / 2.5 parameters, responses, and errors
• Kling: Kling video parameters and task modes
• API reference: Submit a video task: every request field for each family
• Concurrency, timeouts, and billing: concurrency caps, timeouts, and billing rules
• Error codes and retries: what each error code means and whether to retry