メインコンテンツへスキップ
POST
OmniHuman-1.5 デジタルヒューマン動画生成

承認

Authorization
string
header
必須

##すべてのAPIにBearer Token認証が必要です##

APIキーの取得:

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

リクエストヘッダーに追加:

ボディ

application/json
model
enum<string>
デフォルト:omnihuman-1.5
必須

デジタルヒューマン動画生成モデル名

利用可能なオプション:
omnihuman-1.5
:

"omnihuman-1.5"

audio_url
string<uri>
必須

リップシンクとボディモーションを駆動するための音声URL

注意:

  • 最大音声時間: 35
  • サポートされるフォーマット: .mp3.wav
  • 音声URLはサーバーから直接アクセス可能である必要があります
  • 課金は音声の長さに基づきます(秒単位で切り上げ)
:

"https://example.com/audio.mp3"

image_urls
string<uri>[]
必須

アニメーション対象の人物を含む参照画像URLリスト

注意:

  • リクエストあたりの画像数: 1
  • 画像には明確な人物が含まれている必要があります
  • 画像サイズ: 10MB以下
  • サポートされるファイルフォーマット: .jpg.jpeg.png.webp
  • 画像URLはサーバーから直接閲覧可能である必要があります
Maximum array length: 1
:
prompt
string

生成スタイルをガイドするオプションのテキストプロンプト、中国語、英語、日本語、韓国語、メキシコスペイン語、インドネシア語のみサポート

:

"A person speaking naturally with subtle expressions"

pe_fast_mode
boolean
デフォルト:false

高速処理モードを有効にする

注意:

  • true: より高速な生成(品質が低下する可能性あり)
  • false: 標準品質処理(デフォルト)
:

false

mask_url
string<uri>[]

アニメーション領域を指定するためのマスクURL配列

注意:

  • 高度な制御用のオプションパラメータ
  • マスク画像は参照画像の寸法と一致する必要があります
:
seed
integer

初期拡散状態を決定するためのランダムシード、デフォルトはランダム。シードが同じ正の整数で、他のすべてのパラメータが一致している場合、生成されるコンテンツは一貫した結果になる可能性があります

subject_check
boolean
デフォルト:false

画像内の人物の存在を確認するための被写体検出を有効にする

注意:

  • true: 被写体検出を有効にする、リクエスト開始時間が増加します
  • false: 被写体検出をスキップ(デフォルト)
:

false

auto_mask
boolean
デフォルト:false

自動マスク生成を有効にする

注意:

  • true: 人物を自動検出してマスクします。リクエストの開始時間が長くなります。mask_url に値がある場合、このパラメータは無視されます
  • false: 提供された mask_url を使用するか、マスクなし(デフォルト)
:

false

callback_url
string<uri>

タスク完了後の HTTPS コールバックアドレス

コールバックタイミング:

  • タスクが完了、失敗、またはキャンセルされた時にトリガーされます
  • 課金確認完了後に送信されます

セキュリティ制限:

  • 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 秒後にリトライ)
  • コールバックレスポンスボディの形式はタスククエリ API のレスポンス形式と一致
  • コールバックアドレスが 2xx ステータスコードを返した場合は成功とみなされ、その他のステータスコードはリトライをトリガーします
:

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

レスポンス

デジタルヒューマン動画生成タスクが正常に作成されました

created
integer

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

:

1757169743

id
string

タスク ID

:

"task-unified-1757169743-7cvnl5zw"

model
string

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

:

"omnihuman-1.5"

object
enum<string>

具体的なタスクタイプ

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

タスク進捗率(0-100)

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

0

status
enum<string>

タスクステータス

利用可能なオプション:
pending,
processing,
completed,
failed
:

"pending"

task_info
object

動画タスクの詳細情報

type
enum<string>

タスク出力タイプ

利用可能なオプション:
text,
image,
audio,
video
:

"video"

usage
object

使用量と課金情報