Skip to main content

Referência da API HappyOyster-Directing-Update Script

Envie o conjunto completo de 45 turnos em uma Travel no modo script para substituir totalmente os atos da Travel atual. Apenas creationModel=scriptlist é suportado.

Escopo

Envie o conjunto completo de 45 turnos em uma Travel no modo script (creationModel=scriptlist) para substituir totalmente os acts da Travel atual. Antes de chamar, confirme o seguinte:
  • Autenticação: A Chave de API primária não é obrigatória; tanto a chave primária quanto uma temporária podem chamá-la. Para saber como obtê-las, veja Obter credenciais de autenticação.
  • Pré-requisitos: O creationModel da Travel deve ser scriptlist, e seu status deve ser running ou pending. Confirme via Consultar Status da Travel.
  • Chamador: Tanto seu servidor quanto seu cliente podem fazer a chamada.

Solicitação HTTP

  • Singapore
  • EUA (Virgínia)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/openapi/v1/travels/update-scriptSubstitua {WorkspaceId} pelo seu ID do Workspace real.

Parâmetros da solicitação

  • Atualizar script
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"
}'
O exemplo mostra apenas os atos 1 e 2 para ilustrar a estrutura e não deve ser enviado como está. Uma solicitação real deve conter todas as 45 entradas, do turno 1 ao 45, contíguas e sem duplicatas.
Content-Typestring(Obrigatório)Tipo de conteúdo da solicitação. Este parâmetro deve ser definido como application/json.
Authorization string (Obrigatório)Autenticação por Chave de API. A Chave de API primária não é obrigatória; tanto a chave primária quanto uma temporária podem chamá-lo.
  • API Key Primária: começa com sk-, ex. sk-xxx.
  • Chave de API Temporária: começa com st-, por exemplo, st-xxx.
Corpo da solicitação
encryptedTravelId string (Obrigatório)O ID criptografado da Travel de Direção a ser atualizado; seu creationModel deve ser scriptlist. Retornado por Entrar na Travel.
scriptList object (Obrigatório)Contêiner completo do script. Apenas acts tem efeito; mesmo que inclua subjects, synopsis, scene, style, speed, language, setting, soundtrack, prologue ou videoTags, esses campos são ignorados e a plataforma continua usando os valores salvos na criação do Mundo.scriptList.acts array (Obrigatório)Lista completa de atos. Restrições:
  • Deve ter exatamente 45 entradas
  • turn deve cobrir 1–45, contíguo e não duplicado
  • content não vazio, até 2000 caracteres por batida; todo content totalizando até 100000 caracteres
  • cameraType (opcional, padrão Static), shotSize (opcional, Wide / Medium / Close-up, padrão Medium), cut (opcional, padrão long-take)
Este endpoint é uma substituição completa e não suporta o envio apenas dos turnos alterados.
userAgent string (Opcional)Identificador de versão do SDK ou cliente. Uma string não vazia; tem precedência sobre o User-Agent HTTP.

Parâmetros de resposta

  • Atualização aceita
{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "accepted": true,
        "turnCount": 45
    }
}
code integerCódigo de retorno. 0 indica sucesso; diferente de zero é um código de erro.
message stringMensagem de erro. null em caso de sucesso.
data objectDados da resposta. null em caso de falha.

Propriedades

encryptedTravelId stringO Travel ID criptografado.accepted booleanSe o script completo foi aceito e entrou no fluxo de processamento.turnCount integerO número de turnos nesta atualização completa, fixado em 45.

Estados pré-requisitos e notas de chamada

  • Apenas creationModel=scriptlist suporta este endpoint; uma Viagem em modo padrão que o chamar por engano retornará 409000.
  • O status da Viagem deve ser running ou pending.
  • acts deve ter exatamente 45 entradas; turn deve ser 1–45, contíguo e não duplicado, caso contrário 400000 é retornado.
  • Conteúdo de script que falha na política de segurança de conteúdo retorna 403004; uma rejeição de conformidade de direitos autorais ou PI retorna 403005.

Códigos de erro

Se a chamada do modelo falhar e retornar um erro, consulte Códigos de Erro do HappyOyster para resolvê-lo.

Próximos passos

Após a atualização: