Tạo ảnh từ ảnh

Gửi tác vụ tạo ảnh từ ảnh bằng Soul 2 với ảnh tham chiếu công khai và lời nhắc.

POST/higgsfield-ai/soul/v2/image-to-image

Gửi ảnh tham chiếu và yêu cầu chỉnh sửa. Lưu request_id trả về để kiểm tra trạng thái và lấy ảnh.

Xác thực

bearerAuth

Xác thựcBearer <token>

Vị trí truyền: header

Nội dung yêu cầu

application/json

Định nghĩa kiểu TypeScript

Sử dụng kiểu request body trong TypeScript.

prompt*Prompt

Mô tả ảnh cần tạo hoặc thay đổi muốn áp dụng cho ảnh tham chiếu.

image_url*string

URL ảnh tham chiếu có thể truy cập công khai. Có thể dùng images[].url từ tác vụ tạo ảnh từ văn bản đã hoàn tất.

Định dạnguri

resolution?Resolution

Mức độ phân giải đầu ra.

Giá trị mặc định"720p"

Giá trị được phép

"720p"
"1080p"

aspect_ratio?AspectRatio

Tỷ lệ khung hình của ảnh đầu ra.

Giá trị mặc định"4:3"

Giá trị được phép

"9:16"
"16:9"
"4:3"
"3:4"
"1:1"
"2:3"
"3:2"

Nội dung phản hồi

`application/json`

curl -X POST "https://example.com/higgsfield-ai/soul/v2/image-to-image" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Đổi hoa tulip trắng thành màu tím nhạt, giữ nguyên bàn gỗ, ánh sáng cửa sổ và bố cục.",
    "image_url": "https://example.com/tulips.jpg",
    "resolution": "720p",
    "aspect_ratio": "1:1"
  }'

{
  "request_id": "REQUEST_ID",
  "status": "queued",
  "expires_after": 604800
}

Có thể điền images[].url do tác vụ tạo ảnh từ văn bản trả về vào image_url. Dùng request_id của lần gửi này trong Truy vấn tác vụ để lấy kết quả.

Higgsfield Soul 2 Tạo ảnh từ ảnhXem ảnh tham chiếu và tham số yêu cầu của API gốc.

Xác thực

Nội dung yêu cầu

Nội dung phản hồi

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`