Alibaba Cloud Model Studio:HappyOyster-Directing-スクリプト更新APIリファレンス

リクエストパラメーター

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/openapi/v1/travels/update-script' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "encryptedTravelId": "{encryptedTravelId}",
    "scriptList": {
        "acts": [
            {
                "turn": 1,
                "content": "[character_1] wakes up and looks toward the door.",
                "cameraType": "Static",
                "shotSize": "Medium",
                "cut": "long-take"
            },
            {
                "turn": 2,
                "content": "[character_1] walks slowly across the dark room.",
                "cameraType": "Tracking",
                "shotSize": "Wide",
                "cut": "hard-cut"
            }
        ]
    },
    "userAgent": "your-client/1.2.0"
}'

この例では、構造を説明するためにact 1と2のみを表示しており、そのまま提出してはなりません。実際のリクエストには、すべての45件のエントリを含める必要があり、turnは1〜45で、連続かつ重複があってはなりません。

Content-Typestring（必須）

リクエストのコンテンツタイプ。このパラメータは application/json に設定する必要があります。

Authorization string （必須）

API キー認証です。プライマリ API キーは必須ではなく、プライマリまたは一時 API キーのいずれかで呼び出せます。

• プライマリ API Key：sk- で始まります（例：sk-xxx）。
• 一時 API キー：st- で始まり、例は st-xxx です。

リクエストボディ

encryptedTravelId string （必須）

更新対象のDirecting暗号化Travel ID。そのcreationModelはscriptlistである必要があります。Travelへの入場によって返されます。

scriptList object （必須）

完全なスクリプトコンテナ。有効なのはactsのみです。subjects、synopsis、scene、style、speed、language、setting、soundtrack、prologue、またはvideoTagsが含まれていても、これらのフィールドは無視され、プラットフォームはWorld作成時に保存された値を引き続き使用します。

scriptList.acts array (必須)

完全なアクトリスト。制約事項：

• 正確に45件のエントリである必要があります
• turnは1〜45を網羅し、連続かつ重複がない必要があります
• contentは空ではなく、ビートあたり最大2000文字まで。すべてのcontentの合計は最大100000文字まで
• cameraType（オプション、デフォルトStatic）、shotSize（オプション、Wide / Medium / Close-up、デフォルトMedium）、cut（オプション、デフォルトlong-take）

このエンドポイントは完全置換であり、変更されたターンのみの送信はサポートしていません。

userAgent string （任意）

SDK またはクライアントのバージョン識別子です。空でない文字列であり、HTTP User-Agent よりも優先されます。

レスポンスパラメーター

code integer

リターンコード。0 は成功を意味し、ゼロ以外の値はエラーコードです。

message string

エラーメッセージ。成功時は null です。

data object

レスポンスデータ。失敗時は null です。