Skip to main content

Referencia de la API HappyOyster-Directing-Update Script

Envíe el conjunto completo de 45 turnos en un viaje en modo guion para reemplazar por completo los actos del viaje actual. Solo se admite creationModel=scriptlist.

Ámbito

Envíe el conjunto completo de 45 turnos en un viaje en modo guion (creationModel=scriptlist) para reemplazar por completo los acts del viaje actual. Antes de realizar la llamada, confirme lo siguiente:
  • Autenticación: La clave de API principal no es obligatoria; pueden invocarla tanto la clave principal como una temporal. Para saber cómo obtenerlas, consulte Obtener credenciales de autenticación.
  • Requisitos previos: El creationModel del viaje debe ser scriptlist, y su estado debe ser running o pending. Confirme mediante Consultar estado del viaje.
  • Solicitante: Puede invocarla su servidor o su cliente.

Solicitud HTTP

  • Singapore
  • EE. UU. (Virginia)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/openapi/v1/travels/update-scriptReemplace {WorkspaceId} con su ID de espacio de trabajo real.

Parámetros de solicitud

  • Actualizar guion
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

  • Actualización aceptada
{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "accepted": true,
        "turnCount": 45
    }
}
code integerCódigo de retorno. 0 indica éxito; un valor distinto de cero es un código de error.
message stringMensaje de error. null en caso de éxito.
data objectDatos de respuesta. null en caso de fallo.

Propiedades

encryptedTravelId stringEl ID de viaje cifrado.accepted booleanSi el script completo ha sido aceptado y ha entrado en el flujo de procesamiento.turnCount integerEl número de turnos en esta actualización completa, fijo en 45.

Estados previos y notas de llamada

  • Solo creationModel=scriptlist admite este endpoint; un Travel en modo estándar que lo llame por error devuelve 409000.
  • El estado del Travel debe ser running o pending.
  • acts debe tener exactamente 45 entradas; turn debe ser 1–45, contiguo y sin duplicados, de lo contrario se devuelve 400000.
  • El contenido del script que falla la política de seguridad de contenido devuelve 403004; un rechazo por cumplimiento de derechos de autor o propiedad intelectual devuelve 403005.

Códigos de error

Si la llamada al modelo falla y devuelve un error, consulte Códigos de error de HappyOyster para resolverlo.

Siguientes pasos

Después de actualizar: