專為時尚打造的虛擬試穿 API

傳送人物相片與產品圖片。約 8 秒後即可取得該人物穿著該產品的相片。

傳送至 API 的人物相片person
傳送至 API 的產品圖片product
AI 虛擬試穿結果: 洋裝
resultImageUrl

隨本次請求傳送的產品文字

"title": "Cocktail mini dress""description": "Party cocktail mini dress, fitted bodice, short hemline, evening occasion"
單次試穿時間中位數
8.2 s
方案內單次試穿
$0.02
初始免費點數
10

超過 900 家時尚品牌採用

Karl Lagerfeld
Fashion's Park
Sanaulla International
Monastery
Aspiga
Saltrock
Como 1907
Kelly Felder
ESSENTIA
G2000
GQSize
Daly Dress
Al Karim Fabrics
Gabos London
Bo-Star
Anthony's
CĖNC
SARA ELEMARY

三次請求,從相片到產出結果

使用 TypeScript SDK,或透過任何語言進行純 REST 呼叫。

快速入門指南 →
  1. 1

    上傳相片

    POST /images/upload

    系統會回傳 imageId。您可在使用該相片的所有試穿中重複使用它。

  2. 2

    建立試穿

    POST /try-on

    傳送產品圖片、標題、描述及 imageId。無須事先同步目錄。

  3. 3

    取得結果

    GET /generations/:id

    透過輪詢、在 SDK 呼叫 waitFor() 或接收 Webhook 來取得結果。

請將 API 金鑰妥善保留於您的伺服器。瀏覽器請求應一律透過後端處理。

import { Genlook } from "@genlook/api";
import { readFile } from "node:fs/promises";

const client = new Genlook({ apiKey: process.env.GENLOOK_API_KEY! });

// 1. Upload the customer photo once, reuse the imageId.
const { imageId } = await client.images.upload(
  await readFile("./customer.jpg"),
  { mimeType: "image/jpeg" },
);

// 2. Create the try-on. The product is created inline.
const { generationId } = await client.tryOn.create({
  products: [{
    externalId: "hoodie-42",
    title: "Oversized cotton hoodie",
    description: "Relaxed fit, dropped shoulders, hip length.",
    images: [{ source: { url: "https://cdn.example.com/hoodie.jpg" } }],
  }],
  person: { image: { source: { id: imageId } } },
});

// 3. Wait for the result (or use a webhook).
const result = await client.generations.waitFor(generationId);
console.log(result.resultImageUrl);
GET /generations/:id200 · COMPLETED
{
  "generationId": "cm8gen456xyz",
  "status": "COMPLETED",
  "resultImageUrl": "https://storage.googleapis.com/...",
  "createdAt": "2026-03-30T10:00:00.000Z",
  "updatedAt": "2026-03-30T10:00:10.000Z"
}

支援任何產品類型

每張圖片皆來自一次試穿呼叫。懸停游標即可查看原始傳送的相片。

更多範例 →
洋裝
洋裝
外套
外套
街頭服飾
街頭服飾
眼鏡
眼鏡
假髮
假髮
彩色隱形眼鏡
彩色隱形眼鏡
隨選列印
隨選列印
寵物服飾
寵物服飾

專為正式環境打造

您可在儀表板查看每把 API 金鑰的記錄、使用量與花費。

錯誤代碼參考 →

任何產品類型

服飾、鞋類、眼鏡、帽子、假髮、彩色隱形眼鏡和寵物服飾。

穿搭

單次試穿最多支援 4 件產品,例如上衣、長褲與外套。

Webhooks

取得 generation.completed 與 generation.failed 事件,無須輪詢。

任何圖片輸入

支援最高 10 MB 的 JPEG、PNG、WebP 或 HEIC,格式可為檔案、URL 或 imageId。

試穿失敗退還點數

每次錯誤皆會回傳明確的代碼與訊息。

使用者資料控管

一次呼叫即可刪除單一使用者的所有圖片,或將上傳內容保留 1、3 或 7 天。

專屬品牌識別

在結果中加入您的標誌。可依請求關閉歐盟 AI 法案標籤。

無須代管

您無須準備 GPU 或排隊等候,引擎亦會自動更新至最新版本。

方案內單次試穿 $0.02

大用量最低單次 $0.015,隨需付費則為單次 $0.04。所有選項皆共用相同的 API 與引擎,可隨時取消。

客製化方案每月 $1,000 起。如需了解客製化方案或新創計畫,請傳送電子郵件至 thibault@genlook.app。

取得 API 金鑰
2,000
  • 隨需付費單次試穿 $0.04,點數包 $5 起。點數永久有效。US$80.00/ 月US$0.04 單次試穿
  • 入門版最低成本每月 $20,內含 1,000 次試穿,超出部分單次 $0.02。US$40.00/ 月US$0.02 單次試穿
  • 成長版每月 $99,內含 6,000 次試穿,超出部分單次 $0.018。US$99.00/ 月US$0.0495 單次試穿
  • 擴展版每月 $300,內含 20,000 次試穿,超出部分單次 $0.015。US$300/ 月US$0.15 單次試穿

費用為稅前預估。試穿失敗將自動退還點數。新帳戶可獲贈 10 點免費點數。

SDK 與工具

與其他試穿 API 的比較

完整比較表 →

常見問題

完整參考資料請見說明文件。

閱讀說明文件 →
如何取得 API 金鑰?
前往 platform.genlook.app 建立帳戶。金鑰立即可用,並附贈 10 點免費點數。
我可以從瀏覽器呼叫 API 嗎?
不行。請將 API 金鑰保管於您的伺服器,並透過後端處理所有來自瀏覽器的請求。基於相同安全性考量,SDK 僅限伺服器端使用。
我經營 Shopify、WooCommerce 或 PrestaShop 商店,會需要用到 API 嗎?
不需要。請直接使用專為您平台打造的 Genlook 應用程式、外掛或模組。此 API 是專為客製化店面、行動應用程式與其他產品所設計。
速度有多快?
從發出請求到產出結果的時間中位數為 8.2 秒。新產品初次試穿會多花幾秒鐘,因為系統需要對產品進行一次性分析。
如何不花點數進行測試?
傳送標題為「mock」的產品。API 會迅速原封不動地回傳人物相片,讓您方便測試流程。
你們有新創計畫嗎?
有的。請傳送電子郵件至 thibault@genlook.app 並說明您正在開發的項目。

使用 10 點免費點數開始體驗。

建立帳戶、取得 API 金鑰,只需幾分鐘即可執行您的第一次試穿。