コンテンツへスキップ

IP Adapter Face ID

統合

モデルID ip-adapter-face-id
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ip-adapter-face-id?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

このリクエスト: ≈$0.06 60 APIクレジット · ≈ ₽6.33 このページで実行

APIキーを取得
Tencent 画像編集 #ip-adapter#personalization#customization#editing

1枚の写真または写真のzipから顔に一致する画像を生成し、SD 1.5またはSDXLベースに対応

Tencent · 画像

最初の結果がここに表示されます

以下でリクエストを作成し、APIキーで実行してください。出力はストレージにコピーされ、永久保存または無料で7日保存されます。

リクエストを作成

コントロールはモデルスキーマから生成されます。値を変更するとコードと価格が更新されます。

•必須

生成したい画像をできるだけ詳しく説明してください。最良の結果を得るには詳細な記述を使用します。

デフォルト 4

顔IDのサンプル数。デフォルトは4です。増やすと画像品質は向上しますが、生成時間が長くなります。

詳細設定 negative_prompt · face_image_url · model_type · face_images_data_url · base_1_5_model_repo · base_sdxl_model_repo · guidance_scale · num_inference_steps · width · height · face_id_det_size · seed · enable_safety_checker
デフォルト blurry, low resolutio...

望ましくない画像の詳細を指定するネガティブプロンプト。色、オブジェクト、景色、細部、口ひげ、ぼけ、低解像度などの特徴や品質を除外できます。

ファイルをドロップ、または

顔照合用の参照画像。サイズが異なる場合は640x640に拡大縮小して切り抜きます。

model_type デフォルト 1_5-v1

モデルの選択。1_5はデフォルトかつ多くの用途で推奨される選択肢です。

顔画像のzipアーカイブURL。アーカイブ内の画像の埋め込みを平均化して、より正確な顔IDを作成します。

デフォルト SG161222/Realistic_Vi...

ベース1.5モデルのURL。デフォルトは`SG161222/Realistic_Vision_V4.0_noVAE`です。

デフォルト SG161222/RealVisXL_V3.0

ベースSDXLモデルのURL。デフォルトは`SG161222/RealVisXL_V3.0`です。

デフォルト 7.5

画像選択におけるプロンプト準拠度。CFG(Classifier Free Guidance)として表します。

デフォルト 50

画像生成の推論ステップ数。値を大きくすると生成時間が延びますが、画像品質が向上します。

デフォルト 512

生成される画像の幅。

デフォルト 512

生成される画像の高さ。

デフォルト 640

顔検出モデルのサイズを設定します。モデルが画像内の顔を検出できない場合は小さくしてください。大きい設定ほど検出精度は上がりますが、処理が遅くなり、顔を完全に見落としやすくなります。

Stable Diffusionで画像を再現するためのシード。モデルバージョン、プロンプト、シードを変更しなければ、毎回画像を完全に再現できます。

POST /run/ip-adapter-face-id?wait=20 見積もり → $0.06
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ip-adapter-face-id?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

このリクエストを実行

キーはこのブラウザ内に保持されます。Doitong APIにのみ送信され、「記憶する」にチェックを入れた場合のみlocalStorageに保存されます。 APIキーを取得

IP Adapter Face IDについて

`face_image_url`で指定した顔、または`face_images_data_url`で渡した複数の顔(埋め込みは平均化)に合わせて生成をパーソナライズします。`model_type`でSD 1.5とSDXLのバリアントを選択でき、ベースチェックポイントはrepoパラメータで変更できます。`width`と`height`は512~1024、`num_inference_steps`は最大200です。

パラメータ

名前型 デフォルト許可される値 説明
model_type任意
型enum
デフォルト1_5-v1
1_5-v11_5-v1-plus1_5-v2-plusSDXL-v1SDXL-v2-plus1_5-auraface-v1
モデルの選択。1_5はデフォルトかつ多くの用途で推奨される選択肢です。
prompt必須
型string
生成したい画像をできるだけ詳しく説明してください。最良の結果を得るには詳細な記述を使用します。
face_image_url任意
型url · image
顔照合用の参照画像。サイズが異なる場合は640x640に拡大縮小して切り抜きます。
face_images_data_url任意
型string | null
顔画像のzipアーカイブURL。アーカイブ内の画像の埋め込みを平均化して、より正確な顔IDを作成します。
negative_prompt任意
型string
デフォルトblurry, low resolution, bad, ugly, low quality, pixelated, interpolated, compression artifacts, noisey, grainy
望ましくない画像の詳細を指定するネガティブプロンプト。色、オブジェクト、景色、細部、口ひげ、ぼけ、低解像度などの特徴や品質を除外できます。
seed任意
型integer | null
Stable Diffusionで画像を再現するためのシード。モデルバージョン、プロンプト、シードを変更しなければ、毎回画像を完全に再現できます。
guidance_scale任意
型number
デフォルト7.5
0 – 16
画像選択におけるプロンプト準拠度。CFG(Classifier Free Guidance)として表します。
num_inference_steps任意
型integer
デフォルト50
1 – 200
画像生成の推論ステップ数。値を大きくすると生成時間が延びますが、画像品質が向上します。
num_samples任意
型integer
デフォルト4
1 – 4
顔IDのサンプル数。デフォルトは4です。増やすと画像品質は向上しますが、生成時間が長くなります。
width任意
型integer
デフォルト512
512 – 1,024
生成される画像の幅。
height任意
型integer
デフォルト512
512 – 1,024
生成される画像の高さ。
face_id_det_size任意
型integer
デフォルト640
64 – 640
顔検出モデルのサイズを設定します。モデルが画像内の顔を検出できない場合は小さくしてください。大きい設定ほど検出精度は上がりますが、処理が遅くなり、顔を完全に見落としやすくなります。
base_1_5_model_repo任意
型string
デフォルトSG161222/Realistic_Vision_V4.0_noVAE
ベース1.5モデルのURL。デフォルトは`SG161222/Realistic_Vision_V4.0_noVAE`です。
base_sdxl_model_repo任意
型string
デフォルトSG161222/RealVisXL_V3.0
ベースSDXLモデルのURL。デフォルトは`SG161222/RealVisXL_V3.0`です。
enable_safety_checker任意
型boolean
デフォルトtrue
呼び出し元に権限がある場合、false に設定するとスクリーニングを緩和できます。
必須

ファイルパラメータには、公開されたhttps:// URL、10 MBまでのdata: URI、またはアップロードしたファイルのfile_urlを指定します。 ファイル

出力

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ip-adapter-face-id",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 60,
    "usd": "0.06",
    "charged": 60,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768
    },
    "seed": 42
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ファイルの保存期間を選択すべてのoutputs[].urlはストレージ上のコピーです。アカウント設定または?storage=により、永久保存(GB・月単位で有料)または無料で7日保存できます。
すべてのモデルで同じ形式画像、動画、音声のいずれでも、type、url、content_type、width、height、durationが含まれます。outputはモデル独自の結果オブジェクトです。
出力フィールド
image
object {url, content_type, file_name, file_size, width, height}生成された画像のファイル情報。
seed
integer画像生成シード。入力でシードを省略した場合はランダムに選ばれた値を含み、それ以外では指定値を繰り返します。

AIエージェント向け:このページのMarkdown版はこちらです: https://doitong.com/ja/developers/models/ip-adapter-face-id.md. すべてのモデルとガイド: https://doitong.com/developers/llms.txt