Skip to content

Video ​

Feature Overview ​

ItemContent
Applicable RolesModel Provider, Model Consumer
Navigation PathModel Services > Playground > Video
Page Route/modelone/exploration/video
Managed ObjectsVideo models, prompts, reference assets, generation parameters, and job results

Beginner Explanation ​

The Video playground is a place to try a video model. Select a video model and provider from the selector, enter the input, adjust parameters, and review the result or error message before integration.

Terminology ​

TermDescription
Model InstanceThe model and provider combination used by the playground.
PromptInstructions that describe the task, input, and expected output.
Generation ParametersSettings that control length, randomness, size, or other generation behavior.
Personal KeyA personal credential used for calls. Documentation uses <PERSONAL_KEY>.

For a first trial, select a video model, verify the provider and Personal Key, configure the input and parameters, and then submit and review the result. Change only a few parameters at a time so that results remain comparable.

Beginner Checklist ​

ScenarioDo FirstDo Not Do Directly
Unsure which video model to useCompare status and capabilities in the selectorSubmit with the default model immediately
Preparing inputRemove credentials, customer data, and production dataPaste raw sensitive content
Preparing parameter changesChange only a few parameters at a timeChange every parameter together
Generation failsReview the page error and call logs firstSubmit repeatedly

Prerequisites ​

  1. The current account has access to the video Playground page.
  2. The target video model is authorized for the current account to try.
  3. Prompts, reference images, and video materials do not contain real keys, customer privacy, unauthorized materials, or sensitive content.
  4. Resolution, aspect ratio, duration, and advanced parameters have been confirmed to be within the target model support range.

Call, Billing, Async Task, and Content Risk

Clicking Generate creates a real model call and may consume credits or create call logs, billing records, and asynchronous tasks. Before submission, verify the model, parameters, asset authorization, expected cost, and queue time.

Page Description ​

The page contains video model selection, an input area, parameters, Personal Key selection, and a result area. Submission creates a real call and may create usage or billing records.

Page screenshots:

Video page

Focus on the model, input area, parameter entry, and submit button. Verify the input again before submission.

Main Operations ​

Select Video Model ​

  1. Go to Model Services > Playground > Video.
  2. Click the current model name or "Select Model" to open the selector.
  3. Locate the target model and compare provider, context, price, latency, throughput, success rate, and status.
  4. Select a listed instance and return to the playground. Confirm that the model and provider shown at the top are correct.

Select video model

The image shows the model selector. Compare provider capability, price, performance, and status.

video model selection reference

This image provides an additional view of model selection and instance information.

Configure and Generate Video Content ​

  1. Confirm that the current model, provider, and Personal Key are correct.
  2. Describe the video, upload reference assets when required, and set duration, aspect ratio, and generation parameters. Confirm asset authorization and cost, and then click "Generate".
  3. After submission, review the result, latency, usage, and error message. For a failure, check model status, quota, parameters, and rate limits first.
  4. When recording an issue, retain only a redacted request identifier, model name, and time. Do not copy real credentials or complete sensitive input.

Configure video generation

The image shows the input and parameter area. Verify the model, input, Personal Key, and generation settings before submission.

Parameter Reference ​

Field NameRequiredField TypeExampleDescription
ModelYesDropdownExample Video ModelVideo model currently being tried.
ProviderYesDropdownExample ProviderProvider instance of the current model.
PromptYesMultiline textGenerate a product showcase videoDescribes the video content, action, and style to generate.
Reference ImageConditionally requiredImage uploadreference.pngUsed for image-to-video, reference-to-video, or video editing scenarios.
ResolutionNoOption1080PControls the generated video resolution.
Aspect RatioNoOption--Controls the generated video aspect ratio.
DurationNoNumber / Option0Controls the generated video duration.
ProtocolNoDropdownopenai/videoProtocol used by the current video generation call.
Negative PromptNoTextblurry, shakyDescribes content that should not appear in the video.
Audio SettingNoDropdownautoControls audio generation or retention strategy.
Prompt ExtendNoToggleOnControls whether prompt extension is enabled.
WatermarkNoToggleOffControls whether a watermark is added.
Generated ResultNoVideo / Task areaGenerated video or task progressDisplays generated videos, task progress, error messages, or an empty state.

Pitfalls ​

  • Do not upload or describe videos or reference images containing customer privacy, faces, license plates, contracts, medical records, or unauthorized materials.
  • Video generation usually takes longer. Higher resolution, longer duration, and more complex reference materials increase cost and failure probability.
  • Generated videos may involve copyright, portrait rights, trademarks, and compliance boundaries. Confirm authorization before formal use.
  • Video generation may create asynchronous or queued tasks. Check existing task status before submitting again.

Result Validation ​

Check ItemSuccess SignalIf Abnormal
Page is accessibleThe Video page opens, and the left Playground menu and top model selector are visible.Check account permissions, navigation path, and page loading status.
Model selector loadsThe model selector can be opened and shows model list, provider instances, and status information.Refresh the page and retry, or confirm whether the target model is visible to the current account.
Input and parameter areas are visibleReference image entry, prompt input box, Resolution, Ratio, Duration, Negative Prompt, Audio Setting, Prompt Extend, and other fields are visible.Check whether the page has fully loaded. If needed, switch models and view again.
Result area is visibleThe page shows generated results, task progress, an error message, or an empty state.If there is no generation record, confirm that the input and parameter areas remain visible.
Real generation returns a resultWhen generation is explicitly allowed, the page returns a generated video, task progress, or clear error message.Adjust the prompt, lower resolution, or shorten duration, and check error messages or call logs.

FAQ ​

Target Model Is Missing ​

Symptom:

The target model does not appear in the selector.

Possible Causes:

  • The model is not authorized for the account.
  • Its status or modality does not match the page.

Resolution:

  1. Verify visibility and model status.
  2. Confirm input and output capabilities in Models.

Submit Is Unavailable ​

Symptom:

The request cannot be submitted after input is entered.

Possible Causes:

  • No model or Personal Key is selected.
  • Required input or parameters are incomplete.

Resolution:

  1. Select the model and Personal Key again.
  2. Complete the required input and parameter fields marked on the page.

Generation Fails or Times Out ​

Symptom:

The request fails or remains pending.

Possible Causes:

  • The model service is busy or rate-limited.
  • Input or parameters exceed model limits.

Resolution:

  1. Review the page error and call logs.
  2. Shorten input or restore default parameters and retry.

Result Does Not Meet Expectations ​

Symptom:

The result does not meet content, format, or quality requirements.

Possible Causes:

  • The prompt lacks constraints.
  • Too many parameters changed together.

Resolution:

  1. Add goals, format, and prohibited content.
  2. Restore baseline settings and compare one change at a time.

Usage or Cost Is Unexpected ​

Symptom:

One trial creates more usage than expected.

Possible Causes:

  • Output size or generation count is too large.
  • The same task was submitted repeatedly.

Resolution:

  1. Check generation settings and call logs.
  2. Stop repeated submissions and confirm billing scope.

Notes ​

  • Do not upload or describe videos containing customer privacy, faces, license plates, contracts, medical records, or unauthorized materials.
  • Long videos and high-resolution generation significantly increase latency, cost, and failure probability.
  • Before screenshots, confirm that prompts, materials, and generated content can be public.

Next Steps ​

  1. Save reusable prompts and parameter combinations.
  2. When troubleshooting is needed, use model name, time, and error messages to view call logs.
  3. Before using generated videos formally, confirm copyright, portrait rights, compliance, and public distribution scope.