从 Seedance 迁移

H3 视频任务 API · /api/v3

保留方舟调用方式

H3 支持方舟视频任务协议的文生视频与单首帧图生视频子集。已有代码可保留路径、鉴权、content 结构与查询流程，调整服务地址、模型 ID 和已支持的规格。

接入项	迁移方式
Base URL	`https://fablun.com/api/v3`
API Key	替换为 Fablun 客户 Key。
model	使用 h3-pro 或 h3-standard，不接受 Seedance 模型 ID。
SDK 方法	保留 Ark.content_generation.tasks 的 create / get / list / delete。
结果取值	创建读取 id；查询读取 status 和 content.video_url。
输入参数	text / 单张 first_frame；显式指定已开放的 resolution、duration。

SDK 客户端

Python · 已验证 SDK 5.0.55

from volcenginesdkarkruntime import Ark
import os

client = Ark(
    base_url="https://fablun.com/api/v3",
    api_key=os.environ["ARK_API_KEY"],
)

兼容范围

项目	H3 当前范围
模型与输入	两种 H3、文本、单首帧 URL / data URL。
规格	480p / 720p，支持 1:1、3:4、4:3、16:9、9:16；音频可选，时长以模型表为准。
任务与重试	四种任务操作、六种状态、幂等重试。队列上限和公平调度以本平台为准。
链接有效期	完成后 1 小时，与火山保留策略不同。
SDK	已验证 volcengine-ark-runtime 5.0.55；新版 arkruntime 与 Seedance 新能力不在本轮验证范围。
暂不支持	1080p、自定义画幅、多模态参考、草稿、flex等。

协议结构对齐不代表模型能力、限额、计费、保留时间和调度实现与 Seedance 完全相同。超出支持范围的参数会返回错误。

官方协议参考火山方舟 · 创建视频生成任务火山方舟 · 视频生成教程

首尾帧视频

H3 Pro · 5 秒支持首尾帧；480p / 720p 均支持 1:1、3:4、4:3、16:9、9:16。每种 role 仅一张，last_frame 必须与 first_frame 配对。按一条视频计费，取消、审核和完成回调沿用普通任务流程。return_last_frame 是输出末帧选项，尚未开放。

{
  "model": "h3-pro",
  "content": [
    {
      "type": "text",
      "text": "A red ball rolls from left to right."
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://YOUR_IMAGE_HOST/first-frame.jpg"
      },
      "role": "first_frame"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://YOUR_IMAGE_HOST/last-frame.jpg"
      },
      "role": "last_frame"
    }
  ],
  "resolution": "720p",
  "duration": 5,
  "ratio": "16:9",
  "generate_audio": true
}