DreaminaをほかのAIやアプリとつなぐ（その2）：Volcengine／BytePlusのAPIと、AIどうしを組み合わせる案を、公式の資料の範囲で並べる

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。運営者はDreaminaを入れていますが、使い心地はこの記事には書いていません。コマンドと設定の例は、「公式の例の写し」か、「公式の記載に合わせて、この記事で組んだ例（動作は確かめていません）」のどちらかを、そのつど書きます。Volcengineの文書は中国語のページを、要約の形で取得しました。コマンドや設定は、原文を見て写してください。

先に結論

• APIは、Dreaminaのアカウントとは別のサービスです。 鍵も料金も、別と読めます（03参照）。
• 動画の生成は「作成して、あとで結果を取る」の2段階です。 作成のPOSTでタスクのIDが返り、IDで問い合わせて、succeeded になったら動画のURLを取ります。
• 結果のURLは24時間で切れる。 早めに自分の場所へ保存する必要があります。
• BytePlusは本文が読めなかった。 書けるのは、ページの見出しだけです。

前提：用語をそろえる

• API：他のプログラムが、サービスの機能を呼ぶ入口です。
• APIキー：APIを呼ぶときの通行証にあたる長い文字列です。
• ベースURL：APIの入口になるアドレスです。地域や会社で違います。
• 非同期：「頼んで、あとで結果を取りにいく」方式です。
• コールバック：生成が終わったときに、サービスから指定のアドレスへ知らせてくる仕組みです。
• SDK：APIを使いやすくする、プログラム用の部品です。
• 環境変数：パソコンに名前つきで覚えさせておく値です。APIキーの置き場所として、公式の例が使っています。
• スキルファイル、CLI、MCP：07の前提を参照してください。

連携の一覧（その2）

Dreamina自身の連携（CLI、スキルファイル、Octo、Canvas）は、07の一覧にあります。

連携6：Volcengine 火山方舟（Ark）のAPI

ここからは、Dreaminaではなく、Volcengine（火山引擎）の文書です。ページは中国語で、要約の形で取得しています。コマンドや設定は、原文を見て写してください。 Seedanceのモデル名は、Dreaminaの名前と違います（Volcengineの例は doubao-seedance-2-5-260628、03で扱ったBytePlusの料金文書は dreamina-seedance-2-5-260628）。同じモデルかどうかは、公式の資料では確認できていません。

設定する画面と手順

05の手順Eの準備（APIキー、モデルサービスの有効化、環境変数、ベースURL）が前提です。要点だけ再掲します。

1. コンソールで、対象プロジェクトに切り替え、左のナビゲーションの「API Key 管理」で、方舟のAPIキーを作る。
2. 「開通管理」で、モデルサービスを有効にする。
3. 鍵を環境変数 ARK_API_KEY に置く。
4. ベースURLは https://ark.cn-beijing.volces.com/api/v3。

動画を作る：タスクの作成

ページが書いているのは、次の流れです。

• 作成： POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks
• 認証： APIキーによる認証。鍵は「API Key 管理」のページで取得する長期のキーと書かれています。問い合わせ（GET）のページは、長期のAPIキーを Authorization ヘッダーにBearerトークンとして送る、と書いています（LASの例も Authorization: Bearer $LAS_API_KEY）。作成のページで同じ書き方かは、取得した要約には出ていませんでした。SDKの例は、環境変数 ARK_API_KEY から鍵を読んでいます。
• 作成の応答： タスクのID（例：cgt-20260414114820-***** の形）が返る。

主な項目（ページの表より）です。

素材の指定は url の項目です。ローカルのファイルをどう渡すか（アップロード、Base64など）は、読んだ範囲では書かれていませんでした。

タスクの状態を問い合わせる

• 問い合わせ： GET https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/{id}
• 結果： content.video_url（動画のURL）、content.last_frame_url（最後のフレームの画像URL）、usage（使ったトークン）。
• 状態： 例の応答は succeeded。ほかの値の全部は、ページに書かれていません（コールバックの説明には、queued、running、succeeded、failed、expiredが出てきます）。

データの扱いに関する記載（ページの文言）：

公式の例の写し（SDK）

ページのSDKの例のうち、読める形で取得できた部分です。

client = Ark(
    base_url='https://ark.cn-beijing.volces.com/api/v3',
    api_key=os.environ.get("ARK_API_KEY"),
)

ページの例は、続けて client.content_generation.tasks.create(...) でタスクを作り、client.content_generation.tasks.get(task_id=task_id) を10秒おきに呼んで、状態が succeeded か failed になるまで待つ（タイムアウトは30分）、という流れです。作成の呼び出しの引数は、取得した要約では途中が省略されていたので、写していません。

この記事で組んだ例（動作は確かめていません）

上の項目表とSDKの例に合わせて、この記事で組んだものです。インポートの行 from arkruntime import Ark と、tasks.create、tasks.get の呼び方は、作成のページのSDKの例に出ています。作成の戻り値からIDを取り出す書き方（created.id）と、結果の取り出し方（task.content.video_url）は、この記事の推測です。原文のSDKの例で確かめてください。

import os
import time
from arkruntime import Ark  # 作成のページのSDKの例に同じ行がある

client = Ark(
    base_url='https://ark.cn-beijing.volces.com/api/v3',
    api_key=os.environ.get("ARK_API_KEY"),
)

created = client.content_generation.tasks.create(
    model="doubao-seedance-2-5-260628",  # 公式の例のID。自分のアカウントで有効なIDに置き換える
    content=[{"type": "text", "text": "A fox walks through a snowy forest at dawn, slow tracking shot"}],
    ratio="16:9",
    duration=5,
    generate_audio=True,
    watermark=True,
)

while True:
    task = client.content_generation.tasks.get(task_id=created.id)
    if task.status in ("succeeded", "failed"):
        break
    time.sleep(10)

if task.status == "succeeded":
    print(task.content.video_url)  # 有効期限は24時間。早めに保存する

渡るデータ・権限・外し方

• 渡るデータ： content に入れたプロンプト、画像、動画、音声のURL。結果は動画のURLで返り、24時間で切れます。
• 権限： 鍵を持つ人が、そのプロジェクトのモデルサービスを使えます（見立て）。鍵の権限の範囲を絞る設定は、読んだ範囲では見つかりませんでした。
• 外し方： 鍵の削除や無効化の手順は、取得した文書に記載が見つかりませんでした。コンソールの「API Key 管理」の画面で確かめてください。タスクの取り消しや削除のAPIは、BytePlusの文書の見出しに「Cancel or delete a video generation task」とありますが、本文が読めていません（連携8）。

確認点

連携7：Volcengine LASのSeedance演算子

VolcengineのLake AI Service（LAS）の文書に、Seedance（Doubaoシリーズ）の動画生成の演算子があります。読めた範囲は、次のとおりです。

• できること： テキストから動画、画像から動画。フレーム数の調整は不可（ただし同じページの項目表には frames があり、ページの中で食い違っています。モデルによる可能性があり、原文で確認してください）。非同期で、タスクを作り、IDで問い合わせる。
• 手順： APIキーを作り、環境変数に置く（例は LAS_API_KEY）。地域のベースURLを選ぶ。作成のPOSTでIDを得る。IDでGETして、succeeded になるまで確かめる。
• エンドポイント（ページの記載）： 作成は POST https://operator.las.ap-southeast-1.volces.com/api/v1/contents/generations/tasks、問い合わせは同じパスの末尾に /{id}。ページの本文のcurlの例には、cn-beijing のアドレスも出てきます。地域の違いについては、ページの中で揃っていないように読めます。

公式の例の写し（作成のcurl）

curl --location "https://operator.las.cn-beijing.volces.com/api/v1/contents/generations/tasks" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer $LAS_API_KEY" \
--data '{
    "model": "doubao-seedance-1-0-pro-250528",
    "content": [
        {
            "type": "text",
            "text": ""
        }
    ],
    "ratio": "16:9",
    "duration": 5,
    "watermark": false
}'

text は、ページの例では空です。自分のプロンプトを入れます。作成の応答は、{"id": "cgt-..."} の形です。

• ほかの項目： callback_url、return_last_frame、execution_expires_after、generate_audio（ページはSeedance 1.5 Proのみと書く）、resolution、ratio、duration（2〜12秒）、frames、seed、camera_fixed、watermark。モデルの例は doubao-seedance-1-5-pro-251215 と doubao-seedance-1-0-pro-250528。
• エラー： HTTP 401、ApiKey.Invalid は「鍵が無効」。
• 渡るデータ・外し方： 連携6と同じ考え方です。LAS側の保持期間や削除の記載は、読んだ範囲では見つかりませんでした。

連携8：BytePlusと、読めなかったページ

BytePlusの製品ページ（www.byteplus.com）は、Seedance 2.5のAPIが「fully available」と書き、Light、Production、Premiumの3つのプランを案内しています（03参照）。このページ自体には、BytePlusとVolcengineやDreaminaとの関係、モデルIDの記載はありませんでした。文書のサイトでは、次のページの題名とメニューが読めました。

• 「Create a video generation task」
• 「Retrieve a video generation task」
• 「List video generation tasks」
• 「Cancel or delete a video generation task」
• 前提として「Obtain and configure an API key」「Base URL and authentication」

これらのページの本文は、取得できませんでした。 エンドポイント、認証、鍵の作り方、リクエストの項目は、この記事に書けません。原文で確認してください。BytePlusのAPIがDreaminaのアカウントや料金とつながっているかは、読んだ範囲では書かれていません。

連携9：VolcengineのAgentKitのサンプル

Volcengineの公式GitHub（bytedance/agentkit-samples）は、「Volcengine AgentKit Platform向けのサンプル」と説明されています。読めた範囲では、前提として、Python 3.10以上、veadk-python、agentkit-sdk-python、必要ならDockerが挙がっていました。フォルダの例として、python/02-use-cases/video_gen（動画生成のエージェント）と、スキルを動かすエージェントのサンプルがあります。

このサンプルが、Seedanceを呼ぶのか、Dreaminaとどう関係するのかは、読んだ範囲では確認できていません。Dreaminaの連携としては扱えません。参考として書きました。

この記事の案：AIどうしを組み合わせる

ここから先は、公式の記載を組み合わせた、この記事の案です。公式の手順ではなく、動作も確かめていません。

案：AIアシスタント×CLIで、確認を挟む使い方

1. CLIとアカウントの用意は、人が行う（05の手順D）。
2. アシスタントに渡す前に、SKILL.md の中身を人が読む。コマンドの範囲が分かります。
3. 最初は画像の --poll つきの1枚から始める。結果と、クレジットの減りを人が確かめる。
4. アシスタントが連続して生成する設定にするときは、回数の上限を人が決めておく。クレジットは、タスクごとに消費量が違う、と公式が書いています。

案：APIで使うときの鍵と素材の扱い

1. 鍵は、環境変数に置き、チャットや記事に貼らない。公式の例も、環境変数から読んでいます。
2. 素材は、権利と許可があるものだけにする（ヘルプの記載）。顔の写った素材の扱いは、Volcengineに専用のガイドがありますが、本文が取得できず、読めていません。
3. 動画は、24時間以内に自分の場所へ保存する。

外し方のまとめ（その2）

気をつけること

• この記事は、実際に使って確かめた記録ではありません。運営者はDreaminaを入れていますが、使い心地はこの記事には書いていません。コマンドと設定は、公式の例の写しか、この記事で組んだ例で、実行していません。
• 読めなかったページ：BytePlusの文書（docs.byteplus.com の動画生成、鍵、認証のページ。見出しのみ）、Volcengineの一部（Seedance 2.0のクイックスタート、動画生成のチュートリアル、プロンプトガイド、肖像素材のガイド。本文が空）、volcengine.com/docs/82379/... はサイトの制限で取得できませんでした。これらの内容は書いていません。
• ArkとLASは、Volcengineの文書のものです。Arkの例は cn-beijing のベースURLで、中国本土向けのコンソールと読めます（見立て）。LASの文書には ap-southeast-1 と cn-beijing の両方のホストが出てきます。VolcengineとBytePlusの住み分け（運営会社、対象地域）は、読んだページには書かれていませんでした。日本から使うときに、どのサービスや地域が当てはまるかは、公式の資料では確認できていません。
• 取得した米国向けのDreaminaの利用規約は、「automated scripts or other technologies to collect information」（情報を集めるための自動化スクリプトなど）を使わないよう書いていて、CLIやAPIについては書いていません。Dreamina自身のCLIのページは、CLIをスクリプトや自動化の流れでも使える道具と紹介しています（07参照）。
• APIの鍵は、アカウントの権限を持つ値です。漏れると他人に使われ、料金が発生する可能性があります。
• 他社のモデルを使ったときに、素材がどこへ送られるかは、確認できていません（03）。
• 料金や数字は、この記事では最小限にしました。04と、公式の画面で確かめてください。この記事は法律の助言ではありません。

出典

• 创建视频生成任务（火山方舟 Ark、Volcengine、確認日 2026-10-25）
• 查询视频生成任务（火山方舟 Ark、Volcengine、確認日 2026-10-25）
• 快速入门（火山方舟 Ark、Volcengine、確認日 2026-10-25）
• Seedance video generation operator（Lake AI Service、Volcengine、確認日 2026-10-25）
• Dreamina-seedance-2.5 API（BytePlus、確認日 2026-10-25）
• Create a video generation task（BytePlus ModelArk、見出しのみ、確認日 2026-10-25）
• bytedance/agentkit-samples（GitHub、Volcengine、確認日 2026-10-25）
• Dreamina CLI（Dreamina、確認日 2026-10-25）
• Dreamina Terms of Service（Dreamina、確認日 2026-10-25）
• Dreamina Help（Dreamina、確認日 2026-10-25）