kdletters
b49bf9c984
将旧布局上限统一提升至2MiB并接入revision CAS保存 新增画布图层、生成对话框和迁移状态结构化存储 新增migration operator保护的回填、激活和回滚脚本 新增历史图片映射及音频资源恢复的定向dry-run/apply流程 补齐前端保存队列、OpenAPI、Bindings、发布归档与回归测试
4086 lines
102 KiB
JSON
4086 lines
102 KiB
JSON
{
|
||
"openapi": "3.1.0",
|
||
"info": {
|
||
"title": "陶泥儿外部编辑器 OpenAPI",
|
||
"version": "1.0.0",
|
||
"description": "外部系统调用陶泥儿图片画布项目、画布布局、素材库，以及图片、视频、音效、音乐等编辑器素材生成/编辑能力的 v1 契约。新建 projectId 使用 proj- 前缀，新建 taskId / operationId 使用 task- 前缀；历史 editor-project-*、aitask_*、extgen-* ID 仍可作为既有资源标识传入。"
|
||
},
|
||
"servers": [
|
||
{
|
||
"url": "/",
|
||
"description": "当前部署环境"
|
||
}
|
||
],
|
||
"tags": [
|
||
{
|
||
"name": "Editor Projects",
|
||
"description": "图片画布项目"
|
||
},
|
||
{
|
||
"name": "Editor Canvas",
|
||
"description": "图片画布布局"
|
||
},
|
||
{
|
||
"name": "Editor Assets",
|
||
"description": "账号级编辑器素材库"
|
||
},
|
||
{
|
||
"name": "Asset Objects",
|
||
"description": "素材对象上传、确认与签名读取"
|
||
},
|
||
{
|
||
"name": "Editor Images",
|
||
"description": "编辑器美术生图"
|
||
},
|
||
{
|
||
"name": "Editor Videos",
|
||
"description": "编辑器视频与角色动画生成"
|
||
},
|
||
{
|
||
"name": "Editor Audio",
|
||
"description": "编辑器音效与音乐生成"
|
||
}
|
||
],
|
||
"paths": {
|
||
"/api/external/v1/openapi.json": {
|
||
"get": {
|
||
"tags": [
|
||
"Editor Projects"
|
||
],
|
||
"operationId": "getExternalOpenApiJson",
|
||
"summary": "读取外部 API OpenAPI JSON",
|
||
"security": [],
|
||
"responses": {
|
||
"200": {
|
||
"description": "OpenAPI 3.1 JSON",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"type": "object"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/external/v1/assets/direct-upload-tickets": {
|
||
"post": {
|
||
"tags": [
|
||
"Asset Objects"
|
||
],
|
||
"operationId": "createExternalDirectUploadTicket",
|
||
"summary": "创建素材直传 OSS 凭证",
|
||
"description": "为外部编辑器素材上传创建一次性 OSS 表单直传参数。上传完成后应调用 objects/confirm 确认 asset object，再创建素材记录。",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"requestBody": {
|
||
"required": true,
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/CreateDirectUploadTicketRequest"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "直传凭证",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/CreateDirectUploadTicketResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"$ref": "#/components/responses/BadRequest"
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/external/v1/assets/objects/confirm": {
|
||
"post": {
|
||
"tags": [
|
||
"Asset Objects"
|
||
],
|
||
"operationId": "confirmExternalAssetObject",
|
||
"summary": "确认素材对象",
|
||
"description": "确认已上传的 OSS 对象并写入 asset_object；ownerUserId 固定使用 API Key 所属账号，请求体中的 ownerUserId 会被忽略。",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"requestBody": {
|
||
"required": true,
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ConfirmAssetObjectRequest"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "素材对象记录",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ConfirmAssetObjectResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"$ref": "#/components/responses/BadRequest"
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/external/v1/assets/read-url": {
|
||
"get": {
|
||
"tags": [
|
||
"Asset Objects"
|
||
],
|
||
"operationId": "getExternalAssetReadUrl",
|
||
"summary": "获取私有素材读取签名 URL",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "objectKey",
|
||
"in": "query",
|
||
"required": false,
|
||
"schema": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
{
|
||
"name": "legacyPublicPath",
|
||
"in": "query",
|
||
"required": false,
|
||
"schema": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
{
|
||
"name": "expireSeconds",
|
||
"in": "query",
|
||
"required": false,
|
||
"schema": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "签名读取 URL",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/GetAssetReadUrlResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"$ref": "#/components/responses/BadRequest"
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/external/v1/editor/projects": {
|
||
"get": {
|
||
"tags": [
|
||
"Editor Projects"
|
||
],
|
||
"operationId": "listEditorProjects",
|
||
"summary": "列出当前账号图片画布项目",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "项目列表",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ExternalEditorProjectListResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
}
|
||
}
|
||
},
|
||
"post": {
|
||
"tags": [
|
||
"Editor Projects"
|
||
],
|
||
"operationId": "createEditorProject",
|
||
"summary": "创建图片画布项目",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"requestBody": {
|
||
"required": false,
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ExternalEditorProjectCreateRequest"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "已创建项目",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ExternalEditorProjectResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/external/v1/editor/projects/recent": {
|
||
"get": {
|
||
"tags": [
|
||
"Editor Projects"
|
||
],
|
||
"operationId": "loadRecentEditorProject",
|
||
"summary": "读取当前账号最近图片画布项目",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "最近项目；当前账号没有项目时 project 为 null",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ExternalEditorProjectRecentResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/external/v1/editor/projects/{projectId}": {
|
||
"get": {
|
||
"tags": [
|
||
"Editor Projects"
|
||
],
|
||
"operationId": "getEditorProject",
|
||
"summary": "读取图片画布项目",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"parameters": [
|
||
{
|
||
"$ref": "#/components/parameters/ProjectId"
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "项目快照",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ExternalEditorProjectResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
},
|
||
"404": {
|
||
"$ref": "#/components/responses/NotFound"
|
||
}
|
||
}
|
||
},
|
||
"delete": {
|
||
"tags": [
|
||
"Editor Projects"
|
||
],
|
||
"operationId": "deleteEditorProject",
|
||
"summary": "删除图片画布项目",
|
||
"description": "删除项目时级联清理默认画布与项目资源元数据。",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"parameters": [
|
||
{
|
||
"$ref": "#/components/parameters/ProjectId"
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "已删除项目",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ExternalEditorProjectDeleteResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
},
|
||
"404": {
|
||
"$ref": "#/components/responses/NotFound"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/external/v1/editor/projects/{projectId}/metadata": {
|
||
"patch": {
|
||
"tags": [
|
||
"Editor Projects"
|
||
],
|
||
"operationId": "renameEditorProject",
|
||
"summary": "更新图片画布项目标题",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"parameters": [
|
||
{
|
||
"$ref": "#/components/parameters/ProjectId"
|
||
}
|
||
],
|
||
"requestBody": {
|
||
"required": true,
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ExternalEditorProjectRenameRequest"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "更新后的项目快照",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ExternalEditorProjectResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"$ref": "#/components/responses/BadRequest"
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
},
|
||
"404": {
|
||
"$ref": "#/components/responses/NotFound"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/external/v1/editor/projects/{projectId}/canvas": {
|
||
"patch": {
|
||
"tags": [
|
||
"Editor Canvas"
|
||
],
|
||
"operationId": "saveEditorProjectCanvas",
|
||
"summary": "保存默认画布布局",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"parameters": [
|
||
{
|
||
"$ref": "#/components/parameters/ProjectId"
|
||
}
|
||
],
|
||
"requestBody": {
|
||
"required": true,
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ExternalEditorCanvasSaveRequest"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "保存后的项目快照",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ExternalEditorProjectResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"$ref": "#/components/responses/BadRequest"
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
},
|
||
"404": {
|
||
"$ref": "#/components/responses/NotFound"
|
||
},
|
||
"409": {
|
||
"$ref": "#/components/responses/Conflict"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/external/v1/editor/projects/{projectId}/resources": {
|
||
"post": {
|
||
"tags": [
|
||
"Editor Assets"
|
||
],
|
||
"operationId": "createEditorProjectResource",
|
||
"summary": "创建项目画布资源记录",
|
||
"description": "把上传、生成或外部已有图片资源写入指定项目的画布资源表，供画布图层引用。",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"parameters": [
|
||
{
|
||
"$ref": "#/components/parameters/ProjectId"
|
||
}
|
||
],
|
||
"requestBody": {
|
||
"required": true,
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ExternalEditorProjectResourceCreateRequest"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "已创建项目画布资源",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ExternalEditorProjectResourceResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"$ref": "#/components/responses/BadRequest"
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
},
|
||
"404": {
|
||
"$ref": "#/components/responses/NotFound"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/external/v1/editor/assets/library": {
|
||
"get": {
|
||
"tags": [
|
||
"Editor Assets"
|
||
],
|
||
"operationId": "getEditorAssetLibrary",
|
||
"summary": "读取当前账号编辑器素材库",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "素材库快照",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ExternalEditorAssetLibraryResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/external/v1/editor/assets/folders": {
|
||
"post": {
|
||
"tags": [
|
||
"Editor Assets"
|
||
],
|
||
"operationId": "createEditorAssetFolder",
|
||
"summary": "创建素材文件夹",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"requestBody": {
|
||
"required": true,
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ExternalEditorAssetFolderCreateRequest"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "已创建素材文件夹",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ExternalEditorAssetFolderResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"$ref": "#/components/responses/BadRequest"
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/external/v1/editor/assets/folders/{folderId}": {
|
||
"patch": {
|
||
"tags": [
|
||
"Editor Assets"
|
||
],
|
||
"operationId": "updateEditorAssetFolder",
|
||
"summary": "更新素材文件夹",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"parameters": [
|
||
{
|
||
"$ref": "#/components/parameters/FolderId"
|
||
}
|
||
],
|
||
"requestBody": {
|
||
"required": true,
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ExternalEditorAssetFolderUpdateRequest"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "已更新素材文件夹",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ExternalEditorAssetFolderResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"$ref": "#/components/responses/BadRequest"
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
},
|
||
"404": {
|
||
"$ref": "#/components/responses/NotFound"
|
||
}
|
||
}
|
||
},
|
||
"delete": {
|
||
"tags": [
|
||
"Editor Assets"
|
||
],
|
||
"operationId": "deleteEditorAssetFolder",
|
||
"summary": "删除素材文件夹",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"parameters": [
|
||
{
|
||
"$ref": "#/components/parameters/FolderId"
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "删除后的素材库快照",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ExternalEditorAssetFolderDeleteResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
},
|
||
"404": {
|
||
"$ref": "#/components/responses/NotFound"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/external/v1/editor/assets": {
|
||
"post": {
|
||
"tags": [
|
||
"Editor Assets"
|
||
],
|
||
"operationId": "createEditorAsset",
|
||
"summary": "创建素材记录",
|
||
"description": "创建账号级编辑器素材记录。图片二进制上传仍应先通过已有资产上传链路完成，随后在这里保存素材元数据。",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"requestBody": {
|
||
"required": true,
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ExternalEditorAssetCreateRequest"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "已创建素材",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ExternalEditorAssetResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"$ref": "#/components/responses/BadRequest"
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/external/v1/editor/assets/{assetId}": {
|
||
"patch": {
|
||
"tags": [
|
||
"Editor Assets"
|
||
],
|
||
"operationId": "updateEditorAsset",
|
||
"summary": "更新素材名称或所在文件夹",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"parameters": [
|
||
{
|
||
"$ref": "#/components/parameters/AssetId"
|
||
}
|
||
],
|
||
"requestBody": {
|
||
"required": true,
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ExternalEditorAssetUpdateRequest"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "已更新素材",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ExternalEditorAssetResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"$ref": "#/components/responses/BadRequest"
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
},
|
||
"404": {
|
||
"$ref": "#/components/responses/NotFound"
|
||
}
|
||
}
|
||
},
|
||
"delete": {
|
||
"tags": [
|
||
"Editor Assets"
|
||
],
|
||
"operationId": "deleteEditorAsset",
|
||
"summary": "删除素材记录",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"parameters": [
|
||
{
|
||
"$ref": "#/components/parameters/AssetId"
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "已删除素材",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ExternalEditorAssetResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
},
|
||
"404": {
|
||
"$ref": "#/components/responses/NotFound"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/external/v1/editor/images/generations": {
|
||
"post": {
|
||
"tags": [
|
||
"Editor Images"
|
||
],
|
||
"operationId": "generateExternalEditorImage",
|
||
"summary": "生成编辑器图片素材",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"requestBody": {
|
||
"required": true,
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/EditorImageGenerationRequest"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "生成结果与落库资源",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/EditorImageGenerationResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"$ref": "#/components/responses/BadRequest"
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
},
|
||
"502": {
|
||
"$ref": "#/components/responses/UpstreamError"
|
||
}
|
||
},
|
||
"description": "支持普通生图、规范图、角色图、快速编辑参考图、UI 设计图和宣发素材生成。kind 可取 spec、character、quick-edit、ui-design、publication-material。"
|
||
}
|
||
},
|
||
"/api/external/v1/editor/images/edits": {
|
||
"post": {
|
||
"tags": [
|
||
"Editor Images"
|
||
],
|
||
"operationId": "editExternalEditorImage",
|
||
"summary": "重绘/调整编辑器图片素材",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"requestBody": {
|
||
"required": true,
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/EditorImageEditRequest"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "重绘结果与落库资源",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/EditorImageGenerationResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"$ref": "#/components/responses/BadRequest"
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
},
|
||
"502": {
|
||
"$ref": "#/components/responses/UpstreamError"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/external/v1/editor/icon-spritesheets/generations": {
|
||
"post": {
|
||
"tags": [
|
||
"Editor Images"
|
||
],
|
||
"operationId": "generateExternalEditorIconSpritesheet",
|
||
"summary": "按规范图生成图标 spritesheet 并尝试拆分",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"requestBody": {
|
||
"required": true,
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/EditorIconSpritesheetGenerationRequest"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "图标 spritesheet、实际切片结果、可选非阻断告警与落库资源",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/EditorIconSpritesheetGenerationResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"$ref": "#/components/responses/BadRequest"
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
},
|
||
"502": {
|
||
"$ref": "#/components/responses/UpstreamError"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/external/v1/editor/ui-designs/assets/extractions": {
|
||
"post": {
|
||
"tags": [
|
||
"Editor Images"
|
||
],
|
||
"operationId": "extractExternalEditorUiDesignAssets",
|
||
"summary": "从 UI 设计图生成素材 spritesheet 并尝试拆分",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"requestBody": {
|
||
"required": true,
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/EditorUiDesignAssetExtractionRequest"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "UI 设计图素材 spritesheet、实际切片结果、可选非阻断告警与落库资源",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/EditorIconSpritesheetGenerationResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"$ref": "#/components/responses/BadRequest"
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
},
|
||
"502": {
|
||
"$ref": "#/components/responses/UpstreamError"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/external/v1/editor/character-animations/generations": {
|
||
"post": {
|
||
"tags": [
|
||
"Editor Videos"
|
||
],
|
||
"operationId": "generateExternalEditorCharacterAnimation",
|
||
"summary": "生成编辑器角色动画帧",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"requestBody": {
|
||
"required": true,
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/EditorCharacterAnimationGenerationRequest"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "角色动画视频预览与抽帧结果",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/EditorCharacterAnimationGenerationResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"$ref": "#/components/responses/BadRequest"
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
},
|
||
"502": {
|
||
"$ref": "#/components/responses/UpstreamError"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/external/v1/editor/videos/generations": {
|
||
"post": {
|
||
"tags": [
|
||
"Editor Videos"
|
||
],
|
||
"operationId": "generateExternalEditorVideo",
|
||
"summary": "生成编辑器视频素材",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"requestBody": {
|
||
"required": true,
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/EditorVideoGenerationRequest"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "视频生成结果",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/EditorVideoGenerationResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"$ref": "#/components/responses/BadRequest"
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
},
|
||
"502": {
|
||
"$ref": "#/components/responses/UpstreamError"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/external/v1/editor/audios/sound-effects/generations": {
|
||
"post": {
|
||
"tags": [
|
||
"Editor Audio"
|
||
],
|
||
"operationId": "generateExternalEditorSoundEffect",
|
||
"summary": "生成编辑器音效素材",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"requestBody": {
|
||
"required": true,
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/EditorSoundEffectGenerationRequest"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "音效生成结果",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/EditorAudioGenerationResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"$ref": "#/components/responses/BadRequest"
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
},
|
||
"502": {
|
||
"$ref": "#/components/responses/UpstreamError"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"/api/external/v1/editor/audios/background-music/generations": {
|
||
"post": {
|
||
"tags": [
|
||
"Editor Audio"
|
||
],
|
||
"operationId": "generateExternalEditorBackgroundMusic",
|
||
"summary": "生成编辑器背景音乐素材",
|
||
"security": [
|
||
{
|
||
"ExternalApiKey": []
|
||
}
|
||
],
|
||
"requestBody": {
|
||
"required": true,
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/EditorBackgroundMusicGenerationRequest"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "背景音乐生成结果",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/EditorAudioGenerationResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"400": {
|
||
"$ref": "#/components/responses/BadRequest"
|
||
},
|
||
"401": {
|
||
"$ref": "#/components/responses/Unauthorized"
|
||
},
|
||
"403": {
|
||
"$ref": "#/components/responses/Forbidden"
|
||
},
|
||
"502": {
|
||
"$ref": "#/components/responses/UpstreamError"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"components": {
|
||
"securitySchemes": {
|
||
"ExternalApiKey": {
|
||
"type": "http",
|
||
"scheme": "bearer",
|
||
"bearerFormat": "tnr_sk"
|
||
}
|
||
},
|
||
"parameters": {
|
||
"ProjectId": {
|
||
"name": "projectId",
|
||
"in": "path",
|
||
"required": true,
|
||
"schema": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"FolderId": {
|
||
"name": "folderId",
|
||
"in": "path",
|
||
"required": true,
|
||
"schema": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"AssetId": {
|
||
"name": "assetId",
|
||
"in": "path",
|
||
"required": true,
|
||
"schema": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"BadRequest": {
|
||
"description": "请求参数不合法",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"Unauthorized": {
|
||
"description": "未授权访问",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"Forbidden": {
|
||
"description": "禁止访问",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"NotFound": {
|
||
"description": "资源不存在",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"Conflict": {
|
||
"description": "画布 revision 冲突，需重新读取最新快照后合并或重试",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"UpstreamError": {
|
||
"description": "上游生成服务失败",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"schemas": {
|
||
"ExternalEditorProjectCreateRequest": {
|
||
"type": "object",
|
||
"properties": {
|
||
"title": {
|
||
"type": "string",
|
||
"maxLength": 80
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"CreateDirectUploadTicketRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"legacyPrefix",
|
||
"fileName"
|
||
],
|
||
"properties": {
|
||
"legacyPrefix": {
|
||
"type": "string",
|
||
"description": "历史资源前缀，例如 generated-character-drafts。"
|
||
},
|
||
"pathSegments": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"fileName": {
|
||
"type": "string"
|
||
},
|
||
"contentType": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"access": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"enum": [
|
||
"public",
|
||
"private",
|
||
null
|
||
],
|
||
"default": "private"
|
||
},
|
||
"metadata": {
|
||
"type": "object",
|
||
"additionalProperties": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"maxSizeBytes": {
|
||
"type": [
|
||
"integer",
|
||
"null"
|
||
],
|
||
"minimum": 1
|
||
},
|
||
"expireSeconds": {
|
||
"type": [
|
||
"integer",
|
||
"null"
|
||
],
|
||
"minimum": 1
|
||
},
|
||
"successActionStatus": {
|
||
"type": [
|
||
"integer",
|
||
"null"
|
||
],
|
||
"enum": [
|
||
200,
|
||
201,
|
||
204,
|
||
null
|
||
]
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"CreateDirectUploadTicketResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"upload"
|
||
],
|
||
"properties": {
|
||
"upload": {
|
||
"$ref": "#/components/schemas/DirectUploadTicket"
|
||
}
|
||
}
|
||
},
|
||
"DirectUploadTicket": {
|
||
"type": "object",
|
||
"required": [
|
||
"signatureVersion",
|
||
"provider",
|
||
"bucket",
|
||
"endpoint",
|
||
"host",
|
||
"objectKey",
|
||
"legacyPublicPath",
|
||
"access",
|
||
"keyPrefix",
|
||
"expiresAt",
|
||
"maxSizeBytes",
|
||
"successActionStatus",
|
||
"formFields"
|
||
],
|
||
"properties": {
|
||
"signatureVersion": {
|
||
"type": "string"
|
||
},
|
||
"provider": {
|
||
"type": "string"
|
||
},
|
||
"bucket": {
|
||
"type": "string"
|
||
},
|
||
"endpoint": {
|
||
"type": "string"
|
||
},
|
||
"host": {
|
||
"type": "string"
|
||
},
|
||
"objectKey": {
|
||
"type": "string"
|
||
},
|
||
"legacyPublicPath": {
|
||
"type": "string"
|
||
},
|
||
"contentType": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"access": {
|
||
"type": "string",
|
||
"enum": [
|
||
"public",
|
||
"private"
|
||
]
|
||
},
|
||
"keyPrefix": {
|
||
"type": "string"
|
||
},
|
||
"expiresAt": {
|
||
"type": "string",
|
||
"format": "date-time"
|
||
},
|
||
"maxSizeBytes": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"successActionStatus": {
|
||
"type": "integer"
|
||
},
|
||
"formFields": {
|
||
"type": "object",
|
||
"additionalProperties": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"ConfirmAssetObjectRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"objectKey",
|
||
"assetKind"
|
||
],
|
||
"properties": {
|
||
"bucket": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"objectKey": {
|
||
"type": "string"
|
||
},
|
||
"contentType": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"contentLength": {
|
||
"type": [
|
||
"integer",
|
||
"null"
|
||
],
|
||
"minimum": 0
|
||
},
|
||
"contentHash": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"assetKind": {
|
||
"type": "string"
|
||
},
|
||
"accessPolicy": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"enum": [
|
||
"private",
|
||
"public_read",
|
||
null
|
||
],
|
||
"default": "private"
|
||
},
|
||
"sourceJobId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"ownerUserId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"deprecated": true,
|
||
"description": "外部接口会忽略该字段并使用 API Key 所属账号。"
|
||
},
|
||
"profileId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"entityId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"ConfirmAssetObjectResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"assetObject"
|
||
],
|
||
"properties": {
|
||
"assetObject": {
|
||
"$ref": "#/components/schemas/AssetObject"
|
||
}
|
||
}
|
||
},
|
||
"AssetObject": {
|
||
"type": "object",
|
||
"required": [
|
||
"assetObjectId",
|
||
"bucket",
|
||
"objectKey",
|
||
"accessPolicy",
|
||
"contentLength",
|
||
"version",
|
||
"assetKind",
|
||
"createdAt",
|
||
"updatedAt"
|
||
],
|
||
"properties": {
|
||
"assetObjectId": {
|
||
"type": "string"
|
||
},
|
||
"bucket": {
|
||
"type": "string"
|
||
},
|
||
"objectKey": {
|
||
"type": "string"
|
||
},
|
||
"accessPolicy": {
|
||
"type": "string"
|
||
},
|
||
"contentType": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"contentLength": {
|
||
"type": "integer",
|
||
"minimum": 0
|
||
},
|
||
"contentHash": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"version": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"sourceJobId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"ownerUserId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"profileId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"entityId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"assetKind": {
|
||
"type": "string"
|
||
},
|
||
"createdAt": {
|
||
"type": "string",
|
||
"format": "date-time"
|
||
},
|
||
"updatedAt": {
|
||
"type": "string",
|
||
"format": "date-time"
|
||
}
|
||
}
|
||
},
|
||
"GetAssetReadUrlResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"read"
|
||
],
|
||
"properties": {
|
||
"read": {
|
||
"$ref": "#/components/schemas/AssetReadUrl"
|
||
}
|
||
}
|
||
},
|
||
"AssetReadUrl": {
|
||
"type": "object",
|
||
"required": [
|
||
"provider",
|
||
"bucket",
|
||
"endpoint",
|
||
"host",
|
||
"objectKey",
|
||
"expiresAt",
|
||
"signedUrl"
|
||
],
|
||
"properties": {
|
||
"provider": {
|
||
"type": "string"
|
||
},
|
||
"bucket": {
|
||
"type": "string"
|
||
},
|
||
"endpoint": {
|
||
"type": "string"
|
||
},
|
||
"host": {
|
||
"type": "string"
|
||
},
|
||
"objectKey": {
|
||
"type": "string"
|
||
},
|
||
"expiresAt": {
|
||
"type": "string",
|
||
"format": "date-time"
|
||
},
|
||
"signedUrl": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"ExternalEditorProjectRenameRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"title"
|
||
],
|
||
"properties": {
|
||
"title": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 80
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"ExternalEditorCanvasSaveRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"viewport",
|
||
"layers"
|
||
],
|
||
"properties": {
|
||
"viewport": {
|
||
"$ref": "#/components/schemas/EditorCanvasViewport"
|
||
},
|
||
"layers": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "object",
|
||
"additionalProperties": true
|
||
},
|
||
"description": "兼容画布布局 JSON，最大 2 MiB；服务端会拆分为结构化图层与生成对话框行。"
|
||
},
|
||
"expectedRevision": {
|
||
"type": "integer",
|
||
"minimum": 0,
|
||
"description": "可选的画布 revision CAS；不匹配时返回 409。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"ExternalEditorAssetFolderCreateRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"label"
|
||
],
|
||
"properties": {
|
||
"label": {
|
||
"type": "string"
|
||
},
|
||
"sortOrder": {
|
||
"type": "integer",
|
||
"minimum": 0,
|
||
"default": 100
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"ExternalEditorAssetFolderUpdateRequest": {
|
||
"type": "object",
|
||
"properties": {
|
||
"label": {
|
||
"type": "string"
|
||
},
|
||
"collapsed": {
|
||
"type": "boolean"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"ExternalEditorAssetCreateRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"folderId",
|
||
"label",
|
||
"imageSrc",
|
||
"width",
|
||
"height",
|
||
"sourceType"
|
||
],
|
||
"properties": {
|
||
"folderId": {
|
||
"type": "string"
|
||
},
|
||
"label": {
|
||
"type": "string"
|
||
},
|
||
"imageSrc": {
|
||
"type": "string"
|
||
},
|
||
"thumbnailSrc": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"objectKey": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"assetObjectId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"width": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"height": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"sourceType": {
|
||
"type": "string"
|
||
},
|
||
"prompt": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"actualPrompt": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"model": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"provider": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"taskId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"assetKind": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"generationInputs": {
|
||
"$ref": "#/components/schemas/JsonValue"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"ExternalEditorProjectResourceCreateRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"imageSrc",
|
||
"width",
|
||
"height",
|
||
"sourceType"
|
||
],
|
||
"properties": {
|
||
"imageSrc": {
|
||
"type": "string"
|
||
},
|
||
"objectKey": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"assetObjectId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"width": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"height": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"sourceType": {
|
||
"type": "string"
|
||
},
|
||
"prompt": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"actualPrompt": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"model": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"provider": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"taskId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"sourceResourceId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"assetKind": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"generationInputs": {
|
||
"$ref": "#/components/schemas/JsonValue"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"ExternalEditorAssetUpdateRequest": {
|
||
"type": "object",
|
||
"properties": {
|
||
"label": {
|
||
"type": "string"
|
||
},
|
||
"folderId": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"ExternalEditorProjectResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"project"
|
||
],
|
||
"properties": {
|
||
"project": {
|
||
"$ref": "#/components/schemas/EditorProject"
|
||
}
|
||
}
|
||
},
|
||
"ExternalEditorProjectRecentResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"project"
|
||
],
|
||
"properties": {
|
||
"project": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorProject"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
]
|
||
}
|
||
}
|
||
},
|
||
"ExternalEditorProjectListResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"projects"
|
||
],
|
||
"properties": {
|
||
"projects": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/components/schemas/EditorProject"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"ExternalEditorProjectDeleteResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"deletedProjectId"
|
||
],
|
||
"properties": {
|
||
"deletedProjectId": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"ExternalEditorAssetLibraryResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"library"
|
||
],
|
||
"properties": {
|
||
"library": {
|
||
"$ref": "#/components/schemas/EditorAssetLibrary"
|
||
}
|
||
}
|
||
},
|
||
"ExternalEditorAssetFolderResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"folder"
|
||
],
|
||
"properties": {
|
||
"folder": {
|
||
"$ref": "#/components/schemas/EditorAssetFolder"
|
||
}
|
||
}
|
||
},
|
||
"ExternalEditorAssetFolderDeleteResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"library"
|
||
],
|
||
"properties": {
|
||
"library": {
|
||
"$ref": "#/components/schemas/EditorAssetLibrary"
|
||
}
|
||
}
|
||
},
|
||
"ExternalEditorAssetResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"asset"
|
||
],
|
||
"properties": {
|
||
"asset": {
|
||
"$ref": "#/components/schemas/EditorAsset"
|
||
}
|
||
}
|
||
},
|
||
"ExternalEditorProjectResourceResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"resource"
|
||
],
|
||
"properties": {
|
||
"resource": {
|
||
"$ref": "#/components/schemas/EditorProjectResource"
|
||
}
|
||
}
|
||
},
|
||
"EditorProject": {
|
||
"type": "object",
|
||
"required": [
|
||
"projectId",
|
||
"title",
|
||
"canvas",
|
||
"viewport",
|
||
"layers",
|
||
"resources",
|
||
"updatedAt"
|
||
],
|
||
"properties": {
|
||
"projectId": {
|
||
"type": "string"
|
||
},
|
||
"title": {
|
||
"type": "string"
|
||
},
|
||
"canvas": {
|
||
"$ref": "#/components/schemas/EditorCanvas"
|
||
},
|
||
"viewport": {
|
||
"$ref": "#/components/schemas/EditorCanvasViewport"
|
||
},
|
||
"layers": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "object",
|
||
"additionalProperties": true
|
||
}
|
||
},
|
||
"resources": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/components/schemas/EditorProjectResource"
|
||
}
|
||
},
|
||
"updatedAt": {
|
||
"type": "string",
|
||
"format": "date-time"
|
||
}
|
||
}
|
||
},
|
||
"EditorCanvas": {
|
||
"type": "object",
|
||
"required": [
|
||
"canvasId",
|
||
"projectId",
|
||
"title",
|
||
"viewport",
|
||
"layers",
|
||
"revision",
|
||
"layoutStorageVersion",
|
||
"createdAt",
|
||
"updatedAt"
|
||
],
|
||
"properties": {
|
||
"canvasId": {
|
||
"type": "string"
|
||
},
|
||
"projectId": {
|
||
"type": "string"
|
||
},
|
||
"title": {
|
||
"type": "string"
|
||
},
|
||
"viewport": {
|
||
"$ref": "#/components/schemas/EditorCanvasViewport"
|
||
},
|
||
"layers": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "object",
|
||
"additionalProperties": true
|
||
}
|
||
},
|
||
"revision": {
|
||
"type": "integer",
|
||
"minimum": 0
|
||
},
|
||
"layoutStorageVersion": {
|
||
"type": "integer",
|
||
"minimum": 0
|
||
},
|
||
"backgroundColor": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"createdAt": {
|
||
"type": "string",
|
||
"format": "date-time"
|
||
},
|
||
"updatedAt": {
|
||
"type": "string",
|
||
"format": "date-time"
|
||
}
|
||
}
|
||
},
|
||
"EditorCanvasViewport": {
|
||
"type": "object",
|
||
"required": [
|
||
"x",
|
||
"y",
|
||
"scale"
|
||
],
|
||
"properties": {
|
||
"x": {
|
||
"type": "number"
|
||
},
|
||
"y": {
|
||
"type": "number"
|
||
},
|
||
"scale": {
|
||
"type": "number",
|
||
"minimum": 0.01,
|
||
"maximum": 8
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"EditorProjectResource": {
|
||
"type": "object",
|
||
"required": [
|
||
"resourceId",
|
||
"projectId",
|
||
"imageSrc",
|
||
"width",
|
||
"height",
|
||
"sourceType",
|
||
"createdAt",
|
||
"updatedAt"
|
||
],
|
||
"properties": {
|
||
"resourceId": {
|
||
"type": "string"
|
||
},
|
||
"projectId": {
|
||
"type": "string"
|
||
},
|
||
"imageSrc": {
|
||
"type": "string"
|
||
},
|
||
"objectKey": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"assetObjectId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"width": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"height": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"sourceType": {
|
||
"type": "string"
|
||
},
|
||
"prompt": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"actualPrompt": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"model": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"provider": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"taskId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"sourceResourceId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"assetKind": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"generationInputs": {
|
||
"$ref": "#/components/schemas/JsonValue"
|
||
},
|
||
"createdAt": {
|
||
"type": "string",
|
||
"format": "date-time"
|
||
},
|
||
"updatedAt": {
|
||
"type": "string",
|
||
"format": "date-time"
|
||
},
|
||
"ownerUserId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"authorDisplayName": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"authorPublicUserCode": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"publicShowcaseEnabled": {
|
||
"type": "boolean"
|
||
}
|
||
}
|
||
},
|
||
"EditorAssetLibrary": {
|
||
"type": "object",
|
||
"required": [
|
||
"folders",
|
||
"assets"
|
||
],
|
||
"properties": {
|
||
"folders": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/components/schemas/EditorAssetFolder"
|
||
}
|
||
},
|
||
"assets": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/components/schemas/EditorAsset"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"EditorAssetFolder": {
|
||
"type": "object",
|
||
"required": [
|
||
"folderId",
|
||
"label",
|
||
"sortOrder",
|
||
"collapsed",
|
||
"systemDefault",
|
||
"createdAt",
|
||
"updatedAt"
|
||
],
|
||
"properties": {
|
||
"folderId": {
|
||
"type": "string"
|
||
},
|
||
"label": {
|
||
"type": "string"
|
||
},
|
||
"sortOrder": {
|
||
"type": "integer"
|
||
},
|
||
"collapsed": {
|
||
"type": "boolean"
|
||
},
|
||
"systemDefault": {
|
||
"type": "boolean"
|
||
},
|
||
"createdAt": {
|
||
"type": "string",
|
||
"format": "date-time"
|
||
},
|
||
"updatedAt": {
|
||
"type": "string",
|
||
"format": "date-time"
|
||
}
|
||
}
|
||
},
|
||
"EditorAsset": {
|
||
"type": "object",
|
||
"required": [
|
||
"assetId",
|
||
"folderId",
|
||
"label",
|
||
"imageSrc",
|
||
"width",
|
||
"height",
|
||
"sourceType",
|
||
"createdAt",
|
||
"updatedAt"
|
||
],
|
||
"properties": {
|
||
"assetId": {
|
||
"type": "string"
|
||
},
|
||
"folderId": {
|
||
"type": "string"
|
||
},
|
||
"label": {
|
||
"type": "string"
|
||
},
|
||
"imageSrc": {
|
||
"type": "string"
|
||
},
|
||
"objectKey": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"assetObjectId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"width": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"height": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"sourceType": {
|
||
"type": "string"
|
||
},
|
||
"prompt": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"actualPrompt": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"model": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"provider": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"taskId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"assetKind": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"generationInputs": {
|
||
"$ref": "#/components/schemas/JsonValue"
|
||
},
|
||
"createdAt": {
|
||
"type": "string",
|
||
"format": "date-time"
|
||
},
|
||
"updatedAt": {
|
||
"type": "string",
|
||
"format": "date-time"
|
||
},
|
||
"thumbnailSrc": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"sourceResourceId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"publicShowcaseEnabled": {
|
||
"type": [
|
||
"boolean",
|
||
"null"
|
||
]
|
||
}
|
||
}
|
||
},
|
||
"JsonValue": {
|
||
"description": "任意 JSON 值。"
|
||
},
|
||
"ErrorResponse": {
|
||
"type": "object",
|
||
"properties": {
|
||
"code": {
|
||
"type": "string"
|
||
},
|
||
"message": {
|
||
"type": "string"
|
||
},
|
||
"details": {
|
||
"type": [
|
||
"object",
|
||
"null"
|
||
]
|
||
}
|
||
}
|
||
},
|
||
"EditorImageGenerationRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"prompt"
|
||
],
|
||
"properties": {
|
||
"prompt": {
|
||
"type": "string",
|
||
"minLength": 1
|
||
},
|
||
"screenColor": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"description": "纯色抠像背景色。可传画布支持的纯色背景 hex（如 #CFEFFF）指定；传 \"auto\"、null 或省略则由服务端自动决策。"
|
||
},
|
||
"size": {
|
||
"type": "string",
|
||
"description": "兼容旧 size 入参；未传 aspectRatio/imageSize 时生效。",
|
||
"enum": [
|
||
"1024x1024",
|
||
"1536x1024",
|
||
"1024x1536",
|
||
"2048x1152",
|
||
"2048x2048",
|
||
"2k-16:9",
|
||
"1:1",
|
||
"16:9",
|
||
"9:16"
|
||
]
|
||
},
|
||
"kind": {
|
||
"type": "string",
|
||
"enum": [
|
||
"spec",
|
||
"character",
|
||
"quick-edit",
|
||
"ui-design",
|
||
"publication-material"
|
||
],
|
||
"default": "spec"
|
||
},
|
||
"model": {
|
||
"type": "string",
|
||
"description": "支持 gpt-image-2、gemini-3.1-flash-image-preview、nanobanana2、nano-banana。未传时沿用编辑器默认。"
|
||
},
|
||
"aspectRatio": {
|
||
"type": "string",
|
||
"enum": [
|
||
"1:1",
|
||
"2:3",
|
||
"3:2",
|
||
"9:16",
|
||
"16:9"
|
||
],
|
||
"default": "1:1"
|
||
},
|
||
"imageSize": {
|
||
"type": "string",
|
||
"enum": [
|
||
"0.5K",
|
||
"1K",
|
||
"2K"
|
||
],
|
||
"default": "1K"
|
||
},
|
||
"referenceImageSrcs": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "string",
|
||
"description": "当前账号的 objectKey、项目资源 ID 或素材 ID；本地临时图必须先上传 OSS 再提交。禁止 Data URL / Blob URL。普通生成最多使用前 5 张，数组上限为 9。"
|
||
},
|
||
"maxItems": 9
|
||
},
|
||
"projectId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"assetKind": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"generationInputs": {
|
||
"$ref": "#/components/schemas/JsonValue"
|
||
},
|
||
"assetFolderId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"description": "传 project 时写入默认项目素材文件夹；传具体 folderId 时写入该文件夹。"
|
||
},
|
||
"assetLabel": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"description": "写入素材库时使用的素材名称。"
|
||
},
|
||
"sourceResourceId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"canvasCompletion": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorCanvasGenerationCompletion"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
],
|
||
"description": "带项目上下文生成时，服务端据此直接写入画布完成态并返回最新项目快照。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"EditorCanvasGenerationCompletion": {
|
||
"type": "object",
|
||
"required": [
|
||
"title",
|
||
"placeholder"
|
||
],
|
||
"properties": {
|
||
"dialogId": {
|
||
"type": "string",
|
||
"minLength": 1
|
||
},
|
||
"title": {
|
||
"type": "string"
|
||
},
|
||
"placeholder": {
|
||
"$ref": "#/components/schemas/EditorCanvasGenerationPlaceholder"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"EditorCanvasGenerationPlaceholder": {
|
||
"type": "object",
|
||
"required": [
|
||
"x",
|
||
"y",
|
||
"width",
|
||
"height",
|
||
"originalWidth",
|
||
"originalHeight"
|
||
],
|
||
"properties": {
|
||
"x": {
|
||
"type": "number"
|
||
},
|
||
"y": {
|
||
"type": "number"
|
||
},
|
||
"width": {
|
||
"type": "number",
|
||
"minimum": 1
|
||
},
|
||
"height": {
|
||
"type": "number",
|
||
"minimum": 1
|
||
},
|
||
"originalWidth": {
|
||
"type": "number",
|
||
"minimum": 1
|
||
},
|
||
"originalHeight": {
|
||
"type": "number",
|
||
"minimum": 1
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"EditorImageEditRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"prompt",
|
||
"sourceImageSrc"
|
||
],
|
||
"properties": {
|
||
"prompt": {
|
||
"type": "string",
|
||
"minLength": 1
|
||
},
|
||
"sourceImageSrc": {
|
||
"type": "string",
|
||
"description": "待重绘/调整图片的稳定引用：当前账号的 objectKey、项目资源 ID 或素材 ID；本地临时图必须先上传 OSS。禁止 Data URL / Blob URL。"
|
||
},
|
||
"projectId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"assetKind": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"generationInputs": {
|
||
"$ref": "#/components/schemas/JsonValue"
|
||
},
|
||
"assetFolderId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"assetLabel": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"sourceResourceId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"targetLayerId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"description": "带 projectId 且未提供 canvasCompletion 时，服务端用生成结果替换该画布图层。"
|
||
},
|
||
"size": {
|
||
"type": "string"
|
||
},
|
||
"model": {
|
||
"type": "string",
|
||
"description": "支持 gpt-image-2、gemini-3.1-flash-image-preview、nanobanana2、nano-banana。"
|
||
},
|
||
"aspectRatio": {
|
||
"type": "string",
|
||
"enum": [
|
||
"1:1",
|
||
"4:3",
|
||
"3:2",
|
||
"2:3",
|
||
"9:16",
|
||
"16:9"
|
||
]
|
||
},
|
||
"imageSize": {
|
||
"type": "string",
|
||
"enum": [
|
||
"0.5K",
|
||
"1K",
|
||
"2K"
|
||
]
|
||
},
|
||
"referenceImageSrcs": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "string",
|
||
"description": "当前账号的 objectKey、项目资源 ID 或素材 ID；本地临时图必须先上传 OSS。禁止 Data URL / Blob URL。"
|
||
},
|
||
"maxItems": 8
|
||
},
|
||
"canvasCompletion": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorCanvasGenerationCompletion"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
],
|
||
"description": "带项目上下文生成时，服务端据此直接写入画布完成态并返回最新项目快照。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"EditorImageGenerationResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"imageSrc",
|
||
"width",
|
||
"height",
|
||
"sourceType",
|
||
"prompt",
|
||
"model",
|
||
"provider",
|
||
"taskId"
|
||
],
|
||
"properties": {
|
||
"imageSrc": {
|
||
"type": "string"
|
||
},
|
||
"objectKey": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"assetObjectId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"width": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"height": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"sourceType": {
|
||
"type": "string",
|
||
"const": "generated"
|
||
},
|
||
"prompt": {
|
||
"type": "string"
|
||
},
|
||
"actualPrompt": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"model": {
|
||
"type": "string"
|
||
},
|
||
"provider": {
|
||
"type": "string"
|
||
},
|
||
"taskId": {
|
||
"type": "string"
|
||
},
|
||
"resource": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorProjectResource"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
]
|
||
},
|
||
"asset": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorAsset"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
]
|
||
},
|
||
"project": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorProject"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
],
|
||
"description": "当请求携带 canvasCompletion 且服务端成功写入画布布局时返回最新项目快照。"
|
||
},
|
||
"warning": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorGenerationWarning"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
],
|
||
"description": "生成成功但后处理降级时返回的非阻断告警。"
|
||
}
|
||
}
|
||
},
|
||
"EditorIconSpritesheetGenerationRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"referenceImageSrc",
|
||
"iconDescriptions"
|
||
],
|
||
"properties": {
|
||
"referenceImageSrc": {
|
||
"type": "string",
|
||
"description": "图标规范的稳定引用：当前账号的 objectKey、项目资源 ID 或素材 ID；本地临时图必须先上传 OSS。禁止 Data URL / Blob URL。"
|
||
},
|
||
"referenceImageSrcs": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "string",
|
||
"description": "额外图标素材参考图的稳定引用：objectKey、项目资源 ID 或素材 ID；本地临时图必须先上传 OSS。禁止 Data URL / Blob URL。最多 8 张。"
|
||
},
|
||
"maxItems": 8
|
||
},
|
||
"iconDescriptions": {
|
||
"type": "array",
|
||
"minItems": 1,
|
||
"maxItems": 100,
|
||
"items": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"screenColor": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"description": "纯色抠像背景色。可传画布支持的纯色背景 hex（如 #CFEFFF）指定；传 \"auto\"、null 或省略则由服务端自动决策。"
|
||
},
|
||
"model": {
|
||
"type": "string",
|
||
"default": "gemini-3.1-flash-image-preview"
|
||
},
|
||
"aspectRatio": {
|
||
"type": "string",
|
||
"enum": [
|
||
"1:1",
|
||
"2:3",
|
||
"3:2",
|
||
"9:16",
|
||
"16:9"
|
||
],
|
||
"default": "1:1"
|
||
},
|
||
"imageSize": {
|
||
"type": "string",
|
||
"enum": [
|
||
"0.5K",
|
||
"1K",
|
||
"2K"
|
||
],
|
||
"default": "1K"
|
||
},
|
||
"projectId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"generationInputs": {
|
||
"$ref": "#/components/schemas/JsonValue"
|
||
},
|
||
"assetFolderId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"assetLabel": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"maxLength": 80,
|
||
"description": "写入素材库时使用的图标图集名称；空白或省略时使用自动名称。"
|
||
},
|
||
"canvasCompletion": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorCanvasGenerationCompletion"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
],
|
||
"description": "带项目上下文生成时，服务端据此直接写入画布完成态并返回最新项目快照。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"EditorUiDesignAssetExtractionRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"sourceImageSrc",
|
||
"aspectRatio",
|
||
"imageSize"
|
||
],
|
||
"properties": {
|
||
"sourceImageSrc": {
|
||
"type": "string",
|
||
"description": "带红框标注的 UI 设计图稳定引用：当前账号的 objectKey、项目资源 ID 或素材 ID；浏览器内合成后必须先上传 OSS 再提交。禁止 Data URL / Blob URL。"
|
||
},
|
||
"screenColor": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"description": "纯色抠像背景色。可传画布支持的纯色背景 hex（如 #CFEFFF）指定；传 \"auto\"、null 或省略则由服务端自动决策。"
|
||
},
|
||
"model": {
|
||
"type": "string",
|
||
"default": "gemini-3.1-flash-image-preview",
|
||
"description": "支持 gpt-image-2、gemini-3.1-flash-image-preview、nanobanana2、nano-banana。未传时默认使用 nanobanana。"
|
||
},
|
||
"referenceImageSrcs": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "string",
|
||
"description": "额外 UI 素材参考图的稳定引用：objectKey、项目资源 ID 或素材 ID；本地临时图必须先上传 OSS。禁止 Data URL / Blob URL。最多 5 张。"
|
||
},
|
||
"maxItems": 5
|
||
},
|
||
"aspectRatio": {
|
||
"type": "string",
|
||
"const": "1:1",
|
||
"description": "UI 素材提取固定使用 1:1。"
|
||
},
|
||
"imageSize": {
|
||
"type": "string",
|
||
"enum": [
|
||
"1K",
|
||
"2K"
|
||
],
|
||
"description": "框选数量少时使用 1K，超过阈值时使用 2K。"
|
||
},
|
||
"projectId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"generationInputs": {
|
||
"$ref": "#/components/schemas/JsonValue"
|
||
},
|
||
"assetFolderId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"spritesheetLabel": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"canvasCompletion": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorCanvasGenerationCompletion"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
],
|
||
"description": "带项目上下文生成时，服务端据此直接写入画布完成态并返回最新项目快照。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"EditorIconSpritesheetIconResult": {
|
||
"type": "object",
|
||
"required": [
|
||
"name",
|
||
"imageSrc",
|
||
"width",
|
||
"height"
|
||
],
|
||
"properties": {
|
||
"name": {
|
||
"type": "string"
|
||
},
|
||
"imageSrc": {
|
||
"type": "string"
|
||
},
|
||
"width": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"height": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"resource": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorProjectResource"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
]
|
||
},
|
||
"asset": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorAsset"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
]
|
||
}
|
||
}
|
||
},
|
||
"EditorIconSpritesheetSliceWarning": {
|
||
"type": "object",
|
||
"required": [
|
||
"code",
|
||
"reason"
|
||
],
|
||
"properties": {
|
||
"code": {
|
||
"type": "string",
|
||
"description": "自动拆分未完成的稳定原因码。"
|
||
},
|
||
"reason": {
|
||
"type": "string",
|
||
"description": "自动拆分未完成的可诊断原因。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"EditorGenerationWarning": {
|
||
"type": "object",
|
||
"required": [
|
||
"code",
|
||
"reason"
|
||
],
|
||
"properties": {
|
||
"code": {
|
||
"type": "string",
|
||
"const": "postprocess-failed-source-preserved",
|
||
"description": "透明背景处理最终失败并保留 provider 原图时的稳定原因码。"
|
||
},
|
||
"reason": {
|
||
"type": "string",
|
||
"description": "可直接展示给调用方的非阻断告警原因。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"EditorIconSpritesheetGenerationResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"spritesheetImageSrc",
|
||
"spritesheetWidth",
|
||
"spritesheetHeight",
|
||
"prompt",
|
||
"model",
|
||
"provider",
|
||
"taskId",
|
||
"priceMudPoints"
|
||
],
|
||
"properties": {
|
||
"spritesheetImageSrc": {
|
||
"type": "string"
|
||
},
|
||
"spritesheetWidth": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"spritesheetHeight": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"iconImageSrcs": {
|
||
"type": "array",
|
||
"description": "按图集 alpha 连通域拆分并持久化的独立素材列表。",
|
||
"items": {
|
||
"$ref": "#/components/schemas/EditorIconSpritesheetIconResult"
|
||
}
|
||
},
|
||
"sliceWarning": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorIconSpritesheetSliceWarning"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
],
|
||
"description": "图集已成功持久化，但自动拆分未完成时返回；此时 iconImageSrcs 为空，调用方仍应使用整张图集。与通用 warning 互斥。"
|
||
},
|
||
"prompt": {
|
||
"type": "string"
|
||
},
|
||
"actualPrompt": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"model": {
|
||
"type": "string"
|
||
},
|
||
"provider": {
|
||
"type": "string"
|
||
},
|
||
"taskId": {
|
||
"type": "string"
|
||
},
|
||
"priceMudPoints": {
|
||
"type": "integer",
|
||
"minimum": 0
|
||
},
|
||
"spritesheetResource": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorProjectResource"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
]
|
||
},
|
||
"spritesheetAsset": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorAsset"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
]
|
||
},
|
||
"project": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorProject"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
],
|
||
"description": "当请求携带 canvasCompletion 且服务端成功写入画布布局时返回最新项目快照。"
|
||
},
|
||
"warning": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorGenerationWarning"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
],
|
||
"description": "透明背景处理最终失败、provider 原图作为主结果时返回的非阻断告警。与 sliceWarning 互斥。"
|
||
}
|
||
},
|
||
"not": {
|
||
"required": [
|
||
"warning",
|
||
"sliceWarning"
|
||
]
|
||
}
|
||
},
|
||
"EditorCharacterAnimationGenerationRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"sourceLayerId",
|
||
"sourceImageSrc",
|
||
"sourceWidth",
|
||
"sourceHeight",
|
||
"promptText",
|
||
"resolution",
|
||
"ratio",
|
||
"frameCount",
|
||
"durationSeconds",
|
||
"model"
|
||
],
|
||
"properties": {
|
||
"sourceLayerId": {
|
||
"type": "string"
|
||
},
|
||
"sourceImageSrc": {
|
||
"type": "string",
|
||
"description": "角色源图的稳定引用：当前账号的 objectKey、项目资源 ID 或素材 ID；本地临时图必须先上传 OSS。禁止 Data URL / Blob URL。"
|
||
},
|
||
"sourceWidth": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"sourceHeight": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"promptText": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 4000
|
||
},
|
||
"screenColor": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"description": "纯色抠像背景色。可传画布支持的纯色背景 hex（如 #CFEFFF）指定；传 \"auto\"、null 或省略则由服务端自动决策。"
|
||
},
|
||
"resolution": {
|
||
"type": "string",
|
||
"enum": [
|
||
"480p",
|
||
"720p"
|
||
],
|
||
"default": "480p"
|
||
},
|
||
"ratio": {
|
||
"type": "string",
|
||
"enum": [
|
||
"same",
|
||
"1:1",
|
||
"4:3",
|
||
"16:9",
|
||
"9:16",
|
||
"3:4"
|
||
],
|
||
"default": "same"
|
||
},
|
||
"frameCount": {
|
||
"type": "integer",
|
||
"enum": [
|
||
32,
|
||
40,
|
||
48
|
||
]
|
||
},
|
||
"durationSeconds": {
|
||
"type": "integer",
|
||
"enum": [
|
||
4,
|
||
5,
|
||
6
|
||
]
|
||
},
|
||
"model": {
|
||
"type": "string",
|
||
"const": "seedance2.0-fast"
|
||
},
|
||
"projectId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"canvasCompletion": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorCanvasGenerationCompletion"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
],
|
||
"description": "带项目上下文生成时，服务端据此直接写入画布完成态并返回最新项目快照。"
|
||
},
|
||
"generationInputs": {
|
||
"$ref": "#/components/schemas/JsonValue"
|
||
},
|
||
"sourceResourceId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"assetFolderId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"description": "角色动作绿幕预览视频写入账号素材库的文件夹；省略时写入默认项目素材文件夹。"
|
||
},
|
||
"assetLabel": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"maxLength": 80,
|
||
"description": "角色动作素材名称；空白或省略时使用自动名称。原始预览视频以该名称追加（原始视频）保存。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"EditorCharacterAnimationFrame": {
|
||
"type": "object",
|
||
"required": [
|
||
"frameIndex",
|
||
"imageSrc",
|
||
"width",
|
||
"height"
|
||
],
|
||
"properties": {
|
||
"frameIndex": {
|
||
"type": "integer",
|
||
"minimum": 0
|
||
},
|
||
"imageSrc": {
|
||
"type": "string"
|
||
},
|
||
"width": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"height": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
}
|
||
}
|
||
},
|
||
"EditorCharacterAnimationGenerationResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"ok",
|
||
"taskId",
|
||
"model",
|
||
"prompt",
|
||
"previewVideoPath",
|
||
"frames",
|
||
"frameCount",
|
||
"durationSeconds",
|
||
"frameWidth",
|
||
"frameHeight",
|
||
"fps",
|
||
"priceMudPoints"
|
||
],
|
||
"properties": {
|
||
"ok": {
|
||
"type": "boolean"
|
||
},
|
||
"taskId": {
|
||
"type": "string"
|
||
},
|
||
"model": {
|
||
"type": "string"
|
||
},
|
||
"prompt": {
|
||
"type": "string"
|
||
},
|
||
"previewVideoPath": {
|
||
"type": "string"
|
||
},
|
||
"frames": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/components/schemas/EditorCharacterAnimationFrame"
|
||
}
|
||
},
|
||
"frameCount": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"durationSeconds": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"frameWidth": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"frameHeight": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"fps": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"priceMudPoints": {
|
||
"type": "integer",
|
||
"minimum": 0
|
||
},
|
||
"project": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorProject"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
],
|
||
"description": "当请求携带 canvasCompletion 且服务端成功写入画布布局时返回最新项目快照。"
|
||
},
|
||
"queueState": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/ExternalGenerationJobStatusRecord"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
]
|
||
}
|
||
}
|
||
},
|
||
"EditorVideoGenerationRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"prompt",
|
||
"model",
|
||
"aspectRatio",
|
||
"durationSeconds",
|
||
"resolution",
|
||
"mode",
|
||
"sound"
|
||
],
|
||
"properties": {
|
||
"prompt": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 4000
|
||
},
|
||
"model": {
|
||
"type": "string",
|
||
"enum": [
|
||
"seedance2.0",
|
||
"seedance2.0-fast",
|
||
"kling3.0",
|
||
"kling3.0-omni",
|
||
"veo3.1",
|
||
"veo3.1-fast"
|
||
]
|
||
},
|
||
"aspectRatio": {
|
||
"type": "string",
|
||
"enum": [
|
||
"16:9",
|
||
"9:16",
|
||
"1:1",
|
||
"4:3",
|
||
"3:4",
|
||
"21:9"
|
||
]
|
||
},
|
||
"durationSeconds": {
|
||
"type": "integer",
|
||
"minimum": 4,
|
||
"maximum": 15
|
||
},
|
||
"resolution": {
|
||
"type": "string",
|
||
"enum": [
|
||
"480p",
|
||
"720p",
|
||
"1080p"
|
||
]
|
||
},
|
||
"mode": {
|
||
"type": "string",
|
||
"const": "std"
|
||
},
|
||
"sound": {
|
||
"type": "string",
|
||
"enum": [
|
||
"on",
|
||
"off"
|
||
]
|
||
},
|
||
"referenceImageSrcs": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "string",
|
||
"description": "公网 URL、asset://、当前账号的 objectKey、项目资源 ID 或素材 ID。本地临时图必须先上传 OSS。禁止 Data URL / Blob URL。仅 Seedance 2.0 系列支持。"
|
||
},
|
||
"maxItems": 9
|
||
},
|
||
"referenceVideoSrcs": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "string",
|
||
"description": "公网 URL、asset://、当前账号的 objectKey、项目资源 ID 或素材 ID。本地临时视频必须先上传 OSS。禁止 Data URL / Blob URL。仅 Seedance 2.0 系列支持。"
|
||
},
|
||
"maxItems": 3
|
||
},
|
||
"referenceAudioSrcs": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "string",
|
||
"description": "公网 URL、asset://、当前账号的 objectKey、项目资源 ID 或素材 ID。本地临时音频必须先上传 OSS。禁止 Data URL / Blob URL。仅 Seedance 2.0 系列支持。"
|
||
},
|
||
"maxItems": 3
|
||
},
|
||
"webSearchEnabled": {
|
||
"type": "boolean",
|
||
"default": true,
|
||
"description": "是否允许视频模型联网增强提示；未传时默认开启。"
|
||
},
|
||
"projectId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"canvasCompletion": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorCanvasGenerationCompletion"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
],
|
||
"description": "带项目上下文生成时，服务端据此直接写入画布完成态并返回最新项目快照。"
|
||
},
|
||
"generationInputs": {
|
||
"$ref": "#/components/schemas/JsonValue"
|
||
},
|
||
"sourceResourceId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"assetKind": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"assetFolderId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"assetLabel": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"description": "写入素材库时使用的素材名称。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"EditorVideoGenerationResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"ok",
|
||
"videoSrc",
|
||
"width",
|
||
"height",
|
||
"sourceType",
|
||
"prompt",
|
||
"model",
|
||
"provider",
|
||
"taskId",
|
||
"durationSeconds",
|
||
"resolution",
|
||
"priceMudPoints"
|
||
],
|
||
"properties": {
|
||
"ok": {
|
||
"type": "boolean"
|
||
},
|
||
"videoSrc": {
|
||
"type": "string"
|
||
},
|
||
"objectKey": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"assetObjectId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"width": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"height": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"sourceType": {
|
||
"type": "string",
|
||
"const": "generated"
|
||
},
|
||
"prompt": {
|
||
"type": "string"
|
||
},
|
||
"actualPrompt": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"model": {
|
||
"type": "string"
|
||
},
|
||
"provider": {
|
||
"type": "string"
|
||
},
|
||
"taskId": {
|
||
"type": "string"
|
||
},
|
||
"durationSeconds": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"resolution": {
|
||
"type": "string"
|
||
},
|
||
"priceMudPoints": {
|
||
"type": "integer",
|
||
"minimum": 0
|
||
},
|
||
"thumbnailSrc": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"resource": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorProjectResource"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
]
|
||
},
|
||
"asset": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorAsset"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
]
|
||
},
|
||
"project": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorProject"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
],
|
||
"description": "当请求携带 canvasCompletion 且服务端成功写入画布布局时返回最新项目快照。"
|
||
},
|
||
"queueState": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/ExternalGenerationJobStatusRecord"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
]
|
||
}
|
||
}
|
||
},
|
||
"EditorSoundEffectGenerationRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"prompt",
|
||
"duration"
|
||
],
|
||
"properties": {
|
||
"prompt": {
|
||
"type": "string",
|
||
"minLength": 1
|
||
},
|
||
"model": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"default": "audio1.0"
|
||
},
|
||
"duration": {
|
||
"type": "integer",
|
||
"minimum": 2,
|
||
"maximum": 10
|
||
},
|
||
"projectId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"canvasCompletion": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorCanvasGenerationCompletion"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
],
|
||
"description": "带项目上下文生成时，服务端据此直接写入画布完成态并返回最新项目快照。"
|
||
},
|
||
"generationInputs": {
|
||
"$ref": "#/components/schemas/JsonValue"
|
||
},
|
||
"assetFolderId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"description": "传 project 时写入默认项目素材文件夹；传具体 folderId 时写入该文件夹。"
|
||
},
|
||
"assetLabel": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"description": "写入素材库时使用的素材名称。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"EditorBackgroundMusicGenerationRequest": {
|
||
"type": "object",
|
||
"required": [
|
||
"gptDescriptionPrompt",
|
||
"makeInstrumental"
|
||
],
|
||
"properties": {
|
||
"gptDescriptionPrompt": {
|
||
"type": "string",
|
||
"minLength": 1
|
||
},
|
||
"makeInstrumental": {
|
||
"type": "boolean",
|
||
"const": true
|
||
},
|
||
"projectId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"canvasCompletion": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorCanvasGenerationCompletion"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
],
|
||
"description": "带项目上下文生成时，服务端据此直接写入画布完成态并返回最新项目快照。"
|
||
},
|
||
"generationInputs": {
|
||
"$ref": "#/components/schemas/JsonValue"
|
||
},
|
||
"assetFolderId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"description": "传 project 时写入默认项目素材文件夹；传具体 folderId 时写入该文件夹。"
|
||
},
|
||
"assetLabel": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
],
|
||
"description": "写入素材库时使用的素材名称。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"EditorAudioGenerationResponse": {
|
||
"type": "object",
|
||
"required": [
|
||
"ok",
|
||
"audioSrc",
|
||
"width",
|
||
"height",
|
||
"sourceType",
|
||
"prompt",
|
||
"model",
|
||
"provider",
|
||
"taskId",
|
||
"priceMudPoints",
|
||
"audioKind"
|
||
],
|
||
"properties": {
|
||
"ok": {
|
||
"type": "boolean"
|
||
},
|
||
"audioSrc": {
|
||
"type": "string"
|
||
},
|
||
"objectKey": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"assetObjectId": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"width": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"height": {
|
||
"type": "integer",
|
||
"minimum": 1
|
||
},
|
||
"sourceType": {
|
||
"type": "string",
|
||
"const": "generated"
|
||
},
|
||
"prompt": {
|
||
"type": "string"
|
||
},
|
||
"actualPrompt": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"model": {
|
||
"type": "string"
|
||
},
|
||
"provider": {
|
||
"type": "string"
|
||
},
|
||
"taskId": {
|
||
"type": "string"
|
||
},
|
||
"priceMudPoints": {
|
||
"type": "integer",
|
||
"minimum": 0
|
||
},
|
||
"audioKind": {
|
||
"type": "string",
|
||
"enum": [
|
||
"sound-effect",
|
||
"background-music"
|
||
]
|
||
},
|
||
"project": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorProject"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
],
|
||
"description": "当请求携带 canvasCompletion 且服务端成功写入画布布局时返回最新项目快照。"
|
||
},
|
||
"resource": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorProjectResource"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
],
|
||
"description": "请求携带 projectId 时返回写入的画布资源快照。"
|
||
},
|
||
"asset": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/EditorAsset"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
],
|
||
"description": "请求携带 assetFolderId 时返回写入的账号素材快照。"
|
||
},
|
||
"queueState": {
|
||
"anyOf": [
|
||
{
|
||
"$ref": "#/components/schemas/ExternalGenerationJobStatusRecord"
|
||
},
|
||
{
|
||
"type": "null"
|
||
}
|
||
]
|
||
}
|
||
}
|
||
},
|
||
"ExternalGenerationJobStatusRecord": {
|
||
"type": "object",
|
||
"required": [
|
||
"operationId",
|
||
"status",
|
||
"phaseLabel",
|
||
"phaseDetail",
|
||
"progress",
|
||
"updatedAtMicros"
|
||
],
|
||
"properties": {
|
||
"operationId": {
|
||
"type": "string"
|
||
},
|
||
"status": {
|
||
"type": "string",
|
||
"enum": [
|
||
"queued",
|
||
"running",
|
||
"completed",
|
||
"failed"
|
||
]
|
||
},
|
||
"phaseLabel": {
|
||
"type": "string"
|
||
},
|
||
"phaseDetail": {
|
||
"type": "string"
|
||
},
|
||
"progress": {
|
||
"type": "integer",
|
||
"minimum": 0,
|
||
"maximum": 100
|
||
},
|
||
"error": {
|
||
"type": [
|
||
"string",
|
||
"null"
|
||
]
|
||
},
|
||
"updatedAtMicros": {
|
||
"type": "integer"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
}
|
||
}
|
||
}
|
||
}
|