소개
이 엔드포인트의 기능을 소개합니다
Recraft 20B를 SVG 모드로 호출하고 벡터 파일 1개를 반환합니다.
주요 입력 항목을 소개합니다
prompt는 대상을 지정합니다. style은 21가지 스타일 중 하나를 선택합니다(기본값: vector_illustration). aspect_ratio는 1:1, 16:9, 9:16, 4:3, 3:4 중에서 선택합니다.
반환 결과를 소개합니다
.svg 파일 1개를 반환합니다(MIME image/svg+xml).
| 항목 | 값 |
|---|---|
| 입력 | 텍스트 |
| 출력 | 이미지 |
| 스타일 | 21가지(아이콘 10가지, 일러스트 11가지) |
| 화면 비율 | 1:1, 16:9, 9:16, 4:3, 3:4 |
핵심 기능 및 하이라이트
하나의 모델로 두 가지 아이콘 스타일을 구현합니다
왼쪽은 icon/colored_outline 스타일의 커피잔입니다. 14개의 경로로 갈색 윤곽선과 부드러운 채색을 표현합니다. 오른쪽은 icon/outline 스타일의 산과 태양을 그린 여행 아이콘으로, 13개의 경로가 선만으로 이루어져 있습니다. 세트 전체에 같은 스타일을 적용하면 일관된 아이콘을 만들 수 있습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 특히 아이콘은 대상을 하나로 정하면 더 명확하게 표현됩니다. 김이 나는 커피잔이나 떠오르는 태양을 배경으로 한 산이 좋은 예입니다. 1자 이상 · 1000자 이하 |
style | 아니요 | 아이콘 스타일 10가지(outline, |
aspect_ratio | 아니요 | 아이콘에는 1:1(기본값)을, 배너와 장면에는 16:9, 9:16, 4:3 또는 3:4를 사용합니다. 추가 비용 없이 SVG 캔버스의 형태를 설정합니다. |
요금
$0.053 / SVG
전달된 아이콘이나 일러스트마다 스타일 및 비율과 관계없이 정해진 요금을 청구합니다. 생성에 실패하면 요금을 청구하지 않습니다.
활용 사례
앱과 웹사이트용 아이콘 세트를 만듭니다
메뉴, 기능, 빈 상태를 위한 아이콘을 하나의 스타일로 생성한 다음 인터페이스에 맞게 색상을 바꿉니다.
블로그와 소셜 미디어용 이미지를 빠르게 만듭니다
게시물이나 뉴스레터에 넣을 작은 만화풍 또는 귀여운 일러스트를 몇 초 만에 만듭니다.
공예와 인쇄 작업에 활용합니다
선화, 판화, 리놀륨 판화 스타일을 스티커, 도장, 커팅 머신, 인쇄 카드에 활용합니다.
프롬프트 가이드 및 실전 팁
스타일을 선택합니다
UI 아이콘에는 icon/* 스타일을, 장면에는 vector_illustration/* 스타일을 선택합니다. 기본값은 vector_illustration입니다.
하나의 대상을 설명합니다
아이콘은 대상을 하나로 정할 때 가장 좋은 결과를 얻습니다. 김이 나는 커피잔이나 떠오르는 태양을 배경으로 한 산 등이 적합합니다.
SVG를 받습니다
작업 상태를 주기적으로 확인하고 .svg를 다운로드한 뒤 디자인 도구나 코드에 추가합니다.
개요를 소개합니다
Recraft 20B SVG는 벡터 아이콘과 일러스트를 빠르고 저렴하게 생성합니다. 스타일을 말로 설명하는 대신 이름이 정해진 21가지 스타일 중에서 선택합니다.
주요 기능과 장점을 소개합니다
21가지 스타일을 제공합니다
아이콘 스타일에는 outline, broken_line, colored_outline, colored_shapes, colored_shapes_gradient, doodle_fill, doodle_offset_fill, offset_fill, outline_gradient, uneven_fill이 있습니다. 일러스트 스타일에는 cartoon, doodle_line_art, engraving, flat_2, kawaii, line_art, line_circuit, linocut, seamless가 있습니다.
빠르게 생성합니다
테스트에서는 생성마다 약 11초가 걸려 아이콘 일괄 작업에도 적합했습니다.
파일 크기가 작습니다
생성된 아이콘의 크기는 20–25KB였습니다.
활용 사례를 소개합니다
제품용 아이콘 라이브러리를 만듭니다
탐색, 설정, 기능 목록을 위한 일관된 아이콘 세트를 생성합니다.
콘텐츠에 일러스트를 추가합니다
기사, 뉴스레터, 슬라이드에 만화풍 또는 귀여운 이미지를 추가합니다.
스티커와 도장에 활용합니다
리놀륨 판화, 판화, 선화를 인쇄와 커팅 머신에 활용합니다.
프롬프트 작성법과 실용 팁을 소개합니다
아이콘당 하나의 대상을 사용합니다
떠오르는 태양을 배경으로 한 산처럼 짧은 프롬프트를 사용하면 긴 장면 설명보다 깔끔한 아이콘을 얻습니다.
세트 전체의 스타일을 통일합니다
한 세트의 모든 아이콘에 같은 style 값을 사용합니다.
아이콘의 글자는 나중에 추가합니다
이 모델은 글자 표현에 약합니다. 라벨은 디자인 도구에서 추가합니다.
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/20b-svg/text-to-image",
"input": {
"style": "vector_illustration",
"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 레퍼런스에서 확인하세요.
