Alibaba Cloud Model Studio:Référence de l'API HappyOyster-Directing-Update Script

Paramètres de la requête

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"
}'

L'exemple n'affiche que les actes 1 et 2 pour illustrer la structure et ne doit pas être soumis tel quel. Une requête réelle doit contenir toutes les 45 entrées, du tour 1 à 45, contiguës et non dupliquées.

Content-Typestring(Requis)

Type de contenu de la requête. Ce paramètre doit être défini sur application/json.

Authorization string (Requis)

Authentification par clé API. La clé API principale n'est pas requise ; la clé principale ou une clé API temporaire peut l'appeler.

• Clé API principale : commence par sk-, par ex. sk-xxx.
• Clé API temporaire : commence par st-, par exemple st-xxx.

Corps de la requête

encryptedTravelId string (Obligatoire)

L'ID de Travel chiffré Directing à mettre à jour ; son creationModel doit être scriptlist. Renvoyé par Enter Travel.

scriptList object (Obligatoire)

Conteneur de script complet. Seul acts prend effet ; même s'il inclut subjects, synopsis, scene, style, speed, language, setting, soundtrack, prologue ou videoTags, ces champs sont ignorés et la plateforme continue d'utiliser les valeurs enregistrées lors de la création du World.

scriptList.acts array (Obligatoire)

Liste complète des actes. Contraintes :

• Doit contenir exactement 45 entrées
• turn doit couvrir 1–45, contigus et non dupliqués
• content non vide, jusqu'à 2000 caractères par battement ; tous les content totalisant jusqu'à 100000 caractères
• cameraType (optionnel, par défaut Static), shotSize (optionnel, Wide / Medium / Close-up, par défaut Medium), cut (optionnel, par défaut long-take)

Ce point de terminaison est un remplacement complet et ne prend pas en charge la soumission uniquement des tours modifiés.

userAgent string (Facultatif)

Identifiant de version du SDK ou du client. Une chaîne non vide ; prévaut sur le User-Agent HTTP.

Paramètres de réponse

code integer

Code de retour. 0 indique un succès ; une valeur non nulle correspond à un code d'erreur.

message string

Message d'erreur. null en cas de succès.

data object

Données de réponse. null en cas d'échec.