Skip to main content
POST
動画を作成
ワークスペースのプレビュー機能へのアクセスが必要です。設定、Webhook、結果の処理については、動画とバッチのジョブを参照してください。

承認

Authorization
string
header
必須

Bearer トークンによる認証

ボディ

application/json
model
string
必須
prompt
string
必須
duration
integer

希望する長さ(秒)。プロバイダー/モデルにより異なります。

input_video_duration
number<double>

入力元動画の長さ(秒)。プロバイダーが生成出力とは別に入力元動画の長さを課金する場合に必須です。

必須範囲: 0 < x <= 3600
input_audio_duration
number<double>

プロバイダーの許容範囲検証に使う、申告された入力元音声の長さ(秒)。確定した使用量を報告しないプロバイダーは、対応する入力長の上限で課金する場合があります。

必須範囲: 2 <= x <= 20
size
string

明示的な寸法(例:1280x720)。resolutionやaspect_ratioとは併用できません。

resolution
string

480p、720p、1080p、1K、2K、4K。aspect_ratioと併用できます。sizeとは併用できません。

aspect_ratio
string

16:9、9:16、1:1などのアスペクト比。resolutionと併用できます。sizeとは併用できません。

seed
integer
sample_count
integer
必須範囲: 1 <= x <= 4
negative_prompt
string
generate_audio
boolean
enhance_prompt
boolean
compression_quality
integer
person_generation
string
resize_mode
string
input_references
object[]

生成の条件となるHTTPSの画像、音声、動画入力。対応する種類、役割、数、組み合わせは選択モデルに依存します。ジョブ送信前にGET /videos/modelsを確認してください。このスキーマに含まれない単数形の互換エイリアスinput_referenceは、multipart画像、またはfile_idとimage_urlのいずれか1つだけを含むオブジェクトを受け付けます。対応はプロバイダーに依存します。

型を指定したHTTPSメディア入力。画像にはimage_url、音声や動画にはmedia_urlを使用します。役割はモデルによる入力の使用方法を表し、対応はプロバイダーとモデルで異なります。

frame_images
object[]

最初/最後のフレームのHTTPS画像。各frame_typeは1回だけ指定できます。input_referenceやinput_referencesのフレーム役割を追加で指定しないでください。

Required array length: 1 - 2 elements
provider_params
object

プロバイダー固有の拡張のみ。リクエスト全体のパススルーと、重複するルーティング、プロンプト、コールバック、課金フィールドは拒否されます。

provider_options
object

正規プロバイダーID(例:atlascloud、byteplus)で指定する拡張。選択したプロバイダーのオプションのみ転送されます。provider_paramsとは併用できません。ルーティング、プロンプト、コールバック、長さ、解像度、出力数には検証済みの最上位フィールドを使用してください。

output
object
webhook
object
provider
object

ゲートウェイでの選択に使用するプロバイダーのルーティング設定。

レスポンス

202 - application/json

動画のレスポンス

id
string
polling_url
string
websocket_url
string<uri>

非同期ジョブの正規化されたライフサイクル更新を購読するWebSocket URL。

model
string
request_id
string
session_id
string
status
enum<string>
利用可能なオプション:
queued,
processing,
completed,
failed,
cancelled,
expired
lifecycle_status
enum<string>

ポーリング、WebSocket、Webhookの利用側向けに正規化された非同期ライフサイクル状態。

利用可能なオプション:
pending,
running,
completed,
failed,
cancelled,
expired
cancel_url
string<uri> | null

互換性のために予約されています。現在は常にnullです。

output_access
enum<string>
利用可能なオプション:
bytes,
signed_url,
both
generation_id
string | null
native_video_id
string | null

ゲートウェイが所有するIDと異なる場合の、プロバイダー固有の動画/ジョブID。

created_at
started_at
completed_at
object
string
例:

"video"

poll_after_seconds
integer
例:

20

provider
string
seconds
number
size
string
audio
boolean
content_url
string

output_accessにbytesが含まれる場合に存在します(認証が必要なエンドポイント)。

download_url
string | null

状態がcompletedの場合の、直接ダウンロード用のファーストパーティ署名付きURL。

expires_at
integer | null

署名付きdownload_urlが失効するUnixタイムスタンプ(秒)。

progress
integer | null
progress_source
string
asset
object | null
outputs
object[]
billing
object
webhook
object

機密情報を除去した非同期Webhook設定と配信状態。シークレットは返されません。has_secretは署名付き配信が有効かを示します。署名付き配信にはx-phaseo-signature、x-phaseo-timestamp、x-phaseo-event-id、x-phaseo-event-type、x-phaseo-delivery-key、x-phaseo-attempt、x-phaseo-max-attemptsヘッダーが含まれます。

next_webhook_retry_at
string | null

ユーザーWebhookの次回再試行のISOタイムスタンプ(キューに登録されている場合)。

last_webhook_progress
number | null

Webhookの利用側に最後に送信した大まかな進捗区分。

last_webhook_progress_at
string | null

直近のWebhook進捗区分が送信されたISOタイムスタンプ。

last_webhook_dispatched_at
string | null

直近のWebhook送信試行のISOタイムスタンプ。

usage
object
error
unknown
最終更新日 2026年10月2日