Skip to main content
アプリケーションがすでに Volcengine 形式の Seedance リクエストを送信している場合に使用してください。Action 名、Version=2024-01-01、content[]、素材の PascalCase JSON、Volcengine レスポンスエンベロープを維持できます。変更が必要なのはエンドポイントと認証方式です。

​
変更点

AK/SK 署名だけのリクエストは 401 InvalidCredential を返します。Action クライアントは POST /?Action=...&Version=2024-01-01 を使用でき、POST /api/v3?Action=...&Version=2024-01-01 も引き続き利用できます。REST タスククライアントは /api/v3/contents/generations/tasks を使用します。

​
リクエスト形式とタスクのライフサイクル

既存の連携が Volc 形式の Seedance リクエストを送っている場合、/v1/videos/generations の統一形式へ変換せずに互換エンドポイントを使えます。TokenLab API Key を Authorization: Bearer ... として送り、REST 形式の作成には POST /api/v3/contents/generations/tasks、Action 形式には /api/v3?Action=CreateContentsGenerationsTasks&Version=2024-01-01 を使います。作成応答は cgt-... タスク ID を返し、ステータスは queued、running、succeeded、failed、cancelled、expired を使います。 この互換エンドポイントは content[] の text、image_url、video_url、audio_url、draft_task を受け付けます。first_frame、last_frame、reference_image などの画像ロールは保持されます。callback_url はまだ対応していません。タスクエンドポイントをポーリングしてください。

​
リファレンス

​
タスク Action

​
最小 Action 例

​
素材と実在人物の認証

同じ Action エンドポイントは 10 個の素材・素材グループ操作にも対応します。PascalCase 本文、フィルター、ページング、レスポンス形式、12 時間有効な素材 URL はVolcengine 互換素材 Actionを参照してください。実在人物の素材では、アップロード前に視覚認証セッションを作成と視覚認証結果を取得も呼び出します。

​
移行チェックリスト

  1. API ホストを https://api.tokenlab.sh に変更します。
  2. AK/SK 署名を TokenLab Bearer API Key に変更します。
  3. 既存の Action、バージョン、本文の大文字・小文字を維持します。
  4. 関連する素材と人物認証リクエストで同じ ProjectName を使います。
  5. TokenLab が返すタスク、グループ、素材 ID を保存します。
  6. 本番トラフィックを移す前に、作成、ポーリング、一覧、エラー応答を確認します。