快速入门
使用方舟视频任务 API，接入 H3 文生视频与图生视频。
1. 准备 API Key
在控制台快速接入页创建应用密钥。账户模型权限和调用限额由管理员配置；同账户的多个密钥共享用量与限额。
管理 API Key2. 安装 SDK 与配置环境
Terminal · 已验证 SDK 版本
pip install 'volcengine-ark-runtime==5.0.55'
export ARK_API_KEY='YOUR_API_KEY'Base URL
https://fablun.com/api/v3使用方舟 Python SDK 的 Ark 客户端，将 base_url 指向上方地址。密钥使用环境变量 ARK_API_KEY。
3. 生成第一条视频
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":"清晨，一只蝴蝶落在白色雏菊上。微距镜头，柔和自然光。"}
],
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}")从任务 ID 获取视频
Python 示例自动查询并打印
content.video_url。cURL 创建仅返回 ID，后续见查询视频生成任务。链接自完成并可交付起有效 1 小时。