PixVerse Image 매개변수 및 API 차이
PixVerse 이미지 템플릿 선택과 비동기 생성 방식을 알아봅니다.
API 구조는 이미지 생성 및 작업 조회를 참조하세요.
이미지 템플릿 생성
| 항목 | 설명 |
|---|---|
| 서비스 이름 | pixverse-image-template은 이미지 템플릿 생성 기능입니다. 요청 본문에 model을 입력할 필요가 없습니다. |
| 템플릿 선택 | 효과 템플릿 목록 조회에서 type=2로 이미지 템플릿을 조회한 뒤 이름, 효과 미리보기 및 입력 요건에 따라 선택하세요. 사용 가능한 템플릿은 목록 갱신에 따라 바뀝니다. |
| 입력 자료 | 이미지 업로드로 이미지 ID를 받으세요. 단일 이미지 또는 여러 이미지의 사용 여부와 입력 순서는 템플릿이 결정합니다. 영상 템플릿을 이미지 생성에 직접 사용할 수 없습니다. |
| 생성 방식 | 선택한 템플릿으로 이미지를 처리합니다. 현재 생성 API는 자유 형식 프롬프트, 이미지 크기 또는 모델 버전 선택을 제공하지 않습니다. |
| 결과 조회 | 생성 시에는 작업 정보만 반환됩니다. 이후 이미지 작업을 조회하여 성공하면 이미지 URL을 받으세요. |
ID 대응 관계
| 필드 | 출처와 용도 |
|---|---|
img_id | 업로드 시 반환되는 자료 ID입니다. 순서대로 생성 요청의 img_ids를 구성합니다. |
template_id | 템플릿 목록에서 반환되는 이미지 템플릿 ID이며 생성 효과와 입력 요건을 결정합니다. |
image_id | 생성 시 반환되는 이미지 작업 ID입니다. 조회 API의 task_id에 입력합니다. |
정밀도 손실을 방지하도록 ID를 읽고 전달할 때 모든 숫자를 보존하세요. 자료, 템플릿 및 작업 ID는 서로 바꿔 쓸 수 없습니다.