Ideogram Vector 1.0 SVG 產生器 API：價格與程式碼

Name: Ideogram Vector 1.0 API
SKU: ideogram/vector-1/text-to-image
Price: 0.174 USD
Availability: InStock

關於 Ideogram Vector 1.0

用一句話或一張圖產出 SVG 向量，文字乾淨。

在 POST /jobs/createTask 把模型名稱填成 ideogram/vector-1/text-to-image 就能呼叫，US$0.174 起。

簡介

Ideogram Vector 1.0 Text to SVG 根據文字描述繪製一個全新的向量檔案。

主要特色

原生向量輸出

模型回傳的是 path 與漸層元素，而不是包在 SVG 外殼裡的一張圖片。

文字清楚可讀

Ideogram 以字型排版見長。在我們的測試中，FOXTROT、NORTH SHORE 這類短字拼寫正確，並且被排進版面之中。

三檔品質與 17 種比例

Low 適合快速草稿，medium 適合多數情境，high 細節最多。畫布比例從高瘦的 1:4 到寬的 4:1。

請求參數

參數	必填	說明
`aspect_ratio`	否	畫面形狀：橫式、方形或直式。 1:1 · 1:4 · 1:3 · 1:2 · 9:16 · 10:16 · 2:3 · 3:4 · 4:5 · 5:4 · 4:3 · 3:2 · 16:10 · 16:9 · 2:1 · 3:1 · 4:1 · 預設值: 1:1
`prompt`	是	描述你想做出來的內容。
`quality`	否	選擇模型提供的畫質選項，產生前請確認報價。 low · medium · high · 預設值: medium
`reference_image_urls`	否	希望結果保留的人物、服裝或場景的參考圖。

價格

價格以美元計。API 使用獨立的美元餘額。網站點數不能用於 API，也不能轉入 API 餘額；API 餘額同樣不能轉為網站點數。任務受理時，從 API 餘額中保留報價的最高金額；完成後按實際用量結算，實際扣款不超過保留金額，並釋放剩餘金額。任務失敗則釋放保留金額。

選項	USD /張
quality low · with_references false	US$0.174
quality low · with_references true	US$0.174
quality medium · with_references false	US$0.216
quality medium · with_references true	US$0.216
quality high · with_references false	US$0.264
quality high · with_references true	US$0.432

執行前，將相同請求內容傳送至 POST /jobs/quote，即可查看預估費用與最高費用，單位為美元。報價不會執行任務或扣款。

適用情境

品牌標誌起稿

產生數款 logo 方向，再到向量編輯器中細修選定的那一款。

活動與店面海報

製作標題清楚的海報，可以 A2 尺寸印刷而不失真。

貼紙與周邊商品

為刻字機、網版印刷或繡花製作設計，這些用途都需要向量檔。

提示詞指南與進階技巧

文字用引號或大寫標示

寫出你要排版的確切文字，並盡量控制在幾個字詞之內。

寫明顏色

沒有色票控制，因此請在提示詞中列出顏色，例如海軍藍與蜜桃色。

API 快速上手

三步驟呼叫 Ideogram Vector 1.0 API

建立 API 金鑰. 登入 PopNow，在 API 主控台建立金鑰。金鑰以 sk-popnow- 開頭，API 呼叫使用獨立的美元餘額。
送出請求. 對 POST /jobs/createTask 送出請求，model 填 ideogram/vector-1/text-to-image，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/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "quality": "medium",
    "aspect_ratio": "1:1"
  }
}'

# 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 產生器，US$0.174/張起。各選項價格：low · false US$0.174/張、low · true US$0.174/張、medium · false US$0.216/張、medium · true US$0.216/張。API 使用獨立的美元餘額。網站點數不能用於 API，也不能轉入 API 餘額；API 餘額同樣不能轉為網站點數。任務受理時，從 API 餘額中保留報價的最高金額；完成後按實際用量結算，實際扣款不超過保留金額，並釋放剩餘金額。任務失敗則釋放保留金額。

Ideogram Vector 1.0 · SVG 產生器 API 有哪些限制？

畫面比例：1:1 · 1:4 · 1:3 · 1:2 · 9:16 · 10:16 +11；參考圖：5；提示詞長度（字元）：9,500；單一檔案大小上限：10 MB。超出這些限制的請求會在扣款之前被拒絕。