Video（主体参照による動画生成）

Request

Header Params

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Content-Type

string

optional

Example:

application/json

Body Params application/json

model

string

required

S2V-01

prompt

string

optional

ビデオの說明を生成します。（注：200字未満が必要）

prompt_optimizer

boolean

optional

デフォルトの値はTrueで、モデルは送信されたpromptを自動的に最適化し、生成品質を向上させます。より正確な制御が必要な場合は、このパラメータをFalseに設定することができ、モデルはより厳密に指示に従います。最高の効果を得るために、この時点でより細かいpromptを提供することをお勧めします。

subject_reference

array [object {2}]

required

このパラメータは、モデルがS2V-01に選択されている場合にのみ使用できます。モデルはこのパラメータでアップロードされたボディに基づいて動画を生成します。現時点ではシングルボディリファレンスのみ対応しています（配列長は1）。

type

string

required

ボディタイプ。現時点でサポートされているのは、キャラクターの顔のボディ「character」のみです。

image

string

required

ボディ参照図のdata：image/jpeg;base64、{data}形式のBase64エンコード文字列、またはパブリックネットワークからアクセス可能なURL、文字列として配列に格納されます

Example

{
    "model": "S2V-01",
    "prompt": "a man is walking on the new york street",
    "subject_reference": [
        {
            "type": "character",
            "image": [
                "https://file.302ai.cn/gpt/imgs/20241012/813d3e2cecf146b1b5a3d1e742ee3e5d.png"
            ]
        }
    ]
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.302.ai/minimaxi/v1/video_generation' \
--header 'Authorization: Bearer sk-mfYQzy0XTFfz4P16vRE4gFrKK1Nly4TozsMqbbb9PSiJUvFO' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "S2V-01",
    "prompt": "a man is walking on the new york street",
    "subject_reference": [
        {
            "type": "character",
            "image": [
                "https://file.302ai.cn/gpt/imgs/20241012/813d3e2cecf146b1b5a3d1e742ee3e5d.png"
            ]
        }
    ]
}'

Responses

🟢200OK

application/json

Body

task_id

string

required

クエリータスクのID

base_resp

object

required

status_code

integer

required

status_msg

string

required

Example

{
    "task_id": "227311208538261",
    "base_resp": {
        "status_code": 0,
        "status_msg": "success"
    }
}