소개
이 엔드포인트의 기능
Recraft V4에 프롬프트를 보내 네이티브 SVG 하나를 반환합니다.
주요 입력 항목
prompt(최대 10,000자)로 디자인을 설명합니다. aspect_ratio로 캔버스 형태 7가지 중 하나를 선택하며, 기본값은 1:1입니다.
반환 결과
패스로 구성된 .svg 파일(MIME image/svg+xml) 하나를 반환합니다.
| 항목 | 값 |
|---|---|
| 입력 | 텍스트 |
| 출력 | 이미지 |
| 프롬프트 길이 | 최대 10,000자 |
| 가로세로 비율 | 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 |
핵심 기능 및 하이라이트
여우 마크와 베이커리 배지를 모두 편집할 수 있습니다
왼쪽은 도형 18개로 구성된 2색 여우 마크입니다. 오른쪽은 Rise & Crumb 글자를 밀 이삭으로 둘러싼 빈티지 베이커리 배지로, 크림색과 갈색 도형 124개로 구성됩니다. 두 파일 모두 벡터 편집기에서 열렸으며 모든 요소를 개별적으로 선택할 수 있었습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 주제, 형식(로고 마크, 배지, 플랫 일러스트), 팔레트를 적고 로고에 넣을 글자는 ‘ ’로 묶어 작성합니다. 최대 10,000자이며 첫 문장이 가장 큰 영향을 줍니다. 1자 이상 · 10000자 이하 |
aspect_ratio | 아니요 | 1:1(기본값), 4:3, 3:4, 3:2, 2:3, 16:9 또는 9:16입니다. SVG 캔버스의 비율을 설정하며, 비율에 따라 가격이 달라지지 않습니다. |
요금
$0.096 / SVG
캔버스 비율에 관계없이 전달된 SVG마다 고정 요금을 부과합니다. 실패한 요청과 빈 결과에는 요금이 부과되지 않습니다.
활용 사례
로고 아이디어를 탐색합니다
새 제품이나 매장을 위한 마크를 여러 개 생성한 다음 가장 좋은 안을 벡터 편집기에서 마무리합니다.
플랫 스타일의 편집 삽화를 제작합니다
블로그, 랜딩 페이지, 발표 자료에 쓸 삽화를 제작합니다. 어떤 화면에서도 선명함을 유지합니다.
인쇄용 그래픽을 제작합니다
배지, 라벨, 패키지 이미지를 벡터로 제작합니다. 인쇄소에서 품질 저하 없이 크기를 조정할 수 있습니다.
프롬프트 가이드 및 실전 팁
디자인 요구사항을 작성합니다
주제, 스타일(로고 마크, 배지, 플랫 일러스트), 색상을 설명합니다. 로고에 넣을 글자는 ‘ ’로 묶어 작성합니다.
비율을 선택합니다
aspect_ratio를 선택합니다. 마크와 배지에는 1:1, 장면과 배너에는 3:2 또는 16:9가 적합합니다.
SVG를 편집합니다
.svg 파일을 다운로드한 다음 Figma, Illustrator 또는 Inkscape에서 열어 색상, 간격, 글자 모양을 조정합니다.
소개
Recraft V4 Vector는 글로 작성한 디자인 요구사항을 SVG 파일로 변환합니다. Recraft는 구도, 색상, 깔끔한 도형에 중점을 두고 디자이너를 위해 V4를 개발했습니다. 이 엔드포인트는 벡터 모드를 호출합니다.
주요 기능과 특징
깔끔한 도형을 층으로 구성합니다
도형이 개별 패스로 나뉘어 있어 다시 그리지 않고도 여우 귀의 색상을 바꾸거나 배지의 리본을 옮길 수 있습니다.
지정한 배색을 충실하게 반영합니다
테스트에서는 청록색과 코랄색, 크림색과 갈색처럼 프롬프트에 적은 팔레트가 충실하게 반영되었습니다.
디자인에 로고 문구를 넣습니다
Rise & Crumb 같은 짧은 이름을 이미지의 일부로 그려 넣습니다.
활용 사례
브랜드 아이덴티티 초안을 만듭니다
새 사업을 위한 마크와 배지를 탐색한 뒤 가장 좋은 안을 디자이너에게 전달할 수 있습니다.
웹과 앱의 일러스트를 제작합니다
어떤 화면에서도 선명한 메인 일러스트와 빈 상태 안내 일러스트를 제작합니다.
패키지와 라벨을 제작합니다
인쇄용으로 확대할 수 있는 라벨 이미지를 그립니다.
프롬프트 작성법과 실용 팁
형식부터 지정합니다
로고 마크, 엠블럼, 배지, 플랫 일러스트로 시작하면 모델이 적절한 세부 묘사 수준을 설정합니다.
마크는 단순하게 구성합니다
로고에는 평면적이거나 기하학적인 도형과 2색 또는 3색을 요청합니다.
글자를 확인합니다
철자와 간격을 확인한 뒤 필요하면 벡터 편집기에서 조정합니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "recraft/v4-vector/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.
