Skip to Content
APIリファレンス動画動画生成

動画生成

POSThttps://ai-gateway.lolipop.jp/v1/videos

動画の生成をリクエストします。 レスポンスには、動画そのものではなく、動画の id が含まれます。 この id を使って生成状況を取得し、生成が完了したらダウンロードします。

モデルごとの使い方は動画生成を参照してください。

認証

Authorizationstring必須

Bearer <APIキー> の形式で指定します。 詳しくは認証を参照してください。

リクエストボディ

JSON、または multipart/form-data で指定します。 指定できる値は、モデルによって異なります。

modelstring必須

使用するモデルのID。 モデルの一覧で、output_modality が video のモデルを指定します。

promptstring必須

生成する動画の説明。

secondsstring | integer

動画の長さ(秒)。

sizestring

動画のサイズ。 1280x720 のように指定します。

input_referencefile

参照する画像。 multipart/form-data で指定します。

parametersobject

Veo向けのパラメーター。

フィールドを表示フィールドを非表示
sampleCountintegerデフォルト値 1

生成する動画の本数。

resolutionstringデフォルト値 720p

解像度。

generateAudiobooleanデフォルト値 true

音声を生成するかどうか。

durationSecondsintegerデフォルト値 8

動画の長さ(秒)。

extra_bodyobject

Seedance向けのパラメーター。 callback_url、draft、draft_task_id は指定できません。指定すると 400 が返ります。

フィールドを表示フィールドを非表示
contentarray

テキスト、画像、動画、音声の入力。 type に text、image_url、video_url、audio_url のいずれかを指定します。

resolutionstringデフォルト値 720p

解像度。

ratiostringデフォルト値 adaptive

アスペクト比。

durationinteger

動画の長さ(秒)。 Seedance 2.0は4〜15、Seedance 2.5は4〜30の整数で指定します。 -1 を指定すると、長さは自動で決まります。

generate_audiobooleanデフォルト値 true

音声を生成するかどうか。

priorityintegerデフォルト値 0

優先度。 0〜9の整数で指定します。

レスポンス

idstring

動画のID。

objectstring

オブジェクトの種類。 常に video です。

statusstring

生成の状態。 queued、completed、failed などの値をとります。

エラー

エラーの一覧はエラーを参照してください。

ステータスコードcode原因
400bad_requestリクエストボディの形式や値が正しくない、または指定した条件の料金が登録されていない
401invalid_api_keyAPIキーが正しくない
402insufficient_balanceクレジット残高が不足している
402budget_guardrail_exceeded予算の上限を超えている
403model_not_allowedモデルの利用が許可されていない
403provider_credential_requiredモデルの利用に、プロバイダーの認証情報の登録(BYOK)が必要
404model_not_foundモデルが見つからない、または動画を出力するモデルではない
429rate_limit_exceededレート制限を超えている
502upstream_errorプロバイダーから正常なレスポンスを受け取れなかった
503service_unavailableサービスが一時的に利用できない