ToAPIs
    homeToAPIs
    模型廣場模型定價API 文檔
    登錄免費開始

    快速结论

    • viduq3-drama supports Text-to-Video, Image-to-Video, R2V, and Video Edit in one workflow.
    • Use this model guide page to validate parameters with minimal request/response examples.
    • Stabilize prompts here first, then move to production API integration.

    关键参数

    • model | string | 必填 | viduq3-drama | - | Model identifier. Use the fixed value `viduq3-drama`.
    • prompt | string | 必填 | - | - | Main instruction describing the subject, action, scene, and style.
    • aspect_ratio | string | 可选 | 16:9 | 16:9 | 9:16 | 4:3 | 3:4 | 1:1 | Video aspect ratio. Defaults to `16:9`; supports `16:9 | 9:16 | 4:3 | 3:4 | 1:1`.
    • duration | integer | 可选 | 5 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | Output duration in seconds. Defaults to `5`; supports `2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15`.
    • resolution | string | 可选 | 1080P | 1080P | Output resolution. Defaults to `1080P`; supports `1080P`.

    常见错误

    • 400 invalid_request_error: 触发=Request payload misses required fields or has invalid field types.; 修复=Validate model, mode, and input schema before request.; 重试=Retry only after fixing payload; avoid blind retries.
    • 401 authentication_error: 触发=Missing Authorization header or invalid API key.; 修复=Verify Bearer token format and API key scope.; 重试=Retry after auth fix; rotate key if repeated failures continue.
    • 429 rate_limit_exceeded: 触发=Request rate, concurrency, or current quota hits upstream rate limiting.; 修复=Apply exponential backoff first, then review request rate, concurrency, and quota usage.; 重试=Use exponential backoff (e.g., 1s/2s/4s) with jitter; if it persists, reduce submission pressure.
    • 500 internal_error: 触发=Transient upstream error or internal processing failure.; 修复=Capture request id and trigger retry workflow.; 重试=Retry 2-3 times with short delays; escalate if persistent.

    viduq3-drama

    viduq3-drama is provided by Vidu with Video capabilities. Current pricing reference: 17.5 積分 /second. This page helps you understand positioning, parameters, and production-ready use cases before integration.

    模型類型：
    價格： 17.5 積分 /second
    體驗區相關能力READMEAPI

    輸入

    表單JSON

    參考圖

    描述主體、鏡頭、場景和風格。57 / 1200

    進階選項

    範例參數

    輸出

    預覽JSON

    影片結果會顯示在這裡

    影片生成通常需要更久，提交後請等待任務輪詢完成。

    查看 API 文件取得 API Key

    生成需要一些時間，請稍等您可以離開此頁面，[ 任務日誌 ] 可直接檢查生成的內容

    請求預覽

    {
  "model": "viduq3-drama",
  "prompt": "一支 6 秒产品概念短片，展示 viduq3-drama 生成的未来感城市街景，镜头缓慢推进，光线自然，画面稳定。",
  "duration": 5,
  "size": "16:9",
  "aspect_ratio": "16:9",
  "resolution": "1080P"
}

    透明計價

    viduq3-drama pricing

    Video usage is billed according to the current duration and resolution rules. Final billing follows the current account quote.

    儲值積分
    17.5 積分 /second

    為什麼選擇 ToAPIs

    Why call viduq3-drama through ToAPIs?

    Keep video generation, API keys, billing, and task tracking in one workflow.

    Unified multi-mode testing

    Switch across Text-to-Video, Image-to-Video, R2V, and Video Edit in one place.

    Parameter-first validation

    Iterate quickly on prompts, durations, and references before production rollout.

    Production-ready handoff

    Minimal request/response structure helps you move stable configs into API workflows.

    Connect in three steps

    Create a key, submit a video task, and poll the result.

    1. 1

      Step 1

      Fill prompt and key parameters.

    2. 2

      Step 2

      Run, inspect output structure, then iterate.

    3. 3

      Step 3

      Move stable settings into production API.

    When to use viduq3-drama

    Use case 1

    When you need fast iteration across multiple generation modes.

    Use case 2

    When you need to validate parameters and error handling before integration.

    常見問題

    viduq3-drama FAQ

    When should I use viduq3-drama?

    Use it to validate video concepts quickly, compare mode behavior, and converge prompts before API rollout.

    How do I choose Text-to-Video vs Image-to-Video?

    Use Text-to-Video when you only have instructions; use Image-to-Video when you already have key frames or composition.

    What is the difference between R2V and Video Edit?

    R2V focuses on reference-guided generation, while Video Edit focuses on modifying existing video assets.

    图像视频模型报错：invalid apitype: -1

    这类错误通常说明接口走错了。图像和视频模型一般不走 chat 接口，而是按对应文档发起 HTTP 任务请求，并通过任务状态接口轮询结果。排查时建议先看用户的实际请求代码、请求地址和请求体。

    用户进行生成图片/视频的任务时出现任务失败，但是扣款

    先让用户提供任务日志或截图，重点看是否出现了输入或输出 token 统计。如果有这类 token 记录，大概率是用户把图片/视频模型走成了 chat 接口；这不是正确用法。图片和视频模型通常是异步任务接口，需要通过 HTTP 请求先提交任务，再拿到任务 ID 轮询状态，详细以对应文档为准。

    viduq3-drama API

    Start building with viduq3-drama

    Test a video request here, then continue in the dashboard or API documentation.

    Start for freeView API Docs

    Try viduq3-drama with one ToAPIs key.

    Use one account and API surface for video generation workflows.

    Sign up to get free credits
    ToAPIs
    homeToAPIs

    企業級 AI API 閘道，透過一套介面接入文字、圖片、影片與音訊模型。

    运营主体：
    鯨樞智能科技有限公司
    JINGSHU INTELLIGENT LIMITED
    注册地址：
    ROOM 5042, 5/F, YAU LEE CENTRE, NO.45, HOI YUEN ROAD, KWUN TONG, KOWLOON, HONG KONG
    联系方式：
    support@toapis.com

    模型

    • Sora 2 API
    • Veo 3.1 API
    • GPT Image 2 API
    • 所有模型

    替代方案

    • Fal.ai 替代方案
    • Wavespeed AI 替代方案
    • PiAPI 替代方案
    • CometAPI 替代方案
    • Replicate 替代方案
    • AIMLAPI 替代方案

    資源

    • 文檔
    • 服務狀態
    • 定價
    • 隱私政策
    • 服務條款
    • 使用政策
    • 資料刪除政策
    • 資料保留政策
    • 次處理者與資料區域
    • 計費與退款說明
    • Cookie 政策
    • 網站地圖
    • 關於我們

    © 2026 ToAPIs. 版權所有。