API Social Studio | Tài liệu dành cho nhà phát triển Fit It On

Áp dụng các hiệu ứng và mẫu sáng tạo, được cách điệu cao cho hình ảnh thời trang trên mạng xã hội.

Điểm cuối Social Studio áp dụng các mẫu thẩm mỹ sáng tạo, được cách điệu cao cho hình ảnh thời trang của bạn, biến chúng thành nội dung bắt mắt, hoàn toàn phù hợp cho tiếp thị truyền thông xã hội.

Tên mô hình: social-studio

Vòng đời: ổn định

Thời gian xử lý: ~15s–30s

Định dạng đầu ra: Tự động (JPEG hoặc PNG)

Phương thức phân phối: URL

Tín dụng: 2 đến 5 mỗi lần tạo (tùy thuộc vào chất lượng)

Request

Gửi hình ảnh và ID kiểu đã chọn của bạn đến điểm cuối /v1/run chung:

POSThttps://fititon.app/api/v1/run

Ví dụ yêu cầu

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "social-studio",
           "inputs": {
             "personImage": "https://example.com/model-shot.jpg",
             "styleId": "action-figure",
             "quality": "2k",
             "sampleCount": 1
           }
         }'

Response

Vì việc tạo hình ảnh có thể mất tới 30 giây, điểm cuối /v1/run trả về trạng thái 201 Created ngay lập tức với một id công việc không đồng bộ. Bạn phải thăm dò API Trạng thái bằng cách sử dụng id này để truy xuất hình ảnh cuối cùng. Ngoài ra, bạn có thể cấu hình webhook để nhận thông báo tự động. Xin lưu ý rằng bộ điều phối webhook của chúng tôi áp dụng thời gian chờ nghiêm ngặt 15 giây. Máy chủ của bạn phải xác nhận webhook bằng mã trạng thái 2xx trong vòng 15 giây, nếu không chúng tôi sẽ coi đó là thất bại và thử lại sau.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2024-03-10T12:00:00Z",
  "model_name": "social-studio"
}

Khi công việc hoàn tất (status: "success"), trường output sẽ chứa một mảng các URL kết quả:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://cdn.fititon.app/users/123/results/social-studio-123-0.png"
  ],
  "error": null,
  "created_at": "2024-03-10T12:00:00Z",
  "updated_at": "2024-03-10T12:00:20Z"
}

Tham số yêu cầu

Tham số bắt buộc

personImageRequiredstring

Hình ảnh nguồn để tạo kiểu. Có thể là URL công khai hoặc chuỗi hình ảnh được mã hóa Base64.

Mẹo chuyên nghiệp: Ảnh toàn thân, nơi toàn bộ người hiển thị, tạo ra kết quả tạo kiểu tốt nhất. Khả năng hiển thị khuôn mặt rõ ràng rất quan trọng — AI sử dụng các đặc điểm khuôn mặt để tạo phiên bản được tạo kiểu của bạn. Tránh ảnh nhóm hoặc ảnh bạn bị che khuất một phần phía sau các vật thể.

Yêu cầu định dạng Khi gửi chuỗi Base64, nó phải bao gồm tiền tố URI dữ liệu tiêu chuẩn (ví dụ: data:image/jpeg;base64,...). Mặc dù personImage chấp nhận chuỗi Base64, chúng tôi đặc biệt khuyên bạn nên sử dụng URL HTTP tiêu chuẩn cho hình ảnh lớn hơn 3MB để tránh vượt quá giới hạn kích thước tải trọng JSON toàn cầu (HTTP 413) trong yêu cầu của bạn.

styleIdRequiredstring

ID kiểu ảnh để áp dụng cho hình ảnh được tạo. Điều này xác định ánh sáng, thẩm mỹ và tâm trạng.

Các kiểu có sẵn:

Style Name	Style ID (`styleId`)

Tham số tùy chọn

quality'1k' | '2k' | '4k'

Cấp độ phân giải đầu ra. Mặc định: 1k

sampleCountinteger

Số lượng biến thể hình ảnh cần tạo cho mỗi yêu cầu. Phải nằm trong khoảng từ 1 đến 4. Mặc định: 1

ratiostring

Ghi đè tỷ lệ khung hình. Nếu để trống, hệ thống sẽ mặc định là 1:1 (lý tưởng cho Instagram/nguồn cấp dữ liệu xã hội).

Các giá trị được hỗ trợ: '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.

Lỗi thời gian chạy

Các lỗi thời gian chạy cho tính năng này sử dụng bộ lỗi chung được ghi lại trong Xử lý lỗi. Nếu lỗi xảy ra trong quá trình xử lý, status sẽ cập nhật thành "error" và trường error sẽ chứa lý do lỗi cụ thể.

Chi phí tín dụng

Đối với các yêu cầu API dành cho nhà phát triển, chi phí phụ thuộc vào cấp độ quality đầu ra đã chọn nhân với sampleCount.

Công thức: Chi phí = Tín dụng chất lượng × sampleCount

Cấp độ chất lượng	Tín dụng mỗi hình ảnh
1k (Mặc định)	2
2k	3
4k	5