Skip to main content

Referência da API HappyOyster-Acting-Send Process Instruction

Envie uma única instrução de texto para um Travel do Acting para impulsionar a interpretação de papéis e a geração de quadros subsequentes. Pode ser chamado quando o Travel está em execução ou pausado.

Escopo

Envie uma única instrução de texto para um Travel do Acting para impulsionar a interpretação de papéis e a geração de quadros subsequentes. 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 estado do Travel deve ser running ou paused. Confirme via Query Travel Status.
  • 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-acting/openapi/v1/travels/instructSubstitua {WorkspaceId} pelo seu ID do Workspace real.

Parâmetros da solicitação

  • Enviar instrução de processo
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travels/instruct' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "encryptedTravelId": "{encryptedTravelId}",
    "content": "Smile and greet me, and ask how my day is going",
    "clientRequestId": "instruction_greeting_001",
    "userAgent": "HappyOyster-Web/1.2.0"
}'
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 Travel ID criptografado do Acting a ser controlado. Retornado por Enter Travel.
content string (Obrigatório)A instrução de processo de texto. Não vazia, até 2000 caracteres; retorna 400000 quando ausente, vazia ou acima do limite.
clientRequestId string (Opcional)Chave de idempotência para novas tentativas de instrução. Reutilize o mesmo valor ao tentar novamente a mesma instrução para evitar cobrança duplicada. Formato recomendado [A-Za-z0-9_-]{1,32}.
  • Ser omitido ou malformado não retorna um erro de parâmetro: o servidor recorre ao request_id do gateway e usa uma chave de idempotência aleatória quando isso ainda estiver indisponível
  • Este campo é usado apenas para deduplicação de cobrança; ele não garante que o processamento da instrução em si seja executado exatamente uma vez
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

  • Instrução aceita
{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "content": "Smile and greet me, and ask how my day is going",
        "accepted": true
    }
}
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.content stringO texto da instrução aceita.accepted booleanSe a instrução foi aceita e entrou no fluxo de processamento.

Estados pré-requisitos e notas de chamada

  • O estado do Travel deve ser running ou paused.
  • content é obrigatório e não pode estar vazio ou conter apenas caracteres de espaço em branco, até 2000 caracteres.
  • Enviar uma instrução no estado paused apenas aceita a instrução e não retoma automaticamente o Travel; quando você precisar continuar a execução, o cliente deve chamar separadamente Resume Travel.
  • Reutilize o clientRequestId ao tentar novamente a mesma instrução lógica para evitar cobrança duplicada.
  • Um Travel que terminou ou falhou não é gravável.
  • Quando a instrução falha na política de segurança de conteúdo, 403004 é retornado.
  • O creationModel do Acting é sempre simple, portanto, não há necessidade de considerar o submodo ScriptList.

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 enviar a instrução: