SVGジェネレーターIdeogram Vector 1.0 について
プロンプトや画像からSVG、文字もきれい。
POST /jobs/createTask でモデル名に ideogram/vector-1/edit を指定すれば呼び出せます。$0.132から。
はじめに
Image to SVG はビットマップを受け取り、ベクターファイルを返します。ロゴのスクリーンショット、アイコンの PNG、写真などを送ると、拡大縮小・色変更・編集が自由に行える SVG が返ります。
主な特長
編集可能なパス
出力は path 要素とグラデーションで構成され、画像は埋め込まれません。色の領域ごとに独立した図形になります。
2 つの細かさ設定
Detailed は元画像に忠実に従います。Simple は小さな領域を統合するため、様式化された表現や軽いファイルに適しています。
プロンプト不要
画像そのものがリクエストの全てです。ベクター結果は元の縦横比を保ちます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
detail_level | いいえ | detailed は細かい形状を残し、simple は形状をまとめて少なく大きな塊にします。どちらも料金は同じです。 detailed · simple · デフォルト: detailed |
image_url | はい | 出発点になる画像。 |
料金
料金は米ドル表示です。API は専用の米ドル残高を使用します。サイトのクレジットは API で使えず、API 残高との相互振替もできません。 タスクの受理時に、見積もりの上限額を API 残高から確保します。完了後は実際の使用量で精算し、確保額を超える請求はせず、差額を解放します。タスクが失敗した場合は確保額を解放します。
| オプション | USD /枚 |
|---|---|
| 標準 | $0.132 |
実行前に同じリクエスト本文を POST /jobs/quote に送ると、想定料金と上限額を米ドルで確認できます。見積もりではタスクの実行も課金も行いません。
活用シーン
低解像度のロゴ
小さな PNG ロゴをベクターに変換し、看板、印刷物、グッズに使えます。
アイコンセット
ビットマップのアイコンを SVG に変換すれば、アプリや Web サイトでも鮮明さを保てます。
プロンプトガイドと上級者向けのコツ
きれいな元画像を使う
手元にある最も大きく鮮明なものを、できれば無地の背景で使ってください。圧縮によるアーティファクトは余計な図形になります。
様式化された作品には Simple を
Detailed の結果に小さな図形が多すぎる場合は、Simple で大まかな領域と小さいファイルにしてください。
写真は大きなファイルになる
写真全体では数千のパスが生成され、ファイルサイズが 1〜2 MB になることがあります。アイコンは通常数 KB です。
API クイックスタート
Ideogram Vector 1.0 API を 3 ステップで呼び出す
- API キーを作成する. PopNow にログインし、API コンソールでキーを作成します。キーは sk-popnow- で始まり、API 呼び出しには専用の米ドル残高を使用します。
- リクエストを送る. POST /jobs/createTask に、model を ideogram/vector-1/edit、input をパラメーター表どおりにして送ります。レスポンスですぐにタスク ID が返ります。
- 結果を受け取る. タスク ID で GET /jobs/recordInfo をポーリングするか、callBackUrl を渡せば結果がそこへ送られます。タスクが成功したら出力リンクからダウンロードします。
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "ideogram/vector-1/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"detail_level": "detailed"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"プロンプトとリンクはご自身のものに置き換えてください。API タブにレスポンス、ポーリング、コールバックのリファレンスがあります。
Ideogram Vector 1.0 API についての質問
Ideogram Vector 1.0 API の料金はいくらですか？
Ideogram Vector 1.0の最安は画像をSVGにで、$0.132/枚からです。API は専用の米ドル残高を使用します。サイトのクレジットは API で使えず、API 残高との相互振替もできません。 タスクの受理時に、見積もりの上限額を API 残高から確保します。完了後は実際の使用量で精算し、確保額を超える請求はせず、差額を解放します。タスクが失敗した場合は確保額を解放します。
API でのIdeogram Vector 1.0のモデル名は？
POST /jobs/createTask の model フィールドに 画像をSVGには ideogram/vector-1/edit；SVGジェネレーターは ideogram/vector-1/text-to-image を指定します。
出力は本物のベクターですか、それとも画像を SVG に入れたものですか？
実際のベクターデータです。テストしたファイルはすべて path、gradient、stop 要素だけで構成され、画像の埋め込みはありませんでした。納品時にも各出力を検査し、ビットマップを含む SVG は受け付けません。
ロゴにはどの詳細度を使えばよいですか？
まず detailed をお試しください。フラットなアイコンでは両方の設定で同一のファイルが得られました。違いが出るのは写真や複雑なデザインです。simple は小さな図形を大きな領域にまとめ、ファイルサイズをおよそ半分にします。
参照画像は何に使いますか？
スタイルと構図を指定する手がかりになり、最初の画像が最も強く反映されます。各 10 MB までの画像を最大 5 枚添付できます。prompt 内で画像を名指しする必要はありません。
SVG、PDF、AI ファイルをアップロードしてベクター化できますか？
対応していません。ベクター化に使えるのは 50 MB までの JPEG、PNG、WebP です。既存のベクターを整える場合は、エディターで開いて編集してください。
Ideogram Vector 1.0 API の制限は？
アップロードの上限：50 MB。この範囲を超えるリクエストは、課金される前に拒否されます。
コードを書かずにIdeogram Vector 1.0を試せますか？
API キーなしで、API の米ドル残高を使って Playground から Ideogram Vector 1.0 を実行できます。各実行は対応するコードとともに開発者の履歴に記録されます。