# 高度なブラウザプロファイルの作成

完全な指紋設定を持つブラウザープロファイルを 1 件作成します。
- **前提条件**
：クイック作成と同じプランおよび当日上限のチェックが行われます。プロファイル名はチーム内で一意であること、座標は中国本土の外であること、
`advancedSetting.ua`
 は
`uaVersion`
 と整合していることが必要です。
`proxyId`
 を指定する場合、それがチーム内に既に存在していなければなりません。
- **副作用**
：プロファイル、そのアカウント資格情報（保存時に暗号化）、起動後設定を挿入し、プランの容量と当日作成カウンターを消費します。カスタムプラットフォーム URL を指定するとサイトレコードも作成されます。
- **完了シグナル**
：同期的です。
`data`
 に新しいプロファイル ID が入ります。
- **リトライ**
：冪等ではありません。同じ
`envName`
 を明示した 2 回目の呼び出しは一意性チェックで失敗し、名前を指定しない場合は重複が作られます。冪等キーはありません。タイムアウト後に無条件でリトライせず、まず状態を照会してください。
- **Local API**
：カーネル候補は稼働中のデスクトップクライアントのバージョンで絞り込まれ、同一チームからの同時呼び出しはチーム単位のロックで直列化されます。

文書化されたビジネスエラー: `19001`, `19002`, `19004`, `19005`, `19063`, `19064`, `19100`, `19101`, `19102`, `19103`, `19104`, `19105`, `19106`, `19107`, `19108`, `19109`, `19110`, `19111`, `19112`, `19141`, `19175`。 各コードの意味は [Error Codes](/ja/api-reference/getting-started/error-codes) を参照してください。どの操作でも共通コードが返る場合があります。

Endpoint: POST /api/env/create/advanced
Version: 2026-09-05

## Request fields (application/json):

  - `browserTypeId` (integer, required)
    ブラウザー種別 ID：1=Chrome、2=Firefox

  - `operatorSystemId` (integer, required)
    OS 種別 ID：1:Windows 2:macOS 3:Android 4:IOS 5:Linux

  - `isEncrypt` (integer)
    プロファイルを暗号化するかどうか：0=しない、1=する

  - `startupParams` (array)
    追加のブラウザー起動パラメーター

  - `accountInfo` (object)

  - `accountInfo.customerUrl` (string)
    カスタムプラットフォームURL — platformId=9999の場合に必須。有効なURLである必要があります。

  - `accountInfo.password` (string)
    パスワード; 最大文字数:50文字

  - `accountInfo.platformId` (string)
    プラットフォームID。カスタムURLの場合は9999を使用してください。/api/system/platform/listを参照してください。

  - `accountInfo.siteId` (string)
    サイトID。「Get Configurable Platforms」API（/api/system/platform/list）から取得します。

  - `accountInfo.username` (string)
    ユーザー名（最大文字数：64文字）

  - `advancedSetting` (object)
    高度なブラウザフィンガープリントと動作設定。

  - `advancedSetting.ua` (string)
    プロファイルのユーザーエージェント（UA）をカスタマイズします。標準のUAフォーマットに従う必要があります。
「Get Browser UA」API経由で利用可能です。

  - `advancedSetting.time_zone` (object)

  - `advancedSetting.time_zone.switcher` (integer)
    タイムゾーンオプション。デフォルト：1。1 = IPアドレスに一致、2 = カスタム。

  - `advancedSetting.time_zone.value` (string)
    switcher=2 の場合に必須です。
「タイムゾーンと言語リストの取得」APIから取得したタイムゾーンID。

  - `advancedSetting.web_rtc` (object)

  - `advancedSetting.web_rtc.switcher` (integer)
    WebRTCポリシー。デフォルト：2。1＝プライバシー、2＝置換、3＝有効、4＝無効、5＝転送。

  - `advancedSetting.geo_location` (object)

  - `advancedSetting.geo_location.switcher` (integer)
    位置情報ポリシー。デフォルト：1。1 = 確認、2 = 無効。

  - `advancedSetting.geo_location.base_on_ip` (boolean)
    IPアドレスに基づいて位置情報を生成しますか？デフォルト：true。true = プロンプト表示、false = 手動。

  - `advancedSetting.geo_location.latitude` (number)
    緯度。base_on_ip=false の場合は必須です。

  - `advancedSetting.geo_location.longitude` (number)
    経度。base_on_ip=false の場合は必須です。

  - `advancedSetting.geo_location.accuracy` (number)
    精度はメートル単位です。base_on_ip=false の場合に必須です。

  - `advancedSetting.language` (object)

  - `advancedSetting.language.switcher` (integer)
    言語ポリシー。デフォルト:1。1 = IPアドレスに一致、2 = カスタム。

  - `advancedSetting.language.value` (string)
    switcher=2 の場合に必須です。
「タイムゾーンと言語リストの取得」APIから取得した言語IDをカンマ区切りで指定します。

  - `advancedSetting.resolution` (object)

  - `advancedSetting.resolution.switcher` (integer)
    解決ポリシー。デフォルト：1。1 = リアル、2 = カスタム。

  - `advancedSetting.resolution.id` (string)
    switcher=2 の場合に必須です。
「Get Resolution List」API から取得した解決ID。

  - `advancedSetting.font` (object)

  - `advancedSetting.font.switcher` (integer)
    フォントポリシー。デフォルト：1。1 = 標準、2 = カスタム。

  - `advancedSetting.font.value` (string)
    カンマ区切りのカスタムフォント名（switcher=2 の場合は必須）。

  - `advancedSetting.canvas` (object)

  - `advancedSetting.canvas.switcher` (integer)
    キャンバスポリシー。デフォルト:1。1 = ノイズ、2 = リアル。

  - `advancedSetting.webgl_image` (object)

  - `advancedSetting.webgl_image.switcher` (integer)
    WebGL イメージ ポリシー。デフォルト: 1。1 = ノイズ、2 = リアル。

  - `advancedSetting.webgl_metadata` (object)

  - `advancedSetting.webgl_metadata.switcher` (integer)
    WebGL メタデータ ポリシー。デフォルト: 3。1 = 有効、2 = ハードウェア アクセラレーションを無効、3 = カスタム。

  - `advancedSetting.webgl_metadata.provider` (string)
    WebGLブランド文字列（例：「Google Inc.」）

  - `advancedSetting.webgl_metadata.render` (string)
    WebGLレンダラー文字列（例：「ANGLE (...)」）

  - `advancedSetting.audio_context` (object)

  - `advancedSetting.audio_context.switcher` (integer)
    AudioContext ポリシー。デフォルト: 1。1 = ノイズ、2 = リアル。

  - `advancedSetting.media_device` (object)

  - `advancedSetting.media_device.switcher` (integer)
    メディアデバイスポリシー。デフォルト：1。1 = ノイズ、2 = リアル。

  - `advancedSetting.client_rects` (object)

  - `advancedSetting.client_rects.switcher` (integer)
    ClientRects ポリシー。デフォルト: 1。1 = ノイズ、2 = 実測値。

  - `advancedSetting.speech_voise` (object)

  - `advancedSetting.speech_voise.switcher` (integer)
    SpeechVoicesポリシー。デフォルト：1。1 = プライバシー、2 = リアル

  - `advancedSetting.hardware_concurrency` (integer)
    シミュレーションされる論理CPUコア数。
デフォルト値：4。オプション：0（実数）、2、3、4、6、8、10、12。

  - `advancedSetting.memery_device` (integer)
    シミュレーション対象デバイスのメモリ容量（GB）。
デフォルト値：8。オプション：0（実容量）、2、4、6、8。

  - `advancedSetting.do_not_track` (integer)
    トラッキング拒否設定。デフォルト値：2。1＝オン、2＝オフ。

  - `advancedSetting.bluetooth` (object)

  - `advancedSetting.bluetooth.switcher` (integer)
    Bluetooth ポリシー。デフォルト: 1。1 = プライバシー、2 = 認証。

  - `advancedSetting.battery` (object)

  - `advancedSetting.battery.switcher` (integer)
    バッテリーポリシー。デフォルト：1。1 = プライバシー、2 = 認証。

  - `advancedSetting.port_scan_protection` (object)

  - `advancedSetting.port_scan_protection.switcher` (integer)
    ポートスキャン保護。デフォルト：1。1 = オン、2 = オフ。

  - `advancedSetting.port_scan_protection.value` (string)
    接続を許可するローカルネットワークポート（カンマ区切り）。

  - `advancedSetting.os_version` (string)
    macOSのシステムバージョン（例：macOS 12、macOS 13、macOS 14）。

  - `advancedSetting.web_gpu` (object)

  - `advancedSetting.web_gpu.switcher` (integer)
    WebGPU ポリシー。デフォルト: 1。1 = WebGL ベースのマッチング、2 = 有効、3 = 無効。

  - `advancedSetting.ciphers` (object)

  - `advancedSetting.ciphers.switcher` (integer)
    TLS暗号ポリシー。デフォルト：1。1 = デフォルト、2 = カスタム。

  - `advancedSetting.ciphers.value` (string)
    switcher=2 の場合に必須です。
無効にするTLSプロトコルをカンマ区切りで指定します（例：「TLSv1,TLSv1.1」）。

  - `advancedSetting.mobile_device` (string)
    電話機モデルID（文字列）。「電話機モデルリスト取得」APIを使用して取得してください。
例：「1826502391344832512」

  - `afterStartupConfig` (object)

  - `afterStartupConfig.afterStartup` (integer)
    起動後の動作。デフォルト：1。
1 = 前のページを続行、
2 = 指定したURLを開く、
3 = URLとプラットフォームを開く、
4 = 前のページを続行、プラットフォームを開く。

  - `afterStartupConfig.autoOpenUrls` (array)
    自動的に開く有効なURLのリスト（オプション2～3で必須）。

  - `browserCore` (integer)
    カーネルバージョン。デフォルト：0（自動マッチング）。利用可能なバージョンは `/api/env/advanced/ua/versions` で取得できます。

  - `cookies` (string)
    事前に読み込む Cookie 文字列（省略可）

  - `envName` (string)
    環境名

  - `envRemark` (string)
    環境の備考。最大長：1500 文字

  - `groupId` (string)
    環境グループ ID。デフォルト：未グループ（0）

  - `groupName` (string)
    グループ名（最大50文字）。指定された場合、システムはまず groupId を確認します：有効なグループが見つかればそれを使用し、見つからなければ groupName で検索します。同名のグループが存在すればそれを参照し、存在しなければ新しいグループを作成します。各チームは最大1,000グループに制限されています。

  - `proxyId` (string)
    プロキシ ID。デフォルト：0

  - `tagIds` (array)
    タグ ID。デフォルト：なし

  - `uaVersion` (integer)
    UA プリセットバージョン。デフォルト：0（すべて）

  - `disableAudio` (integer)
    音声を無効化：0 = オフ、1 = オン

  - `disableImg` (integer)
    画像の読み込みを無効化：0 = オフ、1 = オン

  - `disableVideo` (integer)
    動画の読み込みを無効化：0 = オフ、1 = オン

  - `imgLimitSize` (integer)
    画像の最大サイズ（KB）

  - `proxy` (object)
    プロキシ情報

  - `proxy.skipDuplicateProxy` (boolean)
    既存の `proxyId` を指定せずに接続情報を渡す場合に適用されます。 `true` の場合は一致するプロキシを再利用し、一致するものがなければ新規作成します。`false` の場合は一致するプロキシがあっても新規作成します。

  - `proxy.proxyId` (string)
    プロキシ ID

  - `proxy.proxyName` (string)
    プロキシ名（最大 600 文字）

  - `proxy.proxyType` (integer)
    プロキシ種別、0: http、1: https。proxyProvider が 7/8 の場合は空にできません

  - `proxy.proxyProvider` (string)
    プロキシ種別 0: http, 1: https, 2: socks5, 3: ssh, 4: Oxylabs, 5: Proxys.io, 7: Luminati, 8: Lumauto, 9: Oxylabsauto, 10: Trojan, 11: Shadowsocks, 13: ABCPROXY, 14: LunaProxy, 15: IPHTML, 16: PiaProxy, 17: 922S5, 18: 360Proxy

  - `proxy.proxyIp` (string)
    プロキシ IP。proxyProvider が 16/17/18 の場合は空でも構いませんが、それ以外では必須です

  - `proxy.proxyPort` (integer)
    プロキシポート（1〜65535 の数値のみ）。proxyProvider が 16/17/18 の場合は空でも構いませんが、それ以外では必須です

  - `proxy.username` (string)
    ユーザー名（最大 200 文字）

  - `proxy.password` (string)
    パスワード（最大 100 文字）

  - `proxy.refreshUrl` (string)
    更新 URL

  - `proxy.country` (string)
    国コード（例：`us`）。対応するコードは[国とタイムゾーン対照表](/api-reference/appendix/country-time-zone)を参照してください。proxyProvider が 16/17/18 の場合は必須です

  - `proxy.city` (string)
    市区町村

  - `proxy.state` (string)
    都道府県/州

  - `proxy.encryptionType` (integer)
    暗号化方式。proxyProvider が 11 の場合は空にできません。1: aes-128-gcm, 2: aes-192-gcm, 3: aes-256-gcm, 4: aes-128-cfb, 5: aes-192-cfb, 6: aes-256-cfb, 7: aes-128-ctr, 8: aes-192-ctr, 9: aes-256-ctr, 10: rc4-md5, 11: chacha20-ietf, 12: xchacha20, 13: chacha20-ietf-poly1305, 14: xchacha20-ietf-poly1305

  - `proxy.ipMonitor` (boolean)
    IP 変化の監視を有効にするか？true：有効、false：無効

  - `proxy.ipChangeAction` (integer)
    IP 変化の監視 0：アクセスをブロック、1：警告

## Response 200:

  - `200` (unknown)
    成功。`data` は単一の string 値です。

## Response 200 fields (application/json):

  - `code` (integer, required)

  - `msg` (string | null, required)

  - `data` (string, required)

  - `requestId` (string, required)

