開発者 API

Lipsync API プラットフォーム

強力な REST API でリップシンク動画をプログラム生成

API キー

API 認証キーを管理

新しい API キーを作成

覚えやすい名前を付けましょう（任意）

ログインが必要です

API キーの作成と管理にはログインが必要です。

あなたに合った料金

柔軟で競争力のある価格で今すぐ開始

API 料金

従量課金

注意：API クレジットとユーザークレジットは独立しており、相互交換はできません。

注意：

最小課金：1 回の生成につき 5 秒

480p：1 秒あたり 2 クレジット

720p：1 秒あたり 4 クレジット

lipsync-video：動画が音声より長い場合は切り詰め、音声が動画より長い場合は自動延長。課金は切り詰め時は音声長、延長時は動画長に基づきます。

lipsync-image-multi：order が「meanwhile」の場合は音声長の最大値、それ以外は「left_audio」と「right_audio」の合計長で課金します。

例 1：

3 秒の音声を 720p = 5 秒 × 4 = 20 クレジット

（最小課金が適用）

例 2：

10 秒の音声を 480p = 10 × 2 = 20 クレジット

認証

API リクエストを保護

すべてのリクエストに Authorization ヘッダーとして API キーを含めてください：

Authorization: Bearer sk_XXXX_YYYY

利用可能なエンドポイント

RESTful API エンドポイント

POST/api/v1/lipsync-video

動画の音声を置き換え（リップシンク維持）

POST/api/v1/lipsync-image

画像 + 音声 → 単一話者のアバター動画

POST/api/v1/lipsync-image-multi

画像 + 2 音声 → 複数話者アバター（会話/対話）

GET/api/v1/jobs/{requestId}

ジョブの状態を照会し結果を取得

詳細パラメータ

完全なエンドポイント仕様

すべてのエンドポイントは共通構造（任意の webhook、モデル固有の formState）を共有します。

POST /api/v1/lipsync-video

リップシンクを維持したまま既存動画の音声を新しい音声に置換

トップレベルのパラメータ：

webhook任意

コールバック URL（HTTPS）。完了時に結果を POST します。

formState必須

生成パラメータを含むオブジェクト（以下参照）。

formState のパラメータ：

video必須

元動画の公開 URL（MP4、MOV など）

audio必須

音声の公開 URL（MP3、WAV など）

resolution任意

"480p" または "720p"（デフォルト：480p）

mask_image任意

マスク画像の公開 URL（マスク領域内にリップシンクを制限）

prompt任意

スタイル指示のテキスト

seed任意

再現性のための整数シード

Async Workflow

Choose how to receive your results

All API calls are asynchronous. You have two options to retrieve results:

Option 1: Webhook (Recommended)

Provide a webhook URL in the JSON body. We will POST the result to your endpoint when the job completes.

Benefits:

No need to poll repeatedly
Instant notification when job completes
More efficient for long-running jobs (30-120 seconds typical)

Option 2: Polling

Omit the webhook parameter and use the returned requestId to poll GET /api/v1/jobs/{requestId} every 5-10 seconds until status is "completed".

Use when:

You cannot expose a public webhook endpoint
Testing or debugging

Example with Webhook:

POST /api/v1/lipsync-image
Authorization: Bearer sk_XXXX_YYYY
Content-Type: application/json

{
  "webhook": "https://your-app.example.com/webhooks/lipsync",
  "formState": {
    "image": "https://.../face.png",
    "audio": "https://.../voice.mp3",
    "resolution": "720p",
    "seed": 42
  }
}

// Immediate Response:
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing"
}

// Later, when job completes, we POST to your webhook:
POST https://your-app.example.com/webhooks/lipsync
Content-Type: application/json

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "lipsync-image",
  "status": "completed",
  "output": "https://.../result.mp4",
  "error": "",
  "executionTime": 12345,
  "timings": null
}

Example without Webhook (Polling):

// Step 1: Submit job (no webhook parameter)
POST /api/v1/lipsync-image
Authorization: Bearer sk_XXXX_YYYY
Content-Type: application/json

{
  "formState": {
    "image": "https://.../face.png",
    "audio": "https://.../voice.mp3",
    "resolution": "720p"
  }
}

// Immediate Response:
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing"
}

// Step 2: Poll for status (repeat every 5-10 seconds)
GET /api/v1/jobs/550e8400-e29b-41d4-a716-446655440000
Authorization: Bearer sk_XXXX_YYYY

// Response while processing:
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "lipsync",
  "status": "processing",
  "output": null,
  "error": "",
  "executionTime": null,
  "timings": null
}

// Response when completed:
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "lipsync-image",
  "status": "completed",
  "output": "https://.../result.mp4",
  "error": "",
  "executionTime": 12345,
  "timings": null
}

// Response if failed:
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "lipsync-image",
  "status": "failed",
  "output": null,
  "error": "Invalid audio format",
  "executionTime": null,
  "timings": null
}

Complete Code Examples

Ready-to-use integration examples

✓Node.js with Webhook (Recommended)

import fetch from 'node-fetch';
import express from 'express';

const API_KEY = 'Bearer sk_XXXX_YYYY';
const BASE_URL = 'https://lipsync.studio/api/v1';

// Set up webhook server to receive results
const app = express();
app.use(express.json());

app.post('/webhooks/lipsync', (req, res) => {
  const { id, status, output, error, model } = req.body;
  
  console.log('✅ Job update received!');
  console.log('Job ID:', id);
  console.log('Model:', model);
  console.log('Status:', status);
  if (status === 'completed') {
    console.log('Video URL:', output);
  } else if (status === 'failed') {
    console.error('Error:', error);
  }
  
  // TODO: Save output URL to your database, send notification, etc.
  
  res.status(200).json({ received: true });
});

app.listen(3000, () => {
  console.log('Webhook server listening on port 3000');
});

// Submit job with webhook
async function submitJobWithWebhook() {
  const webhookUrl = 'https://your-public-domain.com/webhooks/lipsync';
  
  const res = await fetch(`${BASE_URL}/lipsync-image`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': API_KEY
    },
    body: JSON.stringify({
      webhook: webhookUrl,
      formState: {
        image: 'https://example.com/portrait.jpg',
        audio: 'https://example.com/speech.mp3',
        resolution: '720p'
      }
    })
  });
  
  const data = await res.json();
  console.log('Job submitted:', data.id);
  console.log('Waiting for webhook callback...');
  
  // You don't need to poll! The result will be POSTed to your webhook.
}

submitJobWithWebhook();