快速开始
开通多模创作平台,并获取调用平台API所需的API端点(Base URL)和API Key,为通过控制台和 API 使用平台服务做准备。
使用限制
多模创作平台目前仅在华东2(上海)地域提供服务,请通过该地域的控制台入口开通和访问服务。
前提条件
-
已准备用于开通服务的阿里云账号。
-
多模创作平台目前处于邀测阶段。开通前,请联系 AnalyticDB for MySQL 技术支持人员或者提交工单 ,将阿里云账号加入平台开通白名单。
-
如果使用 RAM 用户登录,已为该 RAM 用户授予以下任一系统权限策略,无需同时授予:
权限策略
说明
AliyunADBDeveloperAccess
AnalyticDB for MySQL 开发者权限
AliyunADBFullAccess
AnalyticDB for MySQL 管理权限
已完成服务开通:使用已加入白名单的阿里云账号或已获得相应权限的 RAM 用户,登录多模创作平台控制台,在欢迎页面单击前往开通,按页面提示完成开通。服务实例状态为运行中后可继续。
短剧创作
开通后可直接在控制台使用短剧创作,从剧本或原片生成成片,无需编写代码。详细操作与效果示例见短剧创作。
API 调用
获取 API 端点
-
在多模创作平台页面找到已有服务实例区域。
-
目标实例的API 端点作为后续调用平台 API 的 Base URL。
-
API 端点用于指定请求的服务地址,请以控制台显示的实际地址为准。
创建 API Key
-
在API Key 管理区域单击创建 API Key,按页面提示完成创建。
-
在请保存 API Key对话框中复制完整 API Key 并妥善保存,确认后单击确定。
-
完整 API Key 仅在创建成功后展示一次,关闭对话框后无法再次查看。
API Key 是调用平台 API 的鉴权凭证,请勿写入公开文档、代码仓库或日志。
API 调用
下面以字幕擦除为例,提交一个视频即可得到去除字幕的结果。
设置服务地址与鉴权信息,其中 <API 端点> 替换为获取 API 端点中复制的地址:
export API_BASE='https://<API 端点>/api/v1/subtitle-removal'
export API_KEY='<API Key>'
提交任务:
curl --fail-with-body "$API_BASE/tasks" \
-H "Authorization: Bearer $API_KEY" \
-H 'Content-Type: application/json' \
-H "Idempotency-Key: quick-start-001" \
--data '{"source":"https://media.example.com/input.mp4","tier":"fast"}'
请求返回 HTTP 202 和 task_id,仅表示任务已受理。source 需替换为可公网访问的 HTTPS 视频地址(443 端口、无重定向、无账号密码)。
轮询任务状态:
TASK_ID='<task_id>'
curl --fail-with-body "$API_BASE/tasks/$TASK_ID" \
-H "Authorization: Bearer $API_KEY"
每 5~15 秒查询一次,直到 status 进入终态:
|
status |
含义 |
后续操作 |
|
queued / running / cancelling |
排队、处理中、取消中 |
继续轮询 |
|
succeeded |
处理成功 |
从 |
|
failed |
处理失败 |
查看 |
|
cancelled |
已取消 |
需要时重新提交 |
result.download_url 为临时链接,需在 result.expires_in_seconds 内下载;链接过期后可重新查询任务获取。下载产物无需携带 API Key。
常见问题
无法进入开通页面,如何处理?
请依次确认:当前登录账号已加入开通白名单;当前访问地域为华东2(上海);如果使用 RAM 用户登录,该 RAM 用户已获得 AliyunADBDeveloperAccess 或 AliyunADBFullAccess 权限。确认后仍无法访问,请联系 AnalyticDB for MySQL 技术支持人员协助处理或者提交工单。
API 端点和 API Key 有什么区别?
API 端点是平台服务的访问地址,API Key 是调用平台 API 时使用的鉴权凭证。接入 API 时,需要分别配置这两项信息。
关闭创建成功对话框后,还能查看完整 API Key 吗?
不能。完整的 API Key 仅在创建成功后展示一次,请在关闭对话框前复制并妥善保存;如已丢失,需重新创建。