メインコンテンツへスキップ
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "videoretalk",
  "video_url": "https://example.com/speaker.mp4",
  "audio_url": "https://example.com/target-speech.wav"
}
'
{
  "created": 1775200000,
  "id": "task-unified-1775200000-xyz12345",
  "model": "videoretalk",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 90,
    "video_duration": 0
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 480,
    "user_group": "default"
  }
}

承認

​
Authorization
string
header
必須

##すべてのインターフェースは Bearer Token による認証が必要です##

API キーの取得：

API キー管理ページ にアクセスして API キーを取得してください

リクエストヘッダーに以下を追加してください：

Authorization: Bearer YOUR_API_KEY

ボディ

application/json
​
model
enum<string>
デフォルト:videoretalk
必須

モデル名

利用可能なオプション:
videoretalk
例:

"videoretalk"

​
video_url
string<uri>
必須

口パクを置き換える人物を含む入力動画 URL

要件：

  • インターネットからアクセス可能な動画 URL
  • 形式：MP4、MOV などの一般的な形式
  • 動画内に明確に見える顔が必要
  • 推奨時間：2 ～ 300 秒
例:

"https://example.com/speaker.mp4"

​
audio_url
string<uri>
必須

ターゲット音声 URL（動画内の人物がこの音声に合わせて話します）

要件：

  • インターネットからアクセス可能な音声 URL
  • 形式：WAV、MP3、M4A などの一般的な形式
  • 人声による発話内容を推奨
例:

"https://example.com/target-speech.wav"

​
ref_image_url
string<uri>

顔参照画像 URL

動画に複数の顔がある場合、この画像で口パクを置き換えるターゲットの顔を指定します

要件：

  • 画像にターゲット人物の正面顔が含まれていること
  • 動画に複数の顔がある場合にのみ必要
例:

"https://example.com/target-person-face.jpg"

​
video_extension
boolean
デフォルト:false

音声の長さが動画の長さより長い場合、動画を自動的に音声の長さまで延長するかどうか

  • true：出力時間 = 音声時間（動画が自動延長される）
  • false：出力時間 = min(動画時間, 音声時間)
例:

false

​
query_face_threshold
integer
デフォルト:170

顔マッチングの信頼度しきい値

  • 範囲：120 ～ 200
  • 値が低いほどマッチングしやすい（誤マッチングの可能性あり）
  • 値が高いほど厳格（マッチングできない可能性あり）
  • 「一致する顔が見つからない」エラーが出た場合は少し下げてください（例：140）
  • 間違った顔にマッチングした場合は少し上げてください（例：190）
必須範囲: 120 <= x <= 200
例:

170

​
callback_url
string<uri>

タスク完了後の HTTPS コールバック URL

コールバックのタイミング：

  • タスクが完了（completed）、失敗（failed）、またはキャンセル（cancelled）した際にトリガー
  • 課金確認後に送信

セキュリティ制限：

  • HTTPS プロトコルのみサポート
  • 内部 IP アドレスへのコールバックは禁止（127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x など）
  • URL の長さは 2048 文字以内

コールバックの仕組み：

  • タイムアウト：10 秒
  • 失敗時は最大 3 回リトライ（失敗後それぞれ 1 秒 / 2 秒 / 4 秒後にリトライ）
  • コールバックのレスポンスボディ形式はタスク照会インターフェースの返却形式と同一
  • コールバック URL が 2xx ステータスコードを返した場合は成功とみなし、それ以外はリトライをトリガー
例:

"https://your-domain.com/webhooks/video-task-completed"

レスポンス

音声駆動ポートレート動画生成タスクの作成に成功

​
created
integer

タスク作成タイムスタンプ

例:

1775200000

​
id
string

タスク ID

例:

"task-unified-1775200000-xyz12345"

​
model
string

実際に使用されたモデル名

例:

"videoretalk"

​
object
enum<string>

タスクの具体的なタイプ

利用可能なオプション:
video.generation.task
​
progress
integer

タスクの進捗率 (0-100)

必須範囲: 0 <= x <= 100
例:

0

​
status
enum<string>

タスクのステータス

ステータスprogress説明
pending0~10処理待ち
processing10~80処理中
completed100完了
failed0失敗
利用可能なオプション:
pending,
processing,
completed,
failed
例:

"pending"

​
task_info
object

動画タスクの詳細情報

​
type
enum<string>

タスクの出力タイプ

利用可能なオプション:
video
例:

"video"

​
usage
object

使用量と課金情報