APICK 이미지 API로 포스터 시안 만들기: 4장 배치와 중복 과금 방지

10월 11, 2026

하나의 이미지 생성 요청을 네 장의 포스터 시안과 작업 상태 관리로 연결한 개념도 — 포스터 시안과 작업 상태를 표현한 AI 생성 개념 이미지입니다. 실제 APICK API 실행 결과가 아닙니다.

확인일: 2026-10-11 · 공식 공개 문서 기반 · 아래 코드는 실행하지 않은 연동 예제입니다. 실제 키·고객 데이터는 포함하지 않았습니다.

한 상품의 포스터 시안을 예산 안에서 비교하기

신제품 포스터를 만들 때 처음부터 완성본 한 장에 모든 결정을 몰아넣기보다, 배경·구도·조명을 달리한 시안을 비교하는 편이 편집 방향을 잡기 쉽습니다. 이 글에서는 가상의 텀블러를 위한 이미지 시안을 예로 들어 APICK 이미지 API의 접수·결과 확인·비용 관리를 정리합니다.

품질 옵션과 장당 비용

공식 SDK와 MCP 카탈로그는 quality를 basic 40P, advanced 350P, premium 1,400P로 안내합니다. 동기 SDK 요청은 1~4장, 작업형 요청은 최대 50장입니다. 아래 예제는 basic 4장을 요청하므로 접수 기준 160P입니다. 생성 실패분은 환급된다고 안내하며, 접수된 작업은 취소할 수 없습니다. 이미지 생성 안내

확인한 SDK는 model 옵션을 받지 않고 quality에 low도 허용하지 않습니다. APICK의 basic을 OpenAI의 GPT Image 2 low와 동일하다고 단정할 근거는 확인하지 못했습니다. 특정 모델 사용을 필수 조건으로 두는 제작은 실행 전에 공급자에게 모델 계약을 확인해야 합니다. 현재 이미지 옵션 검증 코드

배치 작업 접수 예제

curl --fail-with-body --request POST https://apick.app/rest/image-generation/jobs/generate \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string 'prompt=가상의 무광 흰색 텀블러 포스터 시안. 옅은 파란 배경, 부드러운 측면광, 제품 전체 표시, 상단 제목 여백, 글자와 로고 없음.' \
  --form-string 'image_count=4' \
  --form-string 'quality=basic' \
  --form-string 'size=1024x1536' \
  --form-string 'output_format=png'

import { ApickClient } from 'apick-api';
const client = new ApickClient(process.env.APICK_API_KEY);
const created = await client.createImageGenerationJob(
  '가상의 흰색 텀블러. 파란 배경, 부드러운 측면광, 제목 여백, 글자 없음.',
  { imageCount: 4, quality: 'basic', size: '1024x1536', outputFormat: 'png' }
);
const jobId = created.data.job_id;
console.log({ jobId }); // DB에 저장한 뒤 같은 ID로 상태를 확인합니다.
const snapshot = await client.getImageJob(jobId);
console.log(snapshot.data);
// 결과 준비를 확인한 뒤에만 호출할 별도 다운로드 단계:
// const file = await client.downloadImageJobImage(jobId, 0);
// await file.save('./poster-01.png');

상태 조회와 재전송은 다른 동작입니다

상태 확인은 GET /rest/image-generation/jobs/{job_id}, 개별 파일은 같은 경로 아래 /images/{index}, 묶음은 /result 경로로 구분됩니다. 접수 ID를 저장하고 조회만 반복하는 작업 큐를 두세요. 이 글은 문서만 검토했으므로 상태 응답의 모든 종료값을 추정해 자동 폴링 코드에 넣지 않았습니다. 최신 명세의 완료·실패값을 확인한 다음 종료 조건을 구현하세요.

특히 README에는 idempotencyKey 설명이 있지만 확인한 SDK 소스는 이미지 요청에서 이 값을 전송하지 않습니다. 응답이 늦다고 생성 요청을 다시 보내면 중복 제작·과금될 수 있습니다. 작업 ID를 받은 뒤에는 조회로 복구하고, 접수 결과 자체가 불명확하면 사용 내역과 지원 채널에서 먼저 확인하세요.

시안 비교를 위한 실무 기준

첫 단계에는 문구 없는 배경·상품 구도만 검토합니다. 가격·행사 기간·정확한 로고는 편집 단계에서 넣고 확인합니다.
실제 상품과 다른 손잡이·버튼·소재가 생성되었는지 봅니다. 참고 이미지를 사용할 때는 사용 권한이 있는 자료만 전송합니다.
작은 모바일 썸네일에서도 제품과 제목 영역이 구분되는지 확인합니다.
포인트 예산에는 첫 생성뿐 아니라 후보 탈락 후의 재생성도 포함합니다.

FAQ와 시작점

20장 basic 시안은 얼마인가요? 안내된 장당 요금으로 접수액은 800P입니다. 가격·세금·환급 조건은 실행 화면에서 다시 확인하세요. 결과는 계속 보관되나요? 공식 안내는 완료 후 24시간 다운로드를 설명합니다. 필요한 결과는 해당 기간에 자체 저장소로 옮기는 운영 절차를 마련하세요.

공식 문서에서 다음 단계 확인하기

구현 전 현재 옵션·요금을 다시 확인하세요. 공식 이미지 SDK 안내 · REST 경로·옵션 구현 · MCP 이미지 카탈로그 · 이미지 개발가이드

#APICK #이미지API #포스터제작 #AI이미지

이 블로그 검색

apick