# 执行 AI 替换物件 任务。

查询任务状态请参见轮询指南。本接口需要源图片、蒙版文件，以及描述蒙版区域要替换成什么的提示词。

Endpoint: POST /s2s/v2.0/task/obj-replace
Security: BearerAuthenticationV2

## Security:

  - `BearerAuthenticationV2` (unknown)
    http bearer

## Request fields (application/json):

  - `prompt` (string, required)
    用于在蒙版区域生成对象的提示词。
    Example: a cute cat

  - `src_file_url` (string, required)
    用于运行任务的文件 URL，该 URL 需可公开访问。
    Example: https://example.com/selfie.jpg

  - `msk_file_url` (string, required)
    蒙版文件的 URL。须为与输入图片宽高完全一致的灰度蒙版图， 白色像素表示前景，黑色像素表示背景。该 URL 需可公开访问。
    Example: https://example.com/mask.jpg

  - `msk_file_id` (string, required)
    蒙版文件的 ID。须为与输入图片宽高完全一致的灰度蒙版图， 白色像素表示前景，黑色像素表示背景。ID 取自上传文件接口。
    Example: eA1CCL3kG4w2s0kpbo2pkah59VfxzIjxahJD2wWm7zw=

  - `src_file_id` (string, required)
    用于运行任务的文件 ID，取自上传文件接口返回的 file_id。
    Example: pfNK5PuRe0MrwLHcGA3DOmB1ahwfXTbYHjv+KoBIxbE=

## Response 200:

  - `200` (unknown)
    任务执行成功

## Response 200 fields (application/json):

  - `status` (integer)
    响应状态
    Example: 200

  - `data` (object)

  - `data.task_id` (string)
    该任务的 ID。凭这个 ID 可在 24 小时内查询任务结果。
    Example: grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe

## Response 400:

  - `400` (unknown)
    任务执行失败

## Response 400 fields (application/json):

  - `status` (integer)
    响应状态
    Example: 400

  - `error` (string)
    错误信息
    Example: The operation could not be completed

  - `error_code` (string)
    错误码：
* InvalidParameters - 请求参数无效
* CreditInsufficiency - 点数不足，无法运行
* BadRequest - 请求参数不符合预期
* InvalidStyleGroup - 风格分组 ID 无效
* InvalidStyle - 风格 ID 无效
    Enum: "InvalidParameters", "CreditInsufficiency", "InvalidStyleGroup", "InvalidStyle", "BadRequest"

## Response 401:

  - `401` (unknown)
    API 密钥无效或缺失

## Response 401 fields (application/json):

  - `status` (integer)
    响应状态
    Example: 401

  - `error` (string)
    Example: Invalid API key

## Response 429:

  - `429` (unknown)
    请求过多

## Response 429 fields (application/json):

  - `status` (integer)
    响应状态
    Example: 429

  - `error` (string)
    Example: Too many requests