{"templateId":"api_docs","sharedDataIds":{"apiDocsStore":"api-docs-@l10n/ja/reference/ai_photo_background_change.yaml","sidebar":"sidebar-@l10n/ja/reference/sidebars.yaml"},"props":{"definitionId":"@l10n/ja/reference/ai_photo_background_change.yaml","settings":{"baseUrlPath":"/ja/reference/ai_photo_background_change"},"disableAutoScroll":true,"seo":{"title":"AI 背景変更","description":"YouCam API documentation by Perfect Corp. Learn how to use Skin analysis API, Virtual try-on API, Image editing API, and Video generative AI APIs.","siteUrl":"https://docs.perfectcorp.com","keywords":"AI Skin Analysis, AI Clothes, AI Hairstyle, AI Outfits","image":"/assets/favicon.cd6fa4d833b2a573b3c6dae68386b293da205b203402cb0c97b80bd2acc07ea2.8351e24f.png"},"dynamicMarkdocComponents":[],"metadata":{"type":"openapi","title":"AI 背景変更","version":"","description":"# 概要\n\nAI 背景変更 API で、画像から被写体を切り出して背景を分離します。\n\nカスタムプロンプトまたは事前定義されたテンプレートで背景を置き換えます。\n\n**使用例**\n\nBefore:\n![](https://yce.makeupar.com/assets/images/sod/banner/change/yce-topbanner-dt-before.jpg)\n\nAfter:\n![](https://yce.makeupar.com/assets/images/sod/banner/change/yce-topbanner-dt-after.jpg)\n\n\nBefore:\n![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/yce_change_bg_s5_poster_before_0753db3e02.jpg)\n\nAfter:\n![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/yce_change_bg_s5_poster_after_7fb288fde2.jpg)\n\n---\n\n## 統合ガイド\n\n**1. 画像のアップロード**\n\n以下のエンドポイントを通じて、アップロード URL とファイル ID をリクエストします。\n\n```\nPOST /s2s/v2.0/file\n```\n\n返された URL を使用して画像をアップロードします。\nまたは、独自のストレージにホストされた公開アクセス可能な画像 URL を指定することもできます。\n\n\n**2. 背景説明プロンプトの準備または背景テンプレートの選択**\n\n```\nGET /s2s/v2.0/task/template/bg-replace\n```\n\n事前定義された背景テンプレートのリストを取得し、template_id で 1 つを選択します。プロンプトを使用する場合、プロンプトに基づいて背景が生成されます。テンプレートを使用する場合、template_id で指定されたテンプレートから背景が生成され、prompt パラメータは無視されます。\n\n\n**3. 分析タスクの実行**\n\n```\nPOST /s2s/v2.0/task/bg-replace\n```\n\nファイル ID または画像 URL と、希望する背景プロンプトを指定してタスクを送信します。\nレスポンスには、結果の追跡と取得に使用される task_id が返されます。\n\n\n**4. タスク結果の取得**\n\n```\nGET /s2s/v2.0/task/bg-replace/{task_id}\n```\n\nタスク ID を使用してステータスを追跡し、結果を取得します。\n\n[Webhook](../develop/webhook.md) を設定すると、タスク完了時に成功またはエラーのステータスで非同期通知を受信できます。タスクエンドポイントを繰り返し呼び出して、ステータスが running から success または error に更新されるまでポーリングすることもできます。\n\n課金は、タスクが正常に完了した場合にのみ発生します。\n\n---\n\n## ファイル仕様とエラー\n\n* 対応フォーマットと寸法\n\n|AI 機能|対応寸法|対応ファイルサイズ|対応フォーマット|\n|  ----  | ----  | ----  | ----  |\n| AI 背景変更 | 長い辺の長さは 4096 ピクセル以下である必要があります。 | < 10MB | jpg/jpeg/png |\n\n* エラーコード\n\n|エラーコード|説明|\n|  ----  | ----  |\n| exceed_max_filesize | 入力ファイルサイズが最大制限を超えています。 |\n| size_mismatch_on_input_image_and_mask | 入力画像のサイズは、入力マスク画像の寸法と一致する必要があります。 |\n| invalid_parameter | パラメータ値が無効です。リクエストパラメータが不足しているか、無効な形式であるか、サポートされていない値が含まれています。|\n\n* 環境と依存関係\n\n| サンプルコード言語 / ツール | 推奨ランタイムバージョン |\n|---|---|\n| cURL | - bash >= 3.2</br>   - curl >= 7.58 (モダンな TLS/HTTP サポート)</br>   - jq >= 1.6 (堅牢な JSON 解析) |\n| Node.js (JavaScript) | Node >= 18 (グローバル fetch 用) |\n| JavaScript | - Chrome / Edge >= 80</br>   - Firefox >= 74</br>   - Safari >= 13.1 |\n| PHP | PHP >= 7.4 (モダンな TLS/互換性用), ext-curl (推奨) または allow_url_fopen=On + ext-openssl, ext-json |\n| Python | Python >= 3.10 (f-strings 用), requests >= 2.20.0 |\n| Java | Java 11+ (HttpClient 用), Jackson Databind >= 2.12.0 |\n\n---\n\n## ユニット消費量\n\n| AI 機能 | 消費ユニット |\n|---|---|\n| AI 背景変更 V2.0 | 4 |\n\n---\n"},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"docs.perfectcorp.com","port":4000,"ipAddress":"216.73.216.218"},"lang":"ja","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"master"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/ja/reference/ai_photo_background_change","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}