name: doubao-video-api description: "通過 Thingo 中轉站（OpenAI 相容格式）呼叫 Doubao Seedance 影片生成 API，支援文本生影片、首幀圖生影片、影片延長/編輯。適配所有 OpenAI 相容格式的影片生成中轉站。" version: 1.1.0 author: Hermes Agent license: MIT platforms: [windows, linux, macos] tags: [video, doubao, seedance, generation, multimodal, thingo, relay] related_skills: [doubao-image-api]

Doubao Video API（豆包影片生成 — Thingo 中轉站）

角色定位

你是影片生成呼叫助手。當用戶要求用文本生成影片、基於圖片生成影片、延長或編輯影片時，使用本 Skill 通過 Thingo 中轉站（OpenAI 相容格式） 呼叫 Doubao Seedance 影片生成 API，並返回本地儲存的 MP4 檔案路徑。

本技能已寫死適配 Thingo 中轉站（uniapi.thingo.com.cn），使用 OpenAI 相容的請求/響應格式。如需切換到其他中轉站，只需修改 config.json 中的 base_url 和 api_key 即可（前提是目標中轉站同樣使用 OpenAI 相容格式）。

觸發條件

• 使用者說"生成一個影片""幫我做一段影片""根據這段描述生成影片"
• 使用者提供首幀圖/參考圖，要求生成影片
• 使用者提供參考影片，要求延長/編輯
• 使用者明確要求使用 Seedance 或影片生成能力

適用場景

• 文本生影片：使用者給出文字描述，生成對應影片（最常用）
• 首幀圖生影片：使用者提供首幀圖片 URL，生成延續影片
• 影片延長/編輯：使用者提供參考影片 URL，要求延長或修改

前置條件

1. config.json 中已配置 base_url、api_key、model
2. Thingo 中轉站可訪問
3. 賬戶餘額充足（約 ¥11.50/次）
4. 如使用參考圖/影片，需提供公網可訪問的 URL（http(s)://）

快速開始

1. 配置（一次性）

手動建立 config.json（推薦）或執行 python scripts/init.py 互動式配置：

{
  "base_url": "https://uniapi.thingo.com.cn/v1",
  "api_key": "sk-你的金鑰",
  "model": "doubao-seedance-2-0-260128",
  "api_path": "video/generations",
  "save_dir": "./output",
  "download": true
}

⚠️ base_url 不要出現雙斜槓：/v1 而非 //v1，否則中轉站返回 HTML 頁面導致 JSON 解碼失敗。

2. 生成影片

命令列：

# 文本生影片
python scripts/gen.py "一隻可愛的小貓正在吃魚，畫面溫馨治癒" --ratio 16:9 --duration 5

# 首幀圖生影片（需公網 URL）
python scripts/gen.py "鏡頭推近特寫" --ratio 9:16 --duration 5 --image-url https://example.com/frame.png

# 指定儲存目錄
python scripts/gen.py "星空下的城市夜景" --ratio 16:9 --duration 5 --save-dir ./my_videos

Python 函式呼叫：

from scripts.gen import generate_video
result = generate_video(
    prompt="一隻可愛的小貓正在吃魚",
    ratio="16:9",
    duration=5
)
# result = {"model": "...", "task_id": "...", "status": "succeeded",
#           "video_url": "https://...mp4", "local_path": "C:/.../xxx.mp4"}

執行流程

1. 讀取技能根目錄的 config.json，確認 api_key 已配置
2. 根據使用者輸入構建 prompt、ratio、duration 等引數
3. 呼叫 python scripts/gen.py "<prompt>" --ratio 16:9 --duration 5
4. 指令碼自動輪詢非同步任務直到完成（預設最長等待 600 秒）
5. 自動下載影片到本地，返回本地路徑

引數說明

輸出格式

{
  "model": "doubao-seedance-2-0-260128",
  "task_id": "task_xxx",
  "status": "succeeded",
  "video_url": "https://...mp4",
  "local_path": "C:/Users/xxx/Desktop/20260723_134634_00_xxx.mp4",
  "usage": {"completion_tokens": 108900, "total_tokens": 108900}
}

API 格式說明（重要）

本技能使用 Thingo 中轉站的 OpenAI 相容格式，與 Doubao 官方 Ark API 格式不同：

切換到其他中轉站

如果目標中轉站也使用 OpenAI 相容格式，只需修改 config.json：

{
  "base_url": "https://你的中轉站地址/v1",
  "api_path": "video/generations",
  "api_key": "sk-你的金鑰"
}

如果目標中轉站使用官方 Ark 格式，請將 api_path 改回 contents/generations/tasks 並調整 gen.py 中的請求格式。

可用模型（Thingo 中轉站）

可通過 GET /v1/models 檢視當前可用模型：

注意事項

• 影片生成是非同步任務，指令碼自動輪詢直到完成（預設最長 600 秒），請耐心等待
• 參考圖/影片必須是公網可訪問的 URL（http(s)://），本地檔案不會自動上傳
• 生成的影片 URL 有效期約 24 小時，本技能預設開啟 download=true 自動儲存到本地
• 不支援自定義解析度引數（如 480p），傳入 size 引數會觸發計費錯誤
• 如果任務本質是生成圖片而非影片，應優先使用 doubao-image-api 技能
• 賬戶餘額需 ≥ ¥11.50/次，餘額不足會返回 403

常見坑

1. scripts/init.py 非互動式終端報 EOFError

7w4.net小蔥技能站，你的AI助手技能庫。

Agent 自動執行環境不支援互動輸入。手動建立 config.json 或設定環境變數 ARK_BASE_URL / ARK_API_KEY。

2. JSON 解碼錯誤 Expecting value: line 1 column 1

原因：base_url 包含雙斜槓（如 //v1），中轉站返回 HTML 頁面而非 JSON。 解決：確保 base_url 為 https://uniapi.thingo.com.cn/v1（單斜槓）。

3. Invalid URL 錯誤

原因：api_path 配置錯誤，使用了官方 Ark 路徑。 解決：本技能已寫死為 video/generations，不要改為 contents/generations/tasks。

4. insufficient_user_quota 餘額不足

原因：Thingo 賬戶餘額不足 ¥11.50。 解決：充值 Thingo 賬戶，或切換到更便宜的模型。

5. 參考圖/影片不生效

原因：Thingo 中轉站可能不完全支援圖生影片/影片編輯。 解決：目前以文本生影片為主，其他模態的支援取決於中轉站。

6. 打包分發時包含敏感資料

上傳到 SkillHub 前排除 output/（含生成的影片）和 config.json（含 API Key），只保留 config.example.json 作為模板。

安裝

python scripts/init.py
python scripts/gen.py "一隻可愛的小貓正在吃魚" --ratio 16:9 --duration 5

這個影片生成 Skill 功能描述清晰，能通過文字生成影片、基於圖片生成影片或延長影片，但下載後可能無法直接使用——缺少可執行的指令碼檔案，配置過程需要手動修改檔案。文件質量不錯，說明詳細，但缺少配套的示例影片或實際效果展示，充值和費用說明也比較含糊。總體來說是一個思路清晰但落地不足的 Skill。