升级角色动作外部接口与辅助工具

外部接口返回正式 resource 与 asset，并以数组顺序表达动作帧。
helper 只调用一次动作生成接口并直接消费正式结果，不再二次创建资源或兼容旧运行字段。
同步 OpenAPI、接口选择说明与 helper 自测。

docs/openapi/genarrative-external-v1.openapi.json

@@ -1896,7 +1896,19 @@
             "type": [
               "string",
               "null"
-            ]
+            ],
+            "description": "权威媒体类别。character-animation 渲染为序列帧，video 渲染为视频，audio/sound-effect/background-music 渲染为音频，其余渲染为图片。"
+          },
+          "imageSequenceFrames": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/EditorImageSequenceFrame"
+            }
+          },
+          "imageSequenceDurationMs": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "assetKind=character-animation 时完整图片序列播放一次的毫秒时长；与音频、视频生成参数 durationSeconds 无关。"
           },
           "generationInputs": {
             "$ref": "#/components/schemas/JsonValue"
@@ -1979,7 +1991,19 @@
             "type": [
               "string",
               "null"
-            ]
+            ],
+            "description": "权威媒体类别。character-animation 渲染为序列帧，video 渲染为视频，audio/sound-effect/background-music 渲染为音频，其余渲染为图片。"
+          },
+          "imageSequenceFrames": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/EditorImageSequenceFrame"
+            }
+          },
+          "imageSequenceDurationMs": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "assetKind=character-animation 时完整图片序列播放一次的毫秒时长；与音频、视频生成参数 durationSeconds 无关。"
           },
           "generationInputs": {
             "$ref": "#/components/schemas/JsonValue"
@@ -2315,7 +2339,19 @@
             "type": [
               "string",
               "null"
-            ]
+            ],
+            "description": "权威媒体类别。character-animation 渲染为序列帧，video 渲染为视频，audio/sound-effect/background-music 渲染为音频，其余渲染为图片。"
+          },
+          "imageSequenceFrames": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/EditorImageSequenceFrame"
+            }
+          },
+          "imageSequenceDurationMs": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "assetKind=character-animation 时完整图片序列播放一次的毫秒时长；与音频、视频生成参数 durationSeconds 无关。"
           },
           "generationInputs": {
             "$ref": "#/components/schemas/JsonValue"
@@ -2458,6 +2494,18 @@
           "sourceType": {
             "type": "string"
           },
+          "imageSequenceFrames": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/EditorImageSequenceFrame"
+            },
+            "description": "assetKind=character-animation 时的完整可播放帧集合。"
+          },
+          "imageSequenceDurationMs": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "assetKind=character-animation 时完整图片序列播放一次的毫秒时长；与音频、视频生成参数 durationSeconds 无关。"
+          },
           "prompt": {
             "type": [
               "string",
@@ -2492,7 +2540,8 @@
             "type": [
               "string",
               "null"
-            ]
+            ],
+            "description": "权威媒体类别。character-animation 渲染为序列帧，video 渲染为视频，audio/sound-effect/background-music 渲染为音频，其余渲染为图片。"
           },
           "generationInputs": {
             "$ref": "#/components/schemas/JsonValue"
@@ -3444,7 +3493,7 @@
               "string",
               "null"
             ],
-            "description": "角色动作绿幕预览视频写入账号素材库的文件夹；省略时写入默认项目素材文件夹。"
+            "description": "角色动作预览视频和最终透明序列帧素材写入账号素材库的文件夹；省略时写入默认项目素材文件夹。"
           },
           "assetLabel": {
             "type": [
@@ -3457,22 +3506,29 @@
         },
         "additionalProperties": false
       },
-      "EditorCharacterAnimationFrame": {
+      "EditorImageSequenceFrame": {
         "type": "object",
         "required": [
-          "frameIndex",
           "imageSrc",
           "width",
           "height"
         ],
         "properties": {
-          "frameIndex": {
-            "type": "integer",
-            "minimum": 0
-          },
           "imageSrc": {
             "type": "string"
           },
+          "objectKey": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "assetObjectId": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
           "width": {
             "type": "integer",
             "minimum": 1
@@ -3481,7 +3537,9 @@
             "type": "integer",
             "minimum": 1
           }
-        }
+        },
+        "additionalProperties": false,
+        "description": "图片序列帧。数组位置是唯一播放顺序，不携带额外序号字段。"
       },
       "EditorCharacterAnimationGenerationResponse": {
         "type": "object",
@@ -3518,7 +3576,7 @@
           "frames": {
             "type": "array",
             "items": {
-              "$ref": "#/components/schemas/EditorCharacterAnimationFrame"
+              "$ref": "#/components/schemas/EditorImageSequenceFrame"
             }
           },
           "frameCount": {
@@ -3556,6 +3614,28 @@
             ],
             "description": "当请求携带 canvasCompletion 且服务端成功写入画布布局时返回最新项目快照。"
           },
+          "resource": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/EditorProjectResource"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "最终透明角色动作对应的项目资源。携带 projectId 时，画布图层必须直接引用其 resourceId，不得再次创建重复资源。"
+          },
+          "asset": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/EditorAsset"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "最终透明角色动作素材。assetKind 为 character-animation，并直接包含序列帧字段。"
+          },
           "queueState": {
             "anyOf": [
               {