이미지로 이미지 생성

공개 참조 이미지와 프롬프트로 Soul 2 이미지 기반 생성 작업을 제출합니다.

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

참조 이미지와 편집 지시를 제출합니다. 반환된 request_id를 저장하여 상태를 조회하고 이미지를 가져옵니다.

인증

bearerAuth

인증Bearer <token>

전달 위치: header

요청 본문

application/json

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

prompt*Prompt

생성할 이미지 또는 참조 이미지에 적용할 변경 사항을 설명합니다.

image_url*string

공개적으로 접근 가능한 참조 이미지 URL입니다. 완료된 텍스트 기반 생성 작업의 images[].url을 사용할 수 있습니다.

형식uri

resolution?Resolution

출력 해상도 단계입니다.

기본값"720p"

허용 값

"720p"
"1080p"

aspect_ratio?AspectRatio

출력 이미지의 가로세로 비율입니다.

기본값"4:3"

허용 값

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

응답 본문

`application/json`

curl -X POST "https://example.com/higgsfield-ai/soul/v2/image-to-image" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "나무 테이블, 창문 빛, 구도를 유지하면서 흰 튤립을 연보라색으로 바꿔 주세요.",
    "image_url": "https://example.com/tulips.jpg",
    "resolution": "720p",
    "aspect_ratio": "1:1"
  }'

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

텍스트 기반 생성 작업이 반환한 images[].url을 image_url에 입력할 수 있습니다. 이번 제출에서 받은 request_id로 작업 조회에서 결과를 가져옵니다.

Higgsfield Soul 2 이미지로 이미지 생성네이티브 API의 참조 이미지와 요청 매개변수를 확인합니다.

인증

요청 본문

응답 본문

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`