クイックスタート
方舟互換の動画タスク API で H3 のテキスト・画像から動画を生成します。
1. API キーを用意
コンソールでアプリケーションキーを作成します。モデルの利用権限とリクエスト上限は管理者が設定します。同一アカウントのキーは使用量と上限を共有します。
API キーの管理2. 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 時間有効です。