# Z Image API Z Image 텍스트-투-이미지 생성을 위한 전체 API 레퍼런스입니다。 ## 모델 변형 이 API는 한 가지 모델 변형을 지원합니다: | 모델 | ID | 설명 | |-------|-----|-------------| | **Z Image** | `z-image` | 빠른 텍스트-투-이미지 생성 | ## 빠른 비교 | 기능 | Z Image | |---------|---------| | 입력 | 텍스트 프롬프트 | | 출력 | 생성 이미지 1장 | | 화면비 | 여러 비율 지원 | | 해상도 | 너비/높이 비율 값에서 파생 | | `seed` | 선택 사항 | ### 지원되는 화면비 `width:height` 쌍은 다음 중 하나여야 합니다: `1:1`, `3:2`, `2:3`, `3:4`, `4:3`, `9:16`, `16:9`, `9:21` ## Z Image(텍스트-투-이미지) ### 엔드포인트 ``` POST /api/v1/image/task ``` ### 요청 파라미터 #### 필수 | 파라미터 | 유형 | 설명 | |-----------|------|-------------| | `model_name` | string | `"z-image"`여야 합니다 | | `prompt` | string | 이미지 생성 프롬프트 | | `width` | number | 너비 비율 값(예: `16:9`의 `16`) | | `height` | number | 높이 비율 값(예: `16:9`의 `9`) | #### 선택 사항 | 파라미터 | 유형 | 설명 | |-----------|------|-------------| | `seed` | number | `[0, 2147483647]` 범위의 랜덤 시드. 랜덤 생성에는 `null` 또는 `0`을 사용합니다. | ### 요청 예시 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'z-image', prompt: 'A cinematic portrait of a traveler standing on a cliff at golden hour', width: 16, height: 9, seed: 0 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## 응답 형식 제출 응답: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/image/{task_id}", "task_status": "submitted" } } ``` `GET /api/v1/image/{task_id}`로 폴링합니다. 작업 상태: `submitted`, `processing`, `succeed`, `failed`. 성공한 폴링 응답은 생성된 이미지 URL을 `data.task_result.images[].url` 아래에 제공합니다. ## 모범 사례 - `width`와 `height`에는 픽셀 치수가 아니라 비율 값을 사용하세요. - 프롬프트는 설명적으로 작성하되 피사체, 조명, 구도에 집중하세요. - 테스트 중 재현 가능한 생성 결과가 필요할 때 고정된 `seed`를 사용하세요.