Ngôn ngữ: VI
Bắt đầu miễn phí

Studio ảnh sản phẩm dưới dạng API.

API của Herofab nhận một ảnh sản phẩm và tên công cụ, rồi xử lý tác vụ ở chế độ nền; việc kiểm tra trạng thái hoặc webhook có chữ ký sẽ báo khi ảnh hoàn chỉnh sẵn sàng để tải xuống.

  • Khóa API dạng Bearer
  • Webhook có chữ ký
  • Tối đa 100 tác vụ mỗi lô
  • OpenAPI 3.1 và llms.txt

MCP https://app.herofab.app/mcpOpenAPI · GPT Actions https://app.herofab.app/api/agent/openapi.jsonMCP · API key https://app.herofab.app/mcp/studio

{
  "mcpServers": {
    "herofab-studio": {
      "type": "http",
      "url": "https://app.herofab.app/mcp/studio",
      "headers": {
        "Authorization": "Bearer hf_sk_live_..."
      }
    }
  }
}
curl https://app.herofab.app/api/v1/jobs -H "Authorization: Bearer $HEROFAB_API_KEY" -H "Idempotency-Key: $(uuidgen)" --json '{"tool": "ghost_mannequin", "inputs": {"garment": "ASSET_ID"}}'
Cách hoạt động

Từ ảnh chụp đến ảnh hoàn chỉnh.

01

Gửi

Tải ảnh sản phẩm lên và tạo tác vụ với một công cụ cùng các thiết lập; tác vụ sẽ giữ trước số credit cần dùng.

POST /api/v1/assetsPOST /api/v1/jobs

02

Kiểm tra

Kiểm tra tác vụ cho đến khi hoàn tất, hoặc nhận webhook có chữ ký khi tác vụ hoàn tất.

GET /api/v1/jobs/{id}

03

Tải xuống

Lấy ảnh hoàn chỉnh bằng ID tài nguyên của đầu ra tác vụ.

GET /api/v1/assets/{id}/content

Ví dụ đầy đủ: tải ảnh lên, tạo tác vụ, chờ, tải xuống
API=https://app.herofab.app/api/v1
AUTH="Authorization: Bearer $HEROFAB_API_KEY"

# 1 · Upload the product photo
ASSET_ID=$(curl -s "$API/assets" \
  -H "$AUTH" \
  -F file=@shirt.jpg | jq -r .id)

# 2 · Create the job
BODY=$(jq -n --arg garment "$ASSET_ID" '{tool: "ghost_mannequin",
  inputs: {garment: $garment}, params: {style: "3d", backdrop: "white"}}')
JOB_ID=$(curl -s "$API/jobs" \
  -H "$AUTH" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d "$BODY" | jq -r .id)

# 3 · Poll until the job is finished
while :; do
  JOB=$(curl -s "$API/jobs/$JOB_ID" -H "$AUTH")
  STATE=$(jq -r .state <<<"$JOB")
  [ "$STATE" = queued ] || [ "$STATE" = running ] || break
  sleep 2
done
[ "$STATE" = succeeded ] || { jq -r .failure.code <<<"$JOB"; exit 1; }

# 4 · Download the image
OUTPUT_ID=$(jq -r '.outputs[0].asset_id' <<<"$JOB")
EXT=$(jq -r '.outputs[0].content_type | ltrimstr("image/")' <<<"$JOB")
curl -sL "$API/assets/$OUTPUT_ID/content" -H "$AUTH" -o "result.$EXT"
Bắt đầu

Bộ sưu tập tiếp theo, chụp ngay trong tuần này.

20 credit khi đăng ký, không cần thẻ thanh toán. Ảnh tạo bằng credit miễn phí có hình mờ. Herofab cũng xóa hình mờ khỏi những ảnh này sau khi credit được mua.