Alibaba Cloud Model Studio:Referencia de la API HappyOyster-Directing-Update Script

Parámetros de solicitud

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

El ejemplo muestra solo los actos 1 y 2 para ilustrar la estructura y no debe enviarse tal cual. Una solicitud real debe contener las 45 entradas completas, turnos 1–45, contiguos y sin duplicados.

Content-Typestring(Requerido)

Tipo de contenido de la solicitud. Este parámetro debe establecerse en application/json.

Authorization string (Requerido)

Autenticación mediante clave de API. No se requiere la clave de API principal; pueden invocarla tanto la clave principal como una temporal.

• Clave de API principal: comienza con sk-, por ejemplo, sk-xxx.
• Clave de API temporal: comienza con st-, por ejemplo, st-xxx.

Cuerpo de la solicitud

encryptedTravelId string (Obligatorio)

El ID de viaje cifrado de Directing que se va a actualizar; su creationModel debe ser scriptlist. Devuelto por Ingresar al viaje.

scriptList object (Obligatorio)

Contenedor completo del guion. Solo acts surte efecto; incluso si incluye subjects, synopsis, scene, style, speed, language, setting, soundtrack, prologue o videoTags, estos campos se ignoran y la plataforma continúa utilizando los valores guardados en la creación del mundo.

scriptList.acts array (Required)

Lista completa de actos. Restricciones:

• Debe tener exactamente 45 entradas
• turn debe cubrir 1–45, contiguo y sin duplicados
• content no vacío, hasta 2000 caracteres por beat; todo content sumando hasta 100000 caracteres
• cameraType (opcional, predeterminado Static), shotSize (opcional, Wide / Medium / Close-up, predeterminado Medium), cut (opcional, predeterminado long-take)

Este endpoint es un reemplazo completo y no admite enviar solo los turnos modificados.

userAgent string (Opcional)

Identificador de versión del SDK o del cliente. Una cadena no vacía; tiene prioridad sobre el User-Agent HTTP.

Parámetros de respuesta

code integer

Código de retorno. 0 indica éxito; un valor distinto de cero es un código de error.

message string

Mensaje de error. null en caso de éxito.

data object

Datos de respuesta. null en caso de fallo.