图片输入

H3 视频任务 API · /api/v3

一次请求传入图片

主接口使用 content[].image_url.url：支持公网图片 URL 或完整 Base64 data URL。本地文件由 SDK 读取并编码后随提示词一次提交。

输入	填写方式
图片 URL	`https://YOUR_IMAGE_HOST/first-frame.jpg`
Base64	`data:image/jpeg;base64,BASE64_DATA`
本地图片	切换本地文件示例，Python 自动读取 first-frame.jpg。

图生视频示例

模型模式分辨率时长画幅Seed

图片输入

Python · 创建并自动查询

import os, time, uuid
from volcenginesdkarkruntime import Ark

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

request_key = str(uuid.uuid4())  # 仅新任务生成；网络重试改用已保存的原值。
print("Idempotency-Key:", request_key)
task = client.content_generation.tasks.create(
    model="h3-pro",
    content=[
        {"type":"text","text":"人物自然地转头看向镜头，微风吹动头发，镜头缓慢推进。"},
        {"type":"image_url","image_url":{"url":"https://YOUR_IMAGE_HOST/first-frame.jpg"},"role":"first_frame"}
    ],
    resolution="480p", duration=5, ratio="16:9",
    
    extra_headers={"Idempotency-Key": request_key},
)
print("task_id:", task.id)  # 保存 ID，网络中断后继续查询原任务。

deadline = time.monotonic() + 1800
while time.monotonic() < deadline:
    result = client.content_generation.tasks.get(task_id=task.id)
    if result.status == "succeeded":
        print(result.content.video_url)
        break
    if result.status in ("failed", "expired", "cancelled"):
        raise RuntimeError(result.error or result.status)
    time.sleep(2)
else:
    raise TimeoutError(f"等待结束，请继续查询原任务：{task.id}")

切换到“图生视频”，可选择 URL、Base64 或本地文件。

图片要求

单帧 PNG、JPEG、WebP，原始文件最大 8 MiB；单边 32～8192 像素，总像素不超过 16 × 1024²。URL 使用公网 HTTP(S) 的 80 / 443 端口；H3 Pro · 5 秒支持首帧与尾帧。

首尾帧视频

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
}

可选视频压缩

compress：boolean，默认 false。传 true 后在北京 CPU 交付阶段压缩，保留尺寸、帧率和音轨；不另收生成费用。未节省至少 5% 或编码失败时返回原片，并通过 compression.applied / reason 说明。结果完成后沿用普通审核、下载有效期和签名回调。

{
  "model": "h3-pro",
  "content": [
    {
      "type": "text",
      "text": "A cat walks through a garden."
    }
  ],
  "resolution": "720p",
  "compress": true
}