Ngôn ngữ: VI
Đăng ký sớm

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
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 [email protected] | 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"
Truy cập sớm

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

20 credit miễn phí khi mở quyền truy cập sớm. Không cần thẻ thanh toán.