소개
이 엔드포인트의 기능
Ideogram Vector 1.0으로 비트맵 1개를 SVG로 변환합니다. prompt는 필요하지 않습니다.
주요 입력 항목
image_url은 이미지입니다(JPEG, PNG, WebP, 최대 50MB). detail_level은 선택 사항입니다. detailed(기본값)는 작은 도형을 유지하고 simple은 이를 합칩니다.
반환 결과
입력과 같은 비율의 .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로 줄였습니다. 머리카락과 스웨터의 경계는 더 넓은 색면이 되었습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
image_url | 예 | 최대 50MB의 JPEG, PNG, WebP를 업로드하거나 공개 HTTPS 링크를 입력하시기 바랍니다. 단색 배경 위의 평면 디자인이 가장 깔끔하게 벡터화됩니다. 1자 이상 |
detail_level | 아니요 | detailed(기본값)는 머리카락과 질감 같은 미세한 도형을 유지합니다. simple은 이웃한 영역을 더 적고 큰 도형으로 합쳐 파일을 가볍고 편집하기 쉽게 만듭니다. |
요금
$0.132 / SVG
벡터화한 파일은 세부 수준에 관계없이 동일한 요금을 적용합니다. 실패하거나 SVG를 반환하지 않은 요청에는 요금을 부과하지 않습니다.
활용 사례
글자가 포함된 로고와 브랜드 마크
마크와 짧은 이름을 요청하면 글자를 벡터 윤곽선으로 유지합니다. 명함부터 매장 간판까지 선명하게 사용할 수 있습니다.
저해상도 로고를 되살립니다
오래된 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에서 열면 패스와 채우기를 바로 편집할 수 있습니다.
소개
이미지-SVG 기능은 비트맵을 벡터 파일로 바꿉니다. 로고 스크린샷, PNG 아이콘, 사진을 보내면 크기와 색을 바꾸고 편집할 수 있는 SVG를 받습니다.
주요 기능과 장점
패스를 편집할 수 있습니다
출력은 패스 요소와 그라디언트로 구성되며 이미지가 삽입되지 않습니다. 각 색상 영역은 독립된 도형입니다.
두 가지 세부 설정을 제공합니다
detailed는 원본을 충실하게 따릅니다. simple은 작은 영역을 합쳐 양식화된 표현과 가벼운 파일에 적합합니다.
prompt가 필요하지 않습니다
이미지만 전송하면 됩니다. 벡터는 원본 비율을 유지합니다.
활용 사례
저해상도 로고를 변환합니다
작은 PNG 로고를 간판, 인쇄물, 상품에 쓸 수 있는 벡터로 바꿀 수 있습니다.
아이콘 모음을 변환합니다
비트맵 아이콘을 SVG로 바꾸면 앱과 웹사이트에서도 선명하게 사용할 수 있습니다.
사진을 예술적으로 표현합니다
인물이나 풍경 사진을 포스터 같은 벡터 일러스트로 변환할 수 있습니다.
prompt 작성 안내와 팁
선명한 원본을 사용합니다
보유한 이미지 중 가장 크고 선명한 버전을 사용하시기 바랍니다. 단색 배경이 이상적입니다. 압축 노이즈도 추가 도형으로 변환됩니다.
양식화된 표현에는 simple을 선택합니다
detailed 결과에 작은 도형이 너무 많다면 simple로 더 넓은 영역과 작은 파일을 얻을 수 있습니다.
사진은 큰 파일이 될 수 있습니다
전체 사진은 수천 개의 패스와 1–2MB 파일을 만들 수 있습니다. 아이콘은 보통 수 킬로바이트입니다.
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/edit",
"input": {
"detail_level": "detailed",
"image_url": "https://example.com/reference.png"
}
}'
# 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 레퍼런스에서 확인하세요.
