Logo

快速开始

同合云提供文件上传、异步任务处理和结果查询三类核心能力。本文先给你一条最短接入路径，再把流程拆成 3 个独立步骤，帮助你在 5 分钟内完成首次调用。

调试入口（接口文档）

强烈建议先打开这两个接口文档，再开始接入。

它们可以帮助你快速确认请求参数、响应结构、调试方式和接口范围，能明显缩短开发与联调时间。

Swagger / OpenAPI 文档图标

Swagger / OpenAPI 文档

适合快速查看接口定义并直接在线调试

Postman 文档图标

Postman 文档

适合直接导入或对照 Postman 流程进行调试

前置条件

  • 已注册同合云账号
  • 已获得 API Key
  • 具备基本的 HTTP 请求知识

三步接入

  1. 获取 API Key
  2. 上传文件并拿到 file_id
  3. 创建任务并轮询结果

一次完整调用

1. 上传文件

curl -X POST https://api.ai-mcn.tv:10000/base/file/upload \
  -H "Authorization: YOUR_API_KEY" \
  -F "file=@/path/to/your/image.jpg"

{
  "code": 200,
  "msg": "文件上传成功~",
  "data": {
    "file_id": "537489015178246",
    "original_name": "image.jpg",
    "size": 204800,
    "base_ext": ".jpg",
    "download_url": "/download/a1/537489015178246.jpg",
    "created_at": "2026-04-05T08:00:00Z",
    "expire_at": "2026-06-04T00:00:00Z",
    "is_expired": false
  }
}

2. 创建任务

下面以图片去水印接口 /task/image_purify 为例：

curl -X POST https://api.ai-mcn.tv:10000/task/image_purify \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": "537489015178246"
  }'

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "task_type": "image_purify",
    "status": "queued",
    "input_params": {
      "file_id": "537489015178246"
    },
    "created_at": "2026-04-05T08:00:01Z",
    "estimated_duration": 8.5,
    "estimated_queue_wait_duration": 1.2,
    "estimated_total_duration": 9.7,
    "remaining_total_duration": 9.7
  }
}

3. 查询任务结果

curl -X GET https://api.ai-mcn.tv:10000/task/image_purify/537489015178247 \
  -H "Authorization: YOUR_API_KEY"

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "537489015178247",
    "status": "completed",
    "progress": 100,
    "input_params": {
      "file_id": "537489015178246"
    },
    "output_result": {
      "file_id": "537489015178248"
    },
    "task_type_key": "image_purify",
    "task_type_name": "图片去水印",
    "create_time": "2026-04-05T08:00:01Z",
    "update_time": "2026-04-05T08:00:12Z"
  }
}

💡 提示：建议根据ETA字段设计轮询策略。status 变为 completed 后，可继续使用产物 file_id 查询文件详情或直接消费下载地址。

下一步