快速开始

更新时间:
复制 MD 格式

开通多模创作平台,并获取调用平台API所需的API端点(Base URL)和API Key,为通过控制台和 API 使用平台服务做准备。

使用限制

多模创作平台目前仅在华东2(上海)地域提供服务,请通过该地域的控制台入口开通和访问服务。

前提条件

  • 已准备用于开通服务的阿里云账号。

  • 多模创作平台目前处于邀测阶段。开通前,请联系 AnalyticDB for MySQL 技术支持人员或者提交工单 ,将阿里云账号加入平台开通白名单。

  • 如果使用 RAM 用户登录,已为该 RAM 用户授予以下任一系统权限策略,无需同时授予:

    权限策略

    说明

    AliyunADBDeveloperAccess

    AnalyticDB for MySQL 开发者权限

    AliyunADBFullAccess

    AnalyticDB for MySQL 管理权限

    已完成服务开通:使用已加入白名单的阿里云账号或已获得相应权限的 RAM 用户,登录多模创作平台控制台,在欢迎页面单击前往开通,按页面提示完成开通。服务实例状态为运行中后可继续。

短剧创作

开通后可直接在控制台使用短剧创作,从剧本或原片生成成片,无需编写代码。详细操作与效果示例见短剧创作。

API 调用

获取 API 端点

  1. 在多模创作平台页面找到已有服务实例区域。

  2. 目标实例的API 端点作为后续调用平台 API 的 Base URL。

  3. API 端点用于指定请求的服务地址,请以控制台显示的实际地址为准。

创建 API Key

  1. 在API Key 管理区域单击创建 API Key,按页面提示完成创建。

  2. 在请保存 API Key对话框中复制完整 API Key 并妥善保存,确认后单击确定。

  3. 完整 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

处理成功

从 result.download_url 下载产物

failed

处理失败

查看 error 排查原因,换新的幂等键重新提交

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 仅在创建成功后展示一次,请在关闭对话框前复制并妥善保存;如已丢失,需重新创建。

相关文档