AI 背景変更
AI 背景変更 API で、画像から被写体を切り出して背景を分離します。
カスタムプロンプトまたは事前定義されたテンプレートで背景を置き換えます。
使用例
Before: 
After: 
Before: 
After: 
1. 画像のアップロード
以下のエンドポイントを通じて、アップロード URL とファイル ID をリクエストします。
POST /s2s/v2.0/file返された URL を使用して画像をアップロードします。 または、独自のストレージにホストされた公開アクセス可能な画像 URL を指定することもできます。
2. 背景説明プロンプトの準備または背景テンプレートの選択
GET /s2s/v2.0/task/template/bg-replace事前定義された背景テンプレートのリストを取得し、template_id で 1 つを選択します。プロンプトを使用する場合、プロンプトに基づいて背景が生成されます。テンプレートを使用する場合、template_id で指定されたテンプレートから背景が生成され、prompt パラメータは無視されます。
3. 分析タスクの実行
POST /s2s/v2.0/task/bg-replaceファイル ID または画像 URL と、希望する背景プロンプトを指定してタスクを送信します。 レスポンスには、結果の追跡と取得に使用される task_id が返されます。
4. タスク結果の取得
GET /s2s/v2.0/task/bg-replace/{task_id}タスク ID を使用してステータスを追跡し、結果を取得します。
Webhook を設定すると、タスク完了時に成功またはエラーのステータスで非同期通知を受信できます。タスクエンドポイントを繰り返し呼び出して、ステータスが running から success または error に更新されるまでポーリングすることもできます。
課金は、タスクが正常に完了した場合にのみ発生します。
- 対応フォーマットと寸法
| AI 機能 | 対応寸法 | 対応ファイルサイズ | 対応フォーマット |
|---|---|---|---|
| AI 背景変更 | 長い辺の長さは 4096 ピクセル以下である必要があります。 | < 10MB | jpg/jpeg/png |
- エラーコード
| エラーコード | 説明 |
|---|---|
| exceed_max_filesize | 入力ファイルサイズが最大制限を超えています。 |
| size_mismatch_on_input_image_and_mask | 入力画像のサイズは、入力マスク画像の寸法と一致する必要があります。 |
| invalid_parameter | パラメータ値が無効です。リクエストパラメータが不足しているか、無効な形式であるか、サポートされていない値が含まれています。 |
- 環境と依存関係
| サンプルコード言語 / ツール | 推奨ランタイムバージョン |
|---|---|
| cURL | - bash >= 3.2 - curl >= 7.58 (モダンな TLS/HTTP サポート) - jq >= 1.6 (堅牢な JSON 解析) |
| Node.js (JavaScript) | Node >= 18 (グローバル fetch 用) |
| JavaScript | - Chrome / Edge >= 80 - Firefox >= 74 - Safari >= 13.1 |
| PHP | PHP >= 7.4 (モダンな TLS/互換性用), ext-curl (推奨) または allow_url_fopen=On + ext-openssl, ext-json |
| Python | Python >= 3.10 (f-strings 用), requests >= 2.20.0 |
| Java | Java 11+ (HttpClient 用), Jackson Databind >= 2.12.0 |
OpenAPI記述をダウンロード
言語
サーバー
https://yce-api-01.makeupar.com