Skip to content

Publish a Model (Video) ​

Target Outcome ​

The video model creates an asynchronous task, reports progress correctly, and returns a playable result after publication.

Applicable Roles ​

  • Model Provider

Before You Start ​

  • Prepare the model source, identifier, API credential, task endpoint, status endpoint or callback, and a harmless test prompt.
  • Confirm duration, resolution, polling behavior, result lifetime, billing, timeout, and rate limits.

Procedure ​

  1. From the platform home page, select My Models in the left navigation.
  2. Open My Publications. Use Public Models / Private Models to switch publication areas, or open Overview and My Aggregations when needed.
  3. Select Publish Model in the upper-right corner.
  4. Select a publication area:
    • Publish to Private Area makes the model visible only within the team or tenant and keeps it out of the public catalog.
    • Publish to Public Area lists the model in the public catalog for all tenants and allows independent pricing and rate limits.
  5. Select Publish to Public Area to open Step 1.

Choose the publication area

Step 1: Basic Information ​

  • Under Model Source / Meta-Model Information:
    • Select a meta-model, such as wan2.7-t2v.
    • Select a model source, such as Alibaba - China.
    • Enter the request URL, such as https://dashscope.aliyuncs.com.
    • Enter the API key in the protected field, such as sk-***.
    • Enter the exact upstream Model Source ID, such as wan2.7-t2v.

Model source and meta-model information

  • Confirm Video Model and select the correct subtype, such as Text to Video.

Confirm the model type

  • Under Request Headers, keep the default Authorization: Bearer <key> template and add only headers required by the upstream service.

Configure request headers

  • Under Model Parameters, select verified input modalities such as Text and Audio and set the output modality to Video.

Configure model parameters

  • Under Supported Protocols and Default Parameters:
    • Select OpenAI-Video, run the connectivity test, and enter the endpoint.
    • Configure inputs such as Prompt, Negative Prompt, Audio URL, Resolution, Ratio, Prompt Extend, Watermark, Duration, and Seed.
    • Select Asynchronous invocation.
    • Enter the task-status endpoint or callback, such as https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}. Use a provider template or select Custom for manual mapping.
    • Configure Status Path, Result Path, Task ID Path, Success Value, Failure Value, and URL Extract Field.

Test the official native protocol

  • Enter the public Custom Identifier and description.

Complete basic information

  • Select Publish Immediately or Scheduled Publication.

Choose the publication method

  • Select Next to open Step 2.

Step 2: Billing Configuration ​

  • Select Token Billing, Duration Billing, or Free.
  • For paid billing:
    • Enable Show Price Comparison when a reference price should be displayed.
    • Optionally distinguish whether the input contains video.
    • Optionally distinguish whether the output contains audio.
    • Optionally enable output-resolution pricing using resolution as the recognition field.
    • Add every required combination to the price matrix and enter a price in Credits per second for each resolution and feature combination.
    • Optionally configure a free quota, eligible-user count, and total amount.

Configure billing

  • Select Next to open Step 3.

Step 3: Rate-Limit Configuration ​

  • Select Enable Rate Limiting or Disabled.
  • Configure default RPM and TPM values, or set either limit to Unlimited.

Configure rate limits

  • Select Save Only or Submit for Review.

Parameter Reference - Video Model ​

FieldTypeExampleDescription
Meta-ModelSelectwan2.7-t2vRequired; base meta-model
Model SourceSelectAlibaba - ChinaRequired; upstream Model Provider
Request URLURLhttps://dashscope.aliyuncs.comRequired; model-service base URL
API KeyPasswordsk-***Required; protected upstream credential
Model Source IDTextwan2.7-t2vRequired; exact upstream model name
Model TypeSingle selectVideo ModelRequired; model function
Model SubtypeSelectText to VideoRequired; video-model subtype
Request HeadersKey-value pairsAuthorization: Bearer <key>Optional; authentication and custom headers
Input ModalitiesMulti-selectText / AudioRequired; accepted input types
Output ModalityMulti-selectVideoRequired; result type
Supported ProtocolMulti-selectOpenAI-VideoRequired; test connectivity before continuing
EndpointURLhttps://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesisRequired; protocol endpoint
Input ParametersParameter listPrompt / Negative Prompt / Audio URL / Resolution / Ratio / Prompt Extend / Watermark / Duration / SeedOptional; protocol inputs and required-state settings
Invocation MethodSingle selectAsynchronousRequired; video generation is normally asynchronous
Task Status URLURLhttps://dashscope.aliyuncs.com/api/v1/tasks/{task_id}Required; status-query or callback URL
Provider TemplateSingle selectVolcengine / Alibaba International / CustomRequired; fills provider mappings or allows custom values
Status PathTextstatusOptional; field containing task status
Result PathTextcontentOptional; field containing the result payload
Task ID PathTextidOptional; field containing the task identifier
Success ValueTextsucceededOptional; value representing success
Failure ValueTextfailedOptional; value representing failure
URL Extract FieldTextvideo_urlOptional; field containing the result URL
Custom IdentifierTextwan2.7-t2vRequired; model identifier shown to users
DescriptionTextText to video...Optional; model description
Publication MethodSingle selectImmediate / ScheduledRequired; publication time
Billing MethodSingle selectToken / Duration / FreeRequired; billing method
Input Contains VideoSwitchOn / OffOptional; differentiates prices by video input
Output Contains AudioSwitchOn / OffOptional; differentiates prices by audio output
Output ResolutionSwitchOn / OffOptional; differentiates prices using resolution
Price MatrixGroup480P: 6 Credits/second; 720P: 10 Credits/secondRequired; price for each configured combination
Free QuotaSwitchOn / OffOptional; configures free usage quota
Rate LimitingSingle selectEnabled / DisabledOptional; controls invocation limits
RPMNumber / Unlimited2 requests/minuteOptional; request limit per minute
TPMNumber / Unlimited100 tokens/minuteOptional; token limit per minute

Completion Checklist ​

Purpose: These are the exit criteria for the current feature task. Use them to decide whether the result is observable and reviewable and whether you can continue to the next step in the scenario. They do not repeat the procedure; if any item fails, follow the troubleshooting section below.

CheckPass Criteria
1Task creation, status query or callback, and result parsing all pass testing.
2Publication or review status is correct.
3A controlled call returns a playable video and the call log is traceable.

Troubleshooting ​

SymptomCheck First
A task is created but never completesStatus endpoint, task-ID mapping, polling interval, callback, and timeout
The result URL is unavailableResponse mapping, URL lifetime, storage permission, and content policy

User Manual ​

Review complete My Models fields and publication-result validation