图片拼接采用图像拼接技术,即将普通相机拍摄的两幅或多幅来自不同视点、视角和时间拍摄的具有一定空间重叠的图像拼接起来,形成一幅宽视角的高质量图像。本文介绍如何使用图片拼接功能。
前提条件
已创建并获取AccessKey。具体操作,请参见创建AccessKey。
已开通OSS服务、创建存储空间并上传文件到存储空间。具体操作,请参见控制台上传文件。
已开通智能媒体管理服务。具体操作,请参见开通产品。
已通过智能媒体管理控制台创建项目。具体操作,请参见创建项目。
说明您也可以调用API接口创建项目。具体操作,请参见CreateProject - 创建项目。
您可以调用ListProjects - 列出所有项目信息的列表接口列出指定地域下已创建的所有项目信息。
使用方法
调用CreateImageSplicingTask - 创建图片拼接任务接口将多张图片拼接。
任务开始执行后,任务信息只保存7天,超过7天则无法再获取。您可以通过以下几种方式及时获取任务信息:
调用GetTask - 获取任务信息或ListTasks - 列出任务接口获取返回的
TaskId
,查看任务信息。在与智能媒体管理相同的地域下开通MNS服务,并配置订阅关系,及时获取任务信息通知,异步通知消息格式请参见异步通知消息格式。关于MNS SDK的更多信息,请参见步骤四:接收和删除消息。
在与智能媒体管理相同的地域下开通RocketMQ服务,并创建RocketMQ 4.0实例、Topic、Group,及时获取任务信息通知,异步通知消息格式请参见异步通知消息格式。关于RocketMQ使用的更多信息,请参见调用HTTP协议的SDK收发普通消息。
在与智能媒体管理相同的地域下开通并接入事件总线EventBridge服务,及时获取任务信息通知。更多信息,请参见智能媒体管理IMM事件。
图片信息
IMM项目名称:test-project
待拼接图片的存储地址如下:
oss://test-bucket/test-object.jpg1
oss://test-bucket/test-object.jpg2
拼接后的图片存储地址:oss://test-bucket/test-target-object.jpg
请求示例
{
"ProjectName": "test-project",
"Sources": "[{\"URI\": \"oss://test-bucket/test-object.jpg1\"},{\"URI\": \"oss://test-bucket/test-object.jpg2\"}]",
"TargetURI": "oss://test-bucket/test-target-object.jpg",
}
返回示例
{
"TaskId": "ImageSplicing-1c73b551-381d-46cc-86ed-16905*****",
"RequestId": "657DE82D-5960-0309-810C-639637*****",
"EventId": "124-1S7JgMQdZ3kWQbmUqXxI3******"
}
示例代码
以Python SDK为例,图片拼接的完整示例代码如下。
# -*- coding: utf-8 -*-
# This file is auto-generated, don't edit it. Thanks.
import sys
import os
from typing import List
from alibabacloud_imm20200930.client import Client as imm20200930Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_imm20200930 import models as imm_20200930_models
from alibabacloud_tea_util import models as util_models
from alibabacloud_tea_util.client import Client as UtilClient
class Sample:
def __init__(self):
pass
@staticmethod
def create_client(
access_key_id: str,
access_key_secret: str,
) -> imm20200930Client:
"""
使用AccessKey ID&AccessKey Secret初始化账号Client。
@param access_key_id:
@param access_key_secret:
@return: Client
@throws Exception
"""
config = open_api_models.Config(
access_key_id=access_key_id,
access_key_secret=access_key_secret
)
# 填写访问的IMM域名。
config.endpoint = f'imm.cn-beijing.aliyuncs.com'
return imm20200930Client(config)
@staticmethod
def main(
args: List[str],
) -> None:
# 阿里云账号AccessKey拥有所有API的访问权限,建议您使用RAM用户进行API访问或日常运维。
# 强烈建议不要把AccessKey ID和AccessKey Secret保存到工程代码里,否则可能导致AccessKey泄露,威胁您账号下所有资源的安全。
# 本示例通过从环境变量中读取AccessKey,来实现API访问的身份验证。
imm_access_key_id = os.getenv("AccessKeyId")
imm_access_key_secret = os.getenv("AccessKeySecret")
client = Sample.create_client(imm_access_key_id, imm_access_key_secret)
sources_0 = imm_20200930_models.CreateImageSplicingTaskRequestSources(
uri='oss://test-bucket/test-object.jpg1'
)
sources_1 = imm_20200930_models.CreateImageSplicingTaskRequestSources(
uri='oss://test-bucket/test-object.jpg2'
)
create_image_splicing_task_request = imm_20200930_models.CreateImageSplicingTaskRequest(
project_name='test-project',
sources=[
sources_0,
sources_1
],
target_uri='oss://test-bucket/test-target-object.jpg'
)
runtime = util_models.RuntimeOptions()
try:
# 复制代码运行请自行打印API的返回值。
client.create_image_splicing_task_with_options(create_image_splicing_task_request, runtime)
except Exception as error:
# 如有需要,请打印错误信息。
UtilClient.assert_as_string(error.message)
@staticmethod
async def main_async(
args: List[str],
) -> None:
# 阿里云账号AccessKey拥有所有API的访问权限,建议您使用RAM用户进行API访问或日常运维。
# 强烈建议不要把AccessKey ID和AccessKey Secret保存到工程代码里,否则可能导致AccessKey泄露,威胁您账号下所有资源的安全。
# 本示例通过从环境变量中读取AccessKey,来实现API访问的身份验证。
imm_access_key_id = os.getenv("AccessKeyId")
imm_access_key_secret = os.getenv("AccessKeySecret")
client = Sample.create_client(imm_access_key_id, imm_access_key_secret)
sources_0 = imm_20200930_models.CreateImageSplicingTaskRequestSources(
uri='oss://test-bucket/test-object.jpg1'
)
sources_1 = imm_20200930_models.CreateImageSplicingTaskRequestSources(
uri='oss://test-bucket/test-object.jpg2'
)
create_image_splicing_task_request = imm_20200930_models.CreateImageSplicingTaskRequest(
project_name='test-project',
sources=[
sources_0,
sources_1
],
target_uri='oss://test-bucket/test-target-object.jpg'
)
runtime = util_models.RuntimeOptions()
try:
# 复制代码运行请自行打印API的返回值。
await client.create_image_splicing_task_with_options_async(create_image_splicing_task_request, runtime)
except Exception as error:
# 如有需要,请打印错误信息。
UtilClient.assert_as_string(error.message)
if __name__ == '__main__':
Sample.main(sys.argv[1:])
计费说明
在图片拼接过程中,OSS 和 IMM 两侧会产生以下计费项:
OSS 侧: 详细定价请参见OSS产品定价。
API
计费项
说明
GetObject
GET 类型请求
根据成功的请求次数计算请求费用。
低频访问数据取回容量
如果取回的数据是低频访问数据,会产生低频访问数据取回容量的费用,按数据取回量计费。
归档直读数据取回容量
如果读取的是归档的Object且Bucket开启了归档直读,会产生归档直读数据取回容量费用,根据取回的数据容量大小计费。
传输加速
如果开启了传输加速功能且使用传输加速域名访问您的Bucket会产生传输加速费用,根据数据容量大小计费。
PutObject
PUT类型请求
根据成功的请求次数计算请求费用。
存储费用
根据Object的存储类型、大小和时长收取存储费用。
HeadObject
GET 类型请求
根据成功的请求次数计算请求费用。
IMM 侧: 详细定价请参见IMM计费项。
重要自北京时间 2025 年 7 月 28 日 11:00 起,IMM 图片拼接服务将由免费模式升级为计费模式。更多信息,请参见IMM计费调整公告。
API
计费项
说明
CreateImageSplicingTask
ImageSplicing
根据图片拼接次数计算图片拼接的费用。