superouter Video Gen

Overview

This skill is for the superouter platform API, not for talking to Jimeng upstream directly.

Default model: seedance-2.0-v1,you can get model list from the server.

Use this skill when the user wants to:

• - upload ordered reference assets
• submit an async video generation task
• query status with platform INLINECODE1
• download the final video from the real URL returned by the platform

The platform currently exposes:

• - INLINECODE2
• INLINECODE3
• INLINECODE4
• INLINECODE5
• INLINECODE6
• INLINECODE7

Preconditions

• - SUPER_KEY must be a superouter client API key
• If the platform returns 401 or 403, stop and tell the user the client key is invalid or disabled
• Default ratio for short drama generation is 9:16 only when the user did not give a ratio
• Default model is seedance-2.0-v1; do not invent other fields that affect generation

Current Platform Rules

Prompt

• - prompt max length: 2000 characters

File types

• - Images: jpg jpeg png webp gif INLINECODE20
• Video: mp4 mov INLINECODE23
• Audio: mp3 INLINECODE25

File limits

• - Single file max: INLINECODE26
• Total referenced asset size per task max: INLINECODE27
• Image shortest side min: INLINECODE28
• Image long/short side ratio max: INLINECODE29
• Video duration max: INLINECODE30
• Audio duration max: INLINECODE31

Seedance submit limits

• - aspectRatio: 1:1 4:3 3:4 16:9 9:16 INLINECODE38
• INLINECODE39: INLINECODE40
• INLINECODE41: 4 to INLINECODE43
• INLINECODE44: currently only INLINECODE45

Pricing

For seedance-2.0-v1:

• - no video reference: INLINECODE47
• any video reference present: INLINECODE48
• if duration is omitted, use 4 seconds for estimation

INLINECODE51 and query currently do not deduct credits.

Asset selection principles

• - Only upload the people or scene references that actually matter for the current shot
• Keep the asset list as small and ordered as possible
• If clothing continuity is critical, add clothing references explicitly instead of assuming them
• Video generation is sensitive to reference order; keep references[] in the exact business order

Workflow

1. Check balance before submit

Use platform balance, not upstream quota:

CODEBLOCK0

Estimate credits before submit:

• - use duration if provided, otherwise INLINECODE55
• if any reference asset is video, multiply by INLINECODE56
• otherwise multiply by INLINECODE57

If balance is insufficient, stop before upload/submit and explain the estimated cost.

2. Validate local inputs

Before any upload:

• - confirm every referenced local file exists
• confirm prompt length is INLINECODE58
• do not invent file order
• keep placeholder names aligned with reference order

If the prompt uses named placeholders such as <<<Image1>>>, make sure the corresponding references[].name values match exactly.

3. Upload assets first

Upload each local file to the platform and collect fileId.

CODEBLOCK1

Response example:

CODEBLOCK2

Rules:

• - always save the returned INLINECODE62
• same-client duplicate upload may return an existing INLINECODE63
• do not assume one upload call accepts multiple files unless the user specifically wants to script multiple sequential uploads
• you can save fileId for next submit if file is same.

4. Submit the task

Submit to the platform, not to Jimeng directly.

CODEBLOCK3

Rules:

• - keep references[] in the exact intended order
• first reference is the first logical asset, second reference is the second logical asset, and so on
• do not invent aspectRatio, resolution, duration, or INLINECODE69
• default to async submit behavior; the platform returns INLINECODE70
• after success, report taskId and the estimated credit cost

Successful response shape:

CODEBLOCK4

5. Query task status

Use platform taskId.

CODEBLOCK5

Possible status values you should expect:

• - INLINECODE73
• INLINECODE74
• INLINECODE75
• INLINECODE76

Completed response example:

CODEBLOCK6

Rules:

• - the returned videos[].url is the real download URL; give it directly to the user
• do not proxy-download unless the user explicitly asks you to save the file locally
• if status is processing, report that clearly and stop unless the user asked you to keep polling
• if status is failed, return errorMessage; the platform may refund automatically

6. Optional task list

If the user wants recent tasks instead of querying a single task:

CODEBLOCK7

Use this to inspect recent platform tasks. The platform may refresh incomplete tasks when listing them.

Prompt / ordering rules

• - Keep the reference list in the same order the user intends the model to read it
• Use @1 placeholders only when the request actually names references
• If the user gives unnamed files only, keep order and do not invent semantic names
• If the user asks for a shot prompt rewrite, keep the asset references consistent with the final INLINECODE82

Fixed rules

• - Use the superouter platform API only
• Default only the model; ask for missing generation inputs that materially affect output
• Do not claim success before you have a platform INLINECODE83
• Do not wait for completion by default after submit
• If the service is unreachable, tell the user to check whether the superouter API is running