マーケットサポート← アプリに戻る

Volcengine

Volcengine モデルは統一された非同期ジョブ API で呼び出します。POST /api/generate でタスクを開始し、完了するまで GET /api/generate/{taskId} をポーリングします。このファミリーは 1 個のエンドポイントを提供します。

概要

すべてのエンドポイントは同じ外枠を共有し、変わるのは model と input フィールドだけです。モデルマーケットの playground から任意に実行できます。

認証

/api-keys で API キーを作成し、Bearer トークンとして送信します。ログイン中のブラウザからのリクエストはセッション cookie 経由でも動作します。

Authorization: Bearer <YOUR_API_KEY>

タスクの作成

POST
POST https://api.lithovas.com/api/generate

ボディ：{ "model": "<slug>", "input": { … } }

レスポンス：{ "taskId": "<id>", "state": "waiting" }

結果の照会

GET
GET https://api.lithovas.com/api/generate/<taskId>

レスポンス：{ "taskId", "state": "waiting" | "success" | "fail", "resultUrls": [ … ], "creditsConsumed", "failMsg", "balance" }

非同期
タスク作成の 200 は、タスクが受理されたことを意味するだけで、完了ではありません。state が success または fail になるまでこのエンドポイントをポーリングしてください。失敗したタスクは課金されません。

エンドポイント

モデルタスクmodel slug
Video To Video Lip SyncVideo to Videovolcengine/video-to-video-lip-sync

Video To Video Lip Sync · Video to Video

POSTVideo to Videovolcengine/video-to-video-lip-sync
input フィールド
modeenum<string>必須

Service mode: lite for frontal videos, basic for complex scenes

video_urlstring必須

Video URL (360p-1080p; MOV, MP4, HDR; max 500MB)

audio_urlstring必須

Target audio URL to drive lip movements; max 10MB

separate_vocalboolean任意

Enable vocal separation to suppress background noise

open_scenedetboolean任意

Enable scene segmentation and speaker ID (basic mode only)

align_audioboolean任意

Loop video when audio is longer than video (lite mode)

align_audio_reverseboolean任意

Loop video backward; requires align_audio=true (lite mode)

templ_start_secondsnumber任意

Start time of template video in seconds (lite mode)

例
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "volcengine/video-to-video-lip-sync",
  "input": {
    "mode": "lite",
    "video_url": "https://example.com/reference.mp4",
    "audio_url": "https://example.com/reference.mp3",
    "separate_vocal": false,
    "open_scenedet": false,
    "align_audio": true,
    "align_audio_reverse": false,
    "templ_start_seconds": 0
  }
}'