# AI 置き換えタスクを実行します。

タスクステータスの確認については、ポーリングガイドを参照してください。この API には、ソース画像、マスクファイル、およびマスクされた領域を置き換える内容を説明するプロンプトが必要です。

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。入力画像と完全に同じ幅と高さを持つグレースケールマスク画像である必要があり、白いピクセルは前景を、黒いピクセルは背景を表します。ファイルアップロード API から取得したファイル ID です。
    Example: eA1CCL3kG4w2s0kpbo2pkah59VfxzIjxahJD2wWm7zw=

  - `src_file_id` (string, required)
    タスクを実行するファイルの ID。ファイルアップロード API から取得したファイル 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