유료 계정 필요
색상 팔레트 일괄 추출
여러 이미지의 대표 HEX 색상을 순서가 있는 JSON으로 추출합니다.
POST /api/free/batch-color-palette색상 팔레트 일괄 추출 온라인 사용
일괄 선택에는 API 키 입력이 없지만 실행하려면 유료 계정으로 로그인해야 합니다.
유료 접근 · 키 입력 없음
1. 업로드 및 설정
API 키 없이 사용할 수 있습니다. 파일은 실행할 때만 전송됩니다.
이미지 파일 *
색상 수
필수 항목을 입력하면 실행할 수 있습니다.POST /api/free-online/batch-color-palette
2. 미리보기 및 다운로드
결과가 여기에 표시됩니다
미리보기, 크기 변화와 다운로드 버튼이 여기에 표시됩니다
이 일괄 API가 적합한 경우
색상 팔레트 일괄 추출는 결정론적 다중 파일 워크플로입니다. 여러 이미지의 대표 HEX 색상을 순서가 있는 JSON으로 추출합니다.
주요 워크플로
- 여러 이미지의 대표 HEX 색상을 순서가 있는 JSON으로 추출합니다.
- 각 이미지를 같은 색상 수로 독립 분석합니다.
- JSON에 HEX, 비율과 개별 오류가 포함됩니다.
- 01색상 팔레트 일괄 추출에서 처리할 이미지를 업로드합니다.
- 02전체 일괄 작업에 적용할 공통 설정을 선택합니다.
- 03실행 후 파일별 상태를 확인하고 ZIP 또는 JSON을 받습니다.
files 필드를 반복 전송하고 이미지 파일, 색상 수을 설정합니다. 각 이미지를 같은 색상 수로 독립 분석합니다.
API로 연동
일괄 API는 유료 계정의 키가 필요하며 한 번의 일괄 작업을 요청 1회로 계산합니다.
API 엔드포인트
POST /api/free/batch-color-palette유료 계정의 APIAny 키를 사용하세요. API 요청당 최대 20개 파일, 총 100 MB입니다.
작동 방식
- 각 이미지를 같은 색상 수로 독립 분석합니다.
- JSON에 HEX, 비율과 개별 오류가 포함됩니다.
응답
성공 시 이 페이지에 설명된 Content-Type의 json 응답을 반환합니다.
일반 오류
- 400
- 파일이나 매개변수가 없거나 잘못되었거나 제한을 벗어났습니다.
- 401
- 프로그램 호출용 키가 없거나 잘못되었거나 비활성화되었습니다.
- 429
- 온라인 또는 인증 호출의 공유 제한에 도달했습니다.
매개변수와 제한
| 매개변수 | 요구 사항 | 기본값 | 허용 값 |
|---|---|---|---|
files이미지 파일 | 필수 | — | file |
count색상 수 | 선택 | 5 | 3, 4, 5, 6, 7, 8 |
API 예제
아래는 코드용 인증 예제입니다. 위 Playground는 API 키를 요구하거나 노출하지 않습니다.
curl -X POST "https://apiany.ai/api/free/batch-color-palette" \ -H "Authorization: Bearer $API_KEY" \ -F "files=@a.png" \ -F "files=@b.jpg" \ -F "count=5"
자주 묻는 질문
누가 색상 팔레트 일괄 추출를 실행할 수 있나요?
온라인 실행과 API에는 유료 계정이 필요합니다.
색상 팔레트 일괄 추출의 파일 한도는?
온라인 10개/50 MB, API 20개/100 MB, 파일당 30 MB입니다.
색상 팔레트 일괄 추출의 반환 형식은?
JSON. JSON에 HEX, 비율과 개별 오류가 포함됩니다.
파일 하나가 실패하면 색상 팔레트 일괄 추출가 중단되나요?
중단되지 않으며 성공 결과는 유지됩니다.
출처: APIAny 무료 API 카탈로그와 실제 라우트 동작. 검토일: 2026-07-17.