소개
이 엔드포인트의 기능
Ideogram Vector 1.0으로 텍스트 prompt에서 SVG 1개를 생성합니다. 패스와 그라디언트로 이루어져 있어 크기를 자유롭게 조절하고 편집 가능한 도형으로 열 수 있습니다.
주요 입력 항목
prompt는 디자인을 설명합니다. quality는 low, medium, high 중에서 선택합니다. aspect_ratio는 17가지 비율 중 캔버스 모양을 지정합니다. reference_image_urls는 선택 사항이며, 스타일을 안내할 이미지를 최대 5개 지정합니다.
반환 결과
요청당 .svg 파일 1개를 반환합니다(MIME image/svg+xml).
| 항목 | 값 |
|---|---|
| 입력 | 텍스트 |
| 출력 | 이미지 |
| 벡터화 입력 | JPEG, PNG, WebP, 최대 50MB |
| prompt 길이 | 최대 9,500자 |
| 참조 이미지 | 디자인 생성에 최대 5개 |
핵심 기능 및 하이라이트
카페 인물 사진을 평면 색 도형으로 재구성합니다
1024×1536 사진을 detailed 설정으로 벡터화했습니다. SVG는 약 2,000개의 패스와 580개의 그라디언트로 구성되었으며 크기는 약 2MB였습니다. 머리카락, 니트, 창문 빛은 원래 장면이 드러나는 포스터풍 색면으로 바뀌었습니다.
평면 PNG 아이콘을 깔끔한 패스 17개로 변환합니다
PNG로 내보낸 커피잔 아이콘이 6KB SVG로 변환되었습니다. 윤곽선, 굽이치는 김, 잎 모양 배지가 원본 비트맵과 일치합니다. 각 도형이 별도의 패스이므로 벡터 편집기에서 한 번 클릭해 색을 바꿀 수 있습니다.
simple은 작은 도형을 합칩니다
왼쪽은 원본, 가운데는 simple 결과, 오른쪽은 detailed 결과입니다. simple은 패스 수를 약 2,000개에서 1,000개 미만으로, 파일 크기를 2MB에서 1.1MB로 줄였습니다. 머리카락과 스웨터의 경계는 더 넓은 색면이 되었습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 대상, 스타일(평면, 선화, 기하학적 형태), 색상, 넣을 문구를 설명하시기 바랍니다. 문구는 짧을수록 좋습니다. 1자 이상 · 9500자 이하 |
quality | 아니요 | low, medium(기본값), high 중에서 선택합니다. 높은 수준일수록 디테일이 늘고 시간이 더 걸리며, SVG당 요금도 각각 다릅니다. |
aspect_ratio | 아니요 | 벡터 캔버스의 모양을 세로형 1:4부터 가로형 4:1까지 지정합니다. 기본값은 1:1입니다. |
reference_image_urls | 아니요 | 선택 사항으로 각각 최대 10MB인 JPEG, PNG, WebP를 최대 5개 지정합니다. 스타일과 구도의 참고 자료로 사용하며 첫 번째 이미지에 가장 큰 비중을 둡니다. 5개 이하 |
요금
완성된 SVG마다 품질 수준에 따른 요금을 한 번 부과합니다. 참조 이미지는 high에서만 요금을 높입니다. 실패하거나 SVG를 반환하지 않은 요청에는 요금을 부과하지 않습니다.
| With references | 품질: low | 품질: medium | 품질: high |
|---|---|---|---|
| $0.174 / 장 | $0.216 / 장 | $0.264 / 장 |
| $0.174 / 장 | $0.216 / 장 | $0.432 / 장 |
활용 사례
글자가 포함된 로고와 브랜드 마크
마크와 짧은 이름을 요청하면 글자를 벡터 윤곽선으로 유지합니다. 명함부터 매장 간판까지 선명하게 사용할 수 있습니다.
저해상도 로고를 되살립니다
오래된 PNG 또는 JPEG 로고를 SVG로 벡터화하면 크게 인쇄하거나 색을 바꾸거나 인쇄소에 전달할 수 있습니다.
포스터, 스티커, 커팅 파일
포스터나 스티커를 도형으로 생성하거나, 벡터가 필요한 비닐 커팅기, 레이저 각인기, 자수 소프트웨어용 디자인을 벡터화합니다.
프롬프트 가이드 및 실전 팁
작업을 선택합니다
새 디자인에는 prompt를 전송합니다(text-to-image). 기존 이미지를 벡터화하려면 image_url을 전송합니다(edit). image_url이 포함된 요청은 자동으로 벡터화 처리로 연결됩니다.
설정을 선택합니다
새 디자인에는 quality와 aspect_ratio를 선택하고 필요하면 참조 이미지를 최대 5개 추가합니다. 벡터화에는 detail_level을 detailed 또는 simple로 설정합니다.
SVG를 다운로드합니다
작업 상태를 주기적으로 조회하고 플랫폼 저장소에서 .svg를 다운로드합니다. Figma, Illustrator, Inkscape에서 열면 패스와 채우기를 바로 편집할 수 있습니다.
소개
Ideogram Vector 1.0의 텍스트-SVG 기능은 설명을 바탕으로 새 벡터 파일을 그립니다. 어떤 크기에서도 선명해야 하는 로고, 배지, 포스터, 스티커, 간단한 일러스트에 적합합니다.
주요 기능과 장점
벡터를 직접 출력합니다
모델은 SVG 안에 이미지를 넣는 대신 패스와 그라디언트 요소를 반환합니다. Figma, Illustrator, Inkscape에서 열면 도형을 각각 선택할 수 있습니다.
읽기 쉬운 글자를 만듭니다
Ideogram은 타이포그래피로 잘 알려져 있습니다. 테스트에서는 FOXTROT와 NORTH SHORE 같은 짧은 문구가 정확한 철자로 생성되어 레이아웃에 배치되었습니다.
3단계 품질과 17가지 비율을 제공합니다
low는 빠른 초안, medium은 대부분의 작업, high는 세부 표현이 중요한 작업에 적합합니다. 캔버스는 세로형 1:4부터 가로형 4:1까지 지원합니다.
활용 사례
브랜드 마크를 구상합니다
여러 방향의 로고를 생성한 후 선택한 안을 벡터 편집기에서 다듬을 수 있습니다.
행사와 매장 포스터를 만듭니다
제목이 포함된 포스터를 만들어 A2 크기에서도 픽셀 깨짐 없이 인쇄할 수 있습니다.
스티커와 상품을 제작합니다
벡터 파일이 필요한 비닐 커팅, 실크스크린 인쇄, 자수용 디자인을 만들 수 있습니다.
prompt 작성 안내와 팁
스타일을 명확히 설명합니다
평면, 기하학적, 선화, 두 가지 색, 배지 등의 표현을 쓰면 단순하고 편집하기 쉬운 도형을 만드는 데 도움이 됩니다.
문구는 따옴표나 대문자로 표시합니다
넣을 문구를 ‘FOXTROT’처럼 정확히 적고 몇 단어로 짧게 제한하시기 바랍니다.
색상을 지정합니다
팔레트 설정은 없으므로 남색과 복숭아색처럼 원하는 색을 prompt에 나열하시기 바랍니다.
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": "ideogram/vector-1/text-to-image",
"input": {
"aspect_ratio": "1:1",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "medium"
}
}'
# 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 레퍼런스에서 확인하세요.
