Wprowadzenie
Działanie tego endpointu
Generowany jest jeden SVG z promptu tekstowego przy użyciu Ideogram Vector 1.0. Plik składa się ze ścieżek i gradientów, więc można go dowolnie skalować i otwierać jako edytowalne kształty.
Najważniejsze dane wejściowe
prompt opisuje projekt. quality pozwala wybrać low, medium lub high. aspect_ratio określa kształt obszaru roboczego spośród 17 proporcji. reference_image_urls jest opcjonalne: do pięciu obrazów wpływających na styl.
Co otrzymasz
Jeden plik .svg na żądanie (MIME image/svg+xml).
| Pole | Wartość |
|---|---|
| Wejście | Tekst |
| Wyjście | Obraz |
| Format wyjściowy | SVG (ścieżki, gradienty liniowe i radialne) |
| Źródło wektoryzacji | JPEG, PNG lub WebP, do 50 MB |
| Długość promptu | Do 9,500 znaków |
| Obrazy referencyjne | Do 5 przy generowaniu grafiki |
Najważniejsze funkcje
Portret w kawiarni odtworzony z płaskich plam koloru
Zwektoryzowaliśmy zdjęcie 1024×1536 z ustawieniem detailed. SVG zawierał około 2,000 ścieżek i 580 gradientów. Włosy, dzianina i światło z okna zmieniły się w plakatowe plamy barwne, które zachowały czytelność oryginalnej sceny. Plik miał około 2 MB.
Płaska ikona PNG zmienia się w 17 czystych ścieżek
Ikona filiżanki kawy wyeksportowana do PNG wróciła jako SVG o rozmiarze 6 KB. Kontury, smugi pary i emblemat liścia odpowiadają bitmapie. Każdy kształt to osobna ścieżka, więc do zmiany koloru wystarczy jedno kliknięcie w edytorze wektorowym.
simple łączy małe kształty
Po lewej jest oryginał, pośrodku wynik simple, po prawej detailed. simple zmniejszył liczbę ścieżek z około 2,000 do poniżej 1,000, a rozmiar pliku z 2 MB do 1.1 MB. Krawędzie włosów i swetra zmieniły się w większe plamy.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Opisz temat, styl (płaski, rysunek liniowy, geometryczny), kolory i tekst do umieszczenia. Wybieraj krótkie napisy: od jednego do trzech słów daje pewniejszy wynik niż całe zdanie. od 1 znaków · do 9500 znaków |
quality | Nie | low, medium (domyślnie) lub high. Wyższe poziomy dodają szczegóły i wymagają więcej czasu; każdy ma własną cenę za SVG. |
aspect_ratio | Nie | Proporcje obszaru wektorowego, od pionowego 1:4 do poziomego 4:1; domyślnie 1:1. Ustawiane są proporcje viewBox, a nie rozmiar w pikselach, ponieważ SVG można swobodnie skalować. |
reference_image_urls | Nie | Opcjonalnie do pięciu obrazów JPEG, PNG lub WebP, każdy do 10 MB, jako odniesienie dla stylu i kompozycji. Pierwszy ma największą wagę. do 5 elementów |
Cennik
Każdy gotowy SVG jest rozliczany raz, według stawki dla jego poziomu jakości. Obrazy referencyjne zwiększają stawkę tylko przy high. Za żądania nieudane lub bez wyniku SVG nie jest naliczana opłata.
| With references | Jakość: low | Jakość: medium | Jakość: high |
|---|---|---|---|
| $0.174 / obraz | $0.216 / obraz | $0.264 / obraz |
| $0.174 / obraz | $0.216 / obraz | $0.432 / obraz |
Zastosowania
Logo i znaki marki z napisami
Poproś o znak z krótką nazwą i zachowaj litery jako kontury wektorowe, ostre zarówno na wizytówce, jak i na szyldzie.
Odzyskaj logo w niskiej rozdzielczości
Zamień stare logo PNG lub JPEG w SVG, aby wydrukować je w dużym formacie, zmienić kolory lub przekazać do drukarni.
Plakaty, naklejki i pliki do cięcia
Wygeneruj plakat lub naklejkę z kształtów albo zwektoryzuj grafikę dla ploterów tnących, grawerek laserowych i programów hafciarskich wymagających wektorów.
Wskazówki
Wybierz rodzaj zadania
Prześlij prompt dla nowego projektu (text-to-image) lub
image_urldo wektoryzacji istniejącego obrazu (edit). Żądania zimage_urlsą automatycznie kierowane do wektoryzacji.Wybierz ustawienia
Dla nowej grafiki wybierz quality i
aspect_ratiooraz opcjonalnie do pięciu obrazów referencyjnych. Dla wektoryzacji wybierzdetail_level: detailed lub simple.Pobierz SVG
Sprawdzaj status zadania i pobierz plik .svg z pamięci platformy. Otwórz go w Figma, Illustrator lub Inkscape, aby od razu edytować ścieżki i wypełnienia.
Wprowadzenie
Funkcja tekstu do SVG w Ideogram Vector 1.0 tworzy nowy plik wektorowy na podstawie opisu. Sprawdza się przy logo, emblematach, plakatach, naklejkach i prostych ilustracjach, które muszą zachować ostrość w każdym rozmiarze.
Najważniejsze funkcje i zalety
Natywny wynik wektorowy
Zwracane są elementy ścieżek i gradientów, bez obrazu umieszczonego w opakowaniu SVG. Otwórz plik w Figma, Illustrator lub Inkscape, aby zaznaczyć dowolny kształt.
Czytelne litery
Ideogram jest znany z typografii. W naszych próbach krótkie napisy, takie jak FOXTROT i NORTH SHORE, były zapisane poprawnie i wkomponowane w układ.
Trzy poziomy i 17 proporcji
low służy do szybkich szkiców, medium do większości zadań, a high do uzyskania największej liczby detali. Obszar roboczy obejmuje proporcje od pionowego 1:4 do poziomego 4:1.
Zastosowania
Zaprojektuj znak marki
Wygeneruj kilka koncepcji logo, a wybraną dopracuj w edytorze wektorowym.
Plakaty dla wydarzeń i sklepów
Stwórz plakat z nagłówkiem, który wydrukujesz w A2 bez widocznych pikseli.
Naklejki i gadżety
Twórz projekty do cięcia folii, sitodruku lub haftu, gdzie potrzebne są pliki wektorowe.
Poradnik pisania promptów i wskazówki
Dokładnie opisz styl
Określenia takie jak płaski, geometryczny, rysunek liniowy, dwukolorowy czy emblemat pomagają uzyskać proste, edytowalne kształty.
Zapisz tekst w cudzysłowie lub wielkimi literami
Podaj dokładny napis i ogranicz go do kilku słów.
Wymień kolory
Nie ma sterowania paletą, więc wpisz kolory w prompcie, na przykład granatowy i brzoskwiniowy.
Szybki start z 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"
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.
