HappyHorse 視頻生成

通過 TENSORAXIS 調用阿里雲百鍊（DashScope）HappyHorse 系列：文生視頻、圖生視頻、參考生視頻與視頻編輯四大能力，以及參數與計費說明。

HappyHorse 是阿里雲百鍊（DashScope）視頻生成系列在 TENSORAXIS 上的接入，渠道 HappyHorse。它是異步任務：先提交任務取得 task_id，再輪詢任務狀態，完成後讀取視頻地址。提交與查詢的通用流程見視頻生成總覽，本頁只講 HappyHorse 特有的四種能力與參數。

四種能力按模型名後綴區分：

能力	模型	說明
文生視頻（t2v）	`happyhorse-1.1-t2v`、`happyhorse-1.0-t2v`	僅憑提示詞生成
圖生視頻（i2v）	`happyhorse-1.1-i2v`、`happyhorse-1.0-i2v`	基於 1 張首幀圖生成
參考生視頻（r2v）	`happyhorse-1.1-r2v`、`happyhorse-1.0-r2v`	基於多張參考圖生成
視頻編輯（video-edit）	`happyhorse-1.0-video-edit`	基於 1 段源視頻 + 參考圖編輯

本站入口字段

POST /v1/video/generations

字段	類型	必填	說明
`model`	string	是	HappyHorse 模型名，見上表
`prompt`	string	是	視頻提示詞；為空返回 `400 prompt is required`
`metadata.media`	array	視能力	媒體輸入數組，每項含 `type` 與 `url`；`type` 取 `first_frame` / `reference_image` / `video`
`images`	string[]	視能力	參考圖 URL（r2v 用）；未帶 `metadata.media` 時按參考圖處理
`image`	string	視能力	單張圖 URL（i2v 首幀用）
`input_reference`	string	視能力	輸入引用 URL（i2v 首幀 / r2v 參考圖的兼容入口）
`metadata`	object	否	分辨率、時長、畫面比例等參數，見參數

媒體輸入推薦統一走 metadata.media，用 type 明確每項用途。images / image / input_reference 是兼容入口：未提供 metadata.media 時，i2v 取 input_reference/image 作首幀，r2v 取 images/input_reference 作參考圖。視頻編輯的源視頻必須通過 metadata.media（type: video）傳入。

文生視頻（-t2v）

僅需 prompt，不接受媒體輸入。

curl https://api.tensoraxis.com/v1/video/generations \
  -H "Authorization: Bearer $TENSORAXIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-t2v",
    "prompt": "雪山腳下的湖面倒映著晚霞，鏡頭緩慢推進",
    "metadata": {
      "resolution": "1080P",
      "ratio": "16:9",
      "duration": 5
    }
  }'

圖生視頻（-i2v）

恰好 1 張首幀圖。可通過 metadata.media（type: first_frame）傳入，或用兼容入口 input_reference / image。不接受 ratio（畫面比例由首幀決定）。

curl https://api.tensoraxis.com/v1/video/generations \
  -H "Authorization: Bearer $TENSORAXIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-i2v",
    "prompt": "人物緩緩抬頭微笑",
    "metadata": {
      "resolution": "1080P",
      "duration": 5,
      "media": [
        { "type": "first_frame", "url": "https://example.com/first-frame.jpg" }
      ]
    }
  }'

參考生視頻（-r2v）

基於多張參考圖生成。網關接受 1–9 張參考圖（metadata.media 的 reference_image，或頂層 images）；官方建議 ≤5 張，超出部分以上游返回為準。

curl https://api.tensoraxis.com/v1/video/generations \
  -H "Authorization: Bearer $TENSORAXIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-r2v",
    "prompt": "讓這幾個角色在同一個場景裡互動",
    "images": [
      "https://example.com/ref-1.jpg",
      "https://example.com/ref-2.jpg"
    ],
    "metadata": {
      "resolution": "1080P",
      "ratio": "16:9",
      "duration": 5
    }
  }'

視頻編輯（-video-edit）

基於 1 段源視頻做編輯。必須通過 metadata.media 傳入恰好 1 個 type: video 的源視頻；可附帶參考圖（type: reference_image，網關 ≤5 張，官方 ≤4 張）。

不接受 duration：輸出時長沿用源視頻，因此不下發時長參數。
支持 audio_setting（僅本能力）：auto（默認）/ origin。

curl https://api.tensoraxis.com/v1/video/generations \
  -H "Authorization: Bearer $TENSORAXIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.0-video-edit",
    "prompt": "把背景替換成黃昏的城市天際線",
    "metadata": {
      "resolution": "1080P",
      "audio_setting": "origin",
      "media": [
        { "type": "video", "url": "https://example.com/source.mp4" },
        { "type": "reference_image", "url": "https://example.com/style.jpg" }
      ]
    }
  }'

參數

metadata 下的參數會映射為上游 DashScope 請求字段。「網關取值」為本站實際校驗/鉗制值；「官方說明」供參考，以上游返回為準。

參數	類型	適用能力	網關取值 / 默認	說明
`resolution`	string	全部	`720P` / `1080P`，默認 `1080P`	無法識別的值回退 `1080P`
`ratio`	string	僅 t2v / r2v	`16:9` / `9:16` / `1:1` / `4:3` / `3:4`；不傳時上游默認 `16:9`	i2v / video-edit 不接受
`duration`	integer	t2v / i2v / r2v	鉗制到 `[3,15]`，默認 `5`	video-edit 不接受（輸出沿用源視頻時長）
`seed`	integer	全部	`[0, 2147483647]`	固定隨機性；顯式 `0` 會保留下發
`watermark`	boolean	全部	默認 `false`（顯式下發）	是否添加水印
`audio_setting`	string	僅 video-edit	`auto`（默認）/ `origin`	音頻處理方式

duration 的官方範圍因場景而異（文生約 [2,15]、含視頻約 [2,10]），但網關統一鉗制到 [3,15]；越界值會被截到邊界。

計費說明

HappyHorse 按秒計費，並乘以分辨率係數（1080P 約為 720P 的 1.78 倍）。

t2v / i2v / r2v 的時長在請求中已知，按實際時長 × 分辨率係數結算。
視頻編輯無 duration 入參（輸出=源視頻時長），按 metadata.duration 聲明值計費；未聲明時使用保守默認（約 10 秒）。

具體單價以控制台「視頻計價」配置與定價頁為準；運營可按最新官方價覆蓋默認值。

任務查詢

提交、輪詢、狀態碼、OpenAI/Sora 兼容查詢路徑等通用流程，見視頻生成總覽。

On this page