Version=2024-01-01、content[]、素材の PascalCase JSON、Volcengine レスポンスエンベロープを維持できます。変更が必要なのはエンドポイントと認証方式です。
変更点
AK/SK 署名だけのリクエストは
401 AuthenticationError を返します。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 を受け付けます。callback_url には公開 HTTP(S) アドレスを指定でき、queued、running、succeeded、failed、expired への各変更時に照会オブジェクトと同じ内容を送ります。succeeded と failed は 5 秒後に最大 3 回再試行します。復旧用のポーリングも維持してください。
リファレンス
v3 に/v1/tasks/{id} のレスポンス struct を流用しないでください。v1 は pending、processing、completed、failed、v3 は queued、running、succeeded、failed、cancelled、expired を使います。v3 の duration は文字列で、error は失敗時だけ現れます。
切断後の復旧には、REST 作成に一意の Idempotency-Key を付けてください。同じ body と key は同じ cgt-... ID を返し、同じ key を別の body に使うと 409 になります。
タスク Action
最小 REST 例
素材と実在人物の認証
同じ Action エンドポイントは 10 個の素材・素材グループ操作にも対応します。PascalCase 本文、フィルター、ページング、レスポンス形式、12 時間有効な素材 URL はVolcengine 互換素材 Actionを参照してください。実在人物の素材では、アップロード前に視覚認証セッションを作成と視覚認証結果を取得も呼び出します。移行チェックリスト
- API ホストを
https://api.tokenlab.shに変更します。 - AK/SK 署名を TokenLab Bearer API Key に変更します。
- 既存の Action、バージョン、本文の大文字・小文字を維持します。
- 関連する素材と人物認証リクエストで同じ
ProjectNameを使います。 - TokenLab が返すタスク、グループ、素材 ID を保存します。
- 本番トラフィックを移す前に、作成、ポーリング、一覧、エラー応答を確認します。