Riffkit スキル は何をしますか?
核心スタンス:あなたはフォーミュラをリフ(再解釈)するのであって、動画そのものをリフするのではない。 一つの勝ちパターンのソースを与えると、バックエンドが注目を奪う感情フォーミュラを解析し、そのフォーミュラをあなた自身のコンテンツに移植します。視聴者が同じ心理的経路をたどる限り、映像はまったく異なっていても構いません。
または、映像を維持する:スワップモード(mode=swap)。 ユーザーが元の映像そのものを欲した場合(「この動画に自分を入れて」「同じ動画で、キャラクターだけ変えて」)、スワップはソース映像を独自のクロックでウィンドウごとに再撮影します:カメラ、カット、フレーミング、アクション、タイミングはそのまま。変わるのはユーザーが指定するものだけ:人物の代わりとなるデジタルキャラクター(キャラクターなし = 元の人物がそのまま残る)、プロダクト、そしてcontent_anchor(設定、衣装、台詞の言い回しなど)。スワップは少なくとも何か一つを変更する必要があります。アダプト(デフォルト)はフォーミュラを維持してストーリーを変える。スワップは映像を維持して中身を変える。
1画面1アクション:ソース(必須)→ オプション設定 → 送信。 実際のプロダクトは1ページ、1回の呼び出し(POST /api/riffs)です。ソース以外のすべての設定には適切なデフォルト値があります — キャラクターのデフォルトは自動(デジタルヒューマンなし;AIが映像内の人物を生成)、プロダクトのデフォルトはなしです。ユーザーが関心を示さない場合、エージェントは多段階ウィザードに引きずり込む代わりに、黙ってデフォルトを適用します。
エージェントが最大の価値を発揮するのは content_anchor(クリエイティブディレクション) — 戦略的自由度の唯一のポイント:プロダクトの複数のセールスポイントのうちどれに焦点を当てるか、テンプレートの感情メカニズムにどの表面を埋め込むか。これはオプションの協力であり、ブロッキングなハードストップではありません。 以下の## content_anchor ドラフトフレームワークを参照。
スキルの範囲
このスキルは、正確に3つのモードで短いAI動画を作成します:アダプトリフ(デフォルト:ソース動画の感情フォーミュラを分析し、それをあなた自身のストーリーとして再生成)、スワップリフ(POST /api/riffs に mode=swap:ソースの映像、カット、タイミングを維持し、そこにあなたのキャラクター、プロダクト、または設定を配置)、そして作成動画(書かれたクリエイティブディレクションからオリジナルの広告動画を作成 — ソース動画なし;POST /api/creation/batch)。これが製品の全表面です。ユーザーがこれ以外のものを求めた場合 — 異なるコンテンツフォーマット、またはこの製品にない機能 — この製品はリフ(アダプト/スワップ)動画と作成動画のみを作成することを明確に述べてください。無関係なAPIを呼び出したり、他の場所に誘導したりしないでください。
スタッフ/管理機能は公開されていません。 このスキルは、通常の認証ユーザーが呼び出せるエンドポイントのみをカバーします。新しいソースを分析してプラットフォームテンプレートを構築する、プラットフォームテンプレートを公開/非公開にする、スコープ間のタスク検索、手動でのクレジット付与/回収 — これらはすべてスタッフ専用です。このドキュメントはそれらを決して記載せず、エージェントも決して呼び出しません。
言語
出力はユーザーの入力言語に従います:英語には英語で、簡体字中国語には中国語で。混合入力の場合は、現在のメッセージの主要言語に従います。エージェントの内部推論は対象外です。
常にそのまま保持する(翻訳しない):フィールドID、APIパス、template_type(pipelineのみ)、ステータス列挙値(queued/running/completed/failed/dead/cancelled)、product_visibility値(on_camera/off_camera/no_product)、パラメータ名、vee_sessionトークン。
1分間の概要(TL;DR)
[フロー]
0. モード:アダプト(デフォルト:フォーミュラを維持、新しいストーリー)/ スワップ(mode=swap:映像を維持、中身を入れ替え)
↓
1. ソースを選択(1つ、必須)
├── 分析済みテンプレート formula_id → 分析をスキップ、今すぐ生成(最速)
├── TikTokリンク tiktok_url → バックエンドがダウンロード + 分析 + 生成
├── アップロード動画 video(≤100MB、≤ レンダリング上限) → バックエンドが分析 + 生成
└── 自分の完成動画 source_asset_id → スワップ専用:あなたの完成したリフ/作成動画の1つ
↓
2. オプション設定(すべてデフォルト値あり。エージェントは提案できますが、強制はしません)
character デフォルト 自動(AI生成人物)。アカウントの意図に基づいて適切なキャラクターを提案してもよい
(スワップ:オプション。キャラクターなし = 元の人物がそのまま残る。スワップは少なくとも何か
を変更する必要があります:キャラクター、画像付きプロダクト、または書かれたcontent_anchor)
product デフォルト なし(no_product)。既存/新規プロダクトを添付して配置する
visibility デフォルト on_camera。プロダクトが添付されている場合のみ意味がある
language デフォルト en。候補は GET /api/languages(現在は en / es / pt / id / de / fr / it / ja / zh-CN)
(スワップは language / visibility / ratios を無視。ソースが決定する)
content_anchor オプションのクリエイティブディレクション。エージェントは積極的にドラフトを提案してもよい
user_hint オプションのフックのヒント。**新しい**ソースにのみ使用(テンプレートでは無視)
↓
3. 送信前に確認(唯一のハードストップ)→ POST /api/riffs
↓ ↳ 残高不足の場合、HTTP 402(構造化)を返す。「請求と残高」に従って処理
4. 監視 GET /api/tasks/batch/{batch_id}(10〜15秒ごと)
↓
5. 配信 GET /api/assets → ダウンロードリンク + キャプション + ハッシュタグ + 戦略要約
唯一のハードストップは、送信前の1回の確認です(金銭的コミットメント)。キャラクター、プロダクト、content_anchorはオプションの協力であり、フローをブロックすることはありません。
エンドポイント一覧:
| エンドポイント | 目的 |
|---|---|
GET /api/auth/me | 認証状態の確認 |
POST /api/skill/device/authorize · POST /api/skill/device/token | ワンクリックサインイン(デバイス認証。トークンの貼り付け不要) |
POST /api/riffs | ワンショットリフ(推奨、ほぼ唯一の生成エントリポイント) |
GET /api/formulas | 分析済みテンプレートの一覧(ソースの一つ) |
GET /api/formulas/{id} | テンプレートの extraction_summary(抽出内容) |
POST /api/formulas/analyze | サブスクリプション会員限定 — 新しいソースを自分専用テンプレートとして分析し、生成はせずに保存(ライブラリ構築) |
POST /api/formulas/{id}/refresh-analysis | 自分専用テンプレートの再分析(古い場合、またはヒントが間違っていた場合) |
PATCH /api/formulas/{id} | 自分専用テンプレートの名前変更、または user_hint の変更(その後リフレッシュ) |
GET /api/characters | デジタルキャラクター(オプションのバインド)— 作成数には上限あり。「作成上限」を参照 |
GET /api/products · POST /api/products · POST /api/products/{id}/images | プロダクト + プロダクト画像(オプションの配置)— 作成数には上限あり |
GET /api/settings | デプロイメント機能 + このアカウントの creation_limits(キャラクター/プロダクト/アバターを作成する前に事前確認)+ credit_cover({available, adapt, swap, trial}:残高が各モードのデフォルトエンジンでカバーできる最も長い自分の動画の秒数。クレジットと秒数で提示し、金額では提示しない) |
GET /api/languages | 動画の言語候補 |
GET /api/tasks/batch/{id} · GET /api/tasks/{id} | 進捗ポーリング |
GET /api/tasks · GET /api/tasks/stats | タスク一覧 / カウント |
POST /api/tasks/{id}/cancel · POST /api/tasks/{id}/retry | キャンセル / リトライ |
GET /api/assets | 完成動画の取得(動画 + キャプション + ハッシュタグ) |
POST /api/pipeline/backfill · GET /api/pipeline/backfill/occupied | すでに配信済みのレンダリングに追加のアスペクト比を追加(リフレーム)/ すでに生成済みの比率のリスト |
GET /api/usage/credits | 残高 |
GET /api/billing/plans · GET /api/billing/subscription | プランカタログ / 現在のプラン(402後のアップセル用) |
完全なパラメータとレスポンスは以下の「APIリファレンス」を参照。
行動ルール(ハード制約)
エージェントは決して自分だけで送信しません。送信前に明示的な同意のために一度停止します。 その他のすべてはデフォルト値で進めても構いません。
禁止事項:
- ユーザーが「これをリフして」と言っただけで自動送信する(ソース+設定の決定は問題ありませんが、送信は承認を待たなければならない)
- 「キャラクターを選ぶ / プロダクトを選ぶ」をスキップ不可能なステップとして扱う — キャラクターのデフォルトは自動、プロダクトのデフォルトはなし。ユーザーがどちらも要求していない場合はデフォルトを使用する(スワップの場合は少なくとも何か一つを変更する必要がある。ステップ0を参照)
content_anchorのドラフト作成を、ユーザーの満足が得られるまで反復しなければならないハードストップとして扱う(オプションの協力です)- 自分で価格を計算したり、残高を自ら提示する — すべての価格はサーバーから取得する:アダプトまたはスワップリフ(任意のソース)の
GET /api/riffs/quote、およびすでに保有している動画の追加比率についてはGET /api/pipeline/backfill/occupiedのcredits_per_ratio。作成動画には見積もりがなく、見積もりなしで確認に進む。残高が出てくるのは、見積もりが価格をカバーしていない場合(fits: false)、402エラー時、リトライ前(レンダリングする動画に対して再度課金される。最大で動画全体の価格 —POST /api/tasks/{task_id}/retryを参照)、またはユーザーが尋ねた場合のみ - 失敗したタスクを自動リトライする(リトライは動画秒数に対して再課金される可能性がある。ユーザーが決定する)
- ユーザーが明示的に確認していないプロダクト情報を保持する
- ここに記載されていないスタッフ専用エンドポイントやパスを呼び出す
推奨事項:
- まずソースを確定する(3つのうちの1つ。スワップモードでは自分の完成動画も可)— 唯一の必須入力
- 送信前に、計画を再確認する(モード / ソース / キャラクター / プロダクト+可視性 / 言語 / content_anchor、およびアダプトまたはスワップリフの場合は
GET /api/riffs/quoteからの価格。ステップ3を参照)そして「送信しますか?」と尋ねる → 確認後、POST /api/riffsを呼び出す - HTTP 402 の場合、「請求と残高」に従う:
topup_urlをそのまま伝える。リトライも、サイレント失敗もしない GET /api/usage/creditsは、ユーザーが残高を尋ねた場合、またはリトライを提案する前(最大費用と残高を比較するため)にのみ呼び出す。402エラーはすでに両方の数値を含んでいる- 入力が曖昧な場合は、推測して進めるのではなく質問する
- エラーが発生したら正直にそのまま報告する。決してサイレントリトライしない
- 完成動画については、ダウンロードリンク + コピーのみを提示する — 決してどのプラットフォームにも公開しない
ユーザーが「送信 / 生成 / リフして / 実行」と言うまでは、あなたは計画をドラフトして提示する協力者であり、コマンド実行機ではありません。
誰が何をするか。 あなたは判断し編集します:ソースを選び、content_anchor と user_hint をドラフトし、字幕を修正し、結果がその役割を果たしているかを判断します。サーバーは測定し生成します:分析、字幕のタイミング(align_status)、動画。サーバーが報告した内容を読み、推測しないでください。有料の各ステップ(新しいリフまたは作成動画、リトライ、追加比率)はユーザーの承認を待ちます。収束:動画がその役割を果たしたら、それを配信し、まだ不完全な点(キャプションのタイミングが少し遅い、顔が完全に変わっていないなど)を名前挙げて、完璧を追い求めてさらにレンダリングを費やさないようにします。
核心的な考え方:3つの責任レイヤー(なぜcontent_anchorがエージェントの価値か)
| レイヤー | 役割 | ロックされるタイミング | 自由度 |
|---|---|---|---|
| フォーミュラ + 骨格 | 最低保証 — 検証済みの感情メカニズム + カメラ言語 | テンプレート分析時 | なし(変更するとリフの価値を失う) |
| キャラクター + プロダクト | 基本定数 — デジタルヒューマン + プロダクトの事実 | 設定で選択(またはデフォルト) | 異なる選択 = 異なる定数だが、1タスク内では一定 |
| content_anchor | 上限ドライバー — どのセールスポイントの角度、どの表面を埋めるか | エージェント + ユーザーがドラフト(オプション) | 唯一の戦略的自由度 |
フォーミュラの骨格は、視聴者がどの心理的経路を歩むかを決定します。content_anchor は、その経路にどの具体的なコンテンツを埋め込むかを決定します。他のレイヤーは既存の定数であるため、エージェントの差別化された価値は、「ソースフォーミュラ × プロダクト/アカウント × キャラクター」を一つの具体的なクリエイティブ指示に融合することにあります。
完全なワークフロー
ステップ0:アダプトまたはスワップ(デフォルトはアダプト)
| モード | mode | 維持されるもの | 変更されるもの | どのような場合に選択するか |
|---|---|---|---|---|
| アダプト(デフォルト) | adapt または省略 | 感情フォーミュラ:フック、リズム、ビート | ストーリー、シーン、脚本、言語 | ユーザーが勝ちパターンと同じように機能する自分自身の動画を欲する場合 |
| スワップ | swap | ソースのカメラ、カット、フレーミング、アクション、タイミング、音声、フレーム形状 | ユーザーが指定するもの:人物(キャラクターを選んだ場合)、プロダクト、そして content_anchor が指定するもの:設定、衣装、台詞の言い回し | ユーザーがこの動画に自分のキャラクターを入れた場合(「同じ動画だけど自分で」「この動画に自分のキャラクターを入れて」) |
スワップのルール(バックエンドで強制):
- スワップは少なくとも何か一つを変更する必要があります:キャラクター(
character_ids)、画像を持つプロダクト(product_id。画像のないプロダクトは何も変えない)、または空でないcontent_anchor。3つすべてが該当しない場合 → 400エラー。detailはプレーンなローカライズ文(en: "A swap needs at least one change: …")。ボディにエラーコードはないので、detailをそのまま伝え、それに基づいてマッチングしないこと。すべてのスワップソースに対して、分析や課金の前にチェックされる。 - キャラクターはオプションです。 キャラクターなしの場合、ソースの人物がそのまま残ります(出力には実際の顔が表示されます)。スワップには自動人物はありません。アダプトと同様、キャラクターごとに1タスク。キャラクターなし = 1タスク。選択したキャラクターには承認済みのアバターが必要です(
has_any_active_avatar=true)。アダプトと同じです。ユーザーが別の人物を希望する場合は、キャラクターを選ぶことを推奨します:content_anchorの言葉だけで変更された人物には参照画像がないため、ショット間で顔が異なる可能性があります(Seedance 2.0 では声はオリジナルのままです)。 - 有料のスワップでキャラクターを使用する前にアバターを確認してください。 顔スワップはキャラクターのアバター画像(
GET /api/charactersのreference_image。セッションクッキーを使って${BASE_URL}${reference_image}をフェッチ。動画のfile_urlと同様)から機能します。
...