はじめに
このエンドポイントでできること
Ideogram Vector 1.0 で、テキストの prompt から SVG を 1 つ生成します。パスとグラデーションで構成されているため、自由に拡大縮小でき、編集可能な図形として開けます。
主な入力項目
prompt でデザインを説明します。quality には low、medium、high を指定します。aspect_ratio で 17 種類の縦横比からキャンバスの形を選びます。reference_image_urls は任意で、スタイルの参考となる画像を最大 5 枚指定できます。
返却されるもの
1 回のリクエストにつき .svg ファイルを 1 つ返します（MIME image/svg+xml）。
| 項目 | 値 |
|---|---|
| 入力 | テキスト |
| 出力 | 画像 |
| 出力形式です | SVG（パス、線形・放射状グラデーション）です |
| ベクター化の入力形式です | JPEG、PNG、WebP に対応し、上限は 50 MB です |
| prompt の長さです | 最大 9,500 文字です |
| 参照画像を使えます | デザイン生成に最大 5 枚使えます |
主な機能とハイライト
カフェのポートレートを色面で再構成します
1024×1536 の写真を detailed 設定でベクター化しました。SVG は約 2,000 個のパスと 580 個のグラデーションを含み、約 2 MB になりました。髪、ニット、窓からの光は階調を整理した色面に変わり、元の場面も伝わります。
フラットな PNG アイコンが 17 個の整ったパスになります
PNG で書き出したコーヒーカップのアイコンが、6 KB の SVG になりました。輪郭、湯気の曲線、葉のマークは元のビットマップに対応しています。各図形は独立したパスなので、ベクターエディターでワンクリックで色を変えられます。
simple は小さな図形をまとめます
左が元画像、中央が simple、右が detailed の結果です。simple ではパス数が約 2,000 個から 1,000 個未満に、ファイルサイズが 2 MB から 1.1 MB に減りました。髪やセーターの細かな境界は、より大きな色面になります。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 被写体、スタイル（フラット、線画、幾何学的など）、色、入れたい文字を説明してください。文字は短くまとめるのが効果的です。 1 文字以上 · 9500 文字以内 |
quality | いいえ | low、medium（既定値）、high から選びます。上位のレベルほど細部が増え、処理に時間がかかります。 |
aspect_ratio | いいえ | ベクターのキャンバス比率を、縦長の 1:4 から横長の 4:1 まで指定します。既定値は 1:1 です。 |
reference_image_urls | いいえ | 任意で、各 10 MB までの JPEG、PNG、WebP を最大 5 枚指定できます。スタイルと構図の参考に使い、最初の画像を最も重視します。 5 件以内 |
料金
完成した SVG ごとに、品質レベルに応じた料金を 1 回課金します。参照画像によって料金が上がるのは 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 の書き方とヒント
スタイルを具体的に説明してください
フラット、幾何学的、線画、2 色、マークなどの言葉を使うと、シンプルで編集しやすい図形を生成しやすくなります。
文字を引用符で囲むか大文字で書いてください
表示したい文字を正確に書き、数語に収めてください。
色を指定してください
パレットの設定はないため、ネイビーや桃色など、希望の色を 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 リファレンスを参照してください。
