Cloud Annotations项目：通过API上传图像和标注文件的完整指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00884/article/details/148784150

Cloud Annotations项目：通过API上传图像和标注文件的完整指南

cloud-annotations 🐝 A fast, easy and collaborative open source image annotation tool for teams and individuals. 项目地址: https://gitcode.com/gh_mirrors/cl/cloud-annotations

项目概述

Cloud Annotations是一个基于云对象存储(COS)构建的标注工具，它允许用户通过简单的API接口上传图像和对应的标注数据。本文将详细介绍如何通过API与Cloud Annotations项目进行交互，包括标注文件的格式规范和各种上传方法。

标注文件结构解析

Cloud Annotations项目使用一个名为_annotations.json的特殊文件来存储所有标注元数据。这个文件必须位于存储桶的根目录下，其结构如下：

对象检测项目示例

{
  "version": "1.0",
  "type": "localization",
  "labels": ["猫", "狗"],
  "annotations": {
    "image1.jpg": [
      {
        "x": 0.7255949630314233,
        "x2": 0.9695875693160814,
        "y": 0.5820120073891626,
        "y2": 1,
        "label": "猫"
      },
      {
        "x": 0.8845598428835489,
        "x2": 1,
        "y": 0.1829972290640394,
        "y2": 0.966248460591133,
        "label": "狗"
      }
    ]
  }
}

关键字段说明

version: 标注文件版本号，当前为"1.0"
type: 标注类型，"localization"表示对象检测
labels: 所有可能的类别标签数组
annotations: 包含所有图像标注数据的对象

分类项目注意事项

对于图像分类项目，标注文件结构与上述类似，但不需要包含边界框坐标(x, x2, y, y2)信息。

通过cURL上传文件

第一步：获取访问令牌

使用IAM凭证获取access_token：

curl -X POST "https://iam.cloud.ibm.com/identity/token" \
  -d "response_type=cloud_iam" \
  -d "grant_type=urn:ibm:params:oauth:grant-type:apikey" \
  -d "apikey=你的API密钥"

第二步：上传文件到存储桶

curl -X PUT "https://s3.us.cloud-object-storage.appdomain.cloud/你的存储桶名称/目标文件名" \
  -H "Authorization: bearer 你的访问令牌" \
  -T "本地文件路径"

使用各种SDK上传文件

除了cURL，Cloud Annotations项目支持多种编程语言的SDK进行文件上传：

Python SDK示例

import ibm_boto3
from ibm_botocore.client import Config

cos = ibm_boto3.client(
    's3',
    ibm_api_key_id='你的API密钥',
    ibm_service_instance_id='服务实例ID',
    ibm_auth_endpoint='https://iam.cloud.ibm.com/identity/token',
    config=Config(signature_version='oauth'),
    endpoint_url='https://s3.us.cloud-object-storage.appdomain.cloud'
)

with open('本地文件路径', 'rb') as file_data:
    cos.upload_fileobj(
        Fileobj=file_data,
        Bucket='存储桶名称',
        Key='目标文件名'
    )

Node.js SDK示例

const AWS = require('ibm-cos-sdk');
const fs = require('fs');

const cos = new AWS.S3({
    endpoint: 'https://s3.us.cloud-object-storage.appdomain.cloud',
    apiKeyId: '你的API密钥',
    ibmAuthEndpoint: 'https://iam.cloud.ibm.com/identity/token',
    serviceInstanceId: '服务实例ID',
});

const fileStream = fs.createReadStream('本地文件路径');
const uploadParams = {
    Bucket: '存储桶名称', 
    Key: '目标文件名',
    Body: fileStream
};

cos.upload(uploadParams).promise()
    .then(data => console.log('上传成功:', data.Location))
    .catch(err => console.error('上传失败:', err));