Ideogram Vector 1.0 API：價格、參數與程式碼

Name: Ideogram Vector 1.0 API
SKU: ideogram/vector-1/edit
Price: 0.132 USD
Availability: InStock

關於 Ideogram Vector 1.0

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

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

簡介

圖片轉 SVG 接收一張點陣圖，回傳一個向量檔案。傳入 logo 截圖、圖示 PNG 或照片，即可得到可縮放、可改色、可編輯的 SVG。

主要特色

可編輯的路徑

輸出由 path 元素與漸層組成，不內嵌圖片。每個顏色區塊都是獨立的形狀。

兩種細節設定

Detailed 盡量貼近原圖；Simple 會合併小區塊，適合風格化的畫面與較輕的檔案。

不需要提示詞

圖片本身就是完整的請求，向量結果會保持原有比例。

請求參數

參數	必填	說明
`detail_level`	否	選 detailed 保留更細的形狀，simple 把形狀合併成較少、較大的區塊。兩者價格相同。 detailed · simple · 預設值: detailed
`image_url`	是	作為起點的那張圖。

價格

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

選項	USD /張
標準	US$0.132

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

適用情境

低解析度 logo

把一張小的 PNG logo 轉成向量，用於招牌、印刷與周邊商品。

圖示組

把點陣圖示轉成 SVG，讓它們在 App 與網站上保持清晰。

提示詞指南與進階技巧

使用乾淨的原圖

盡量使用手邊最大、最清晰的版本，最好是純色背景。壓縮瑕疵會變成多餘的形狀。

風格化作品選 Simple

如果 Detailed 的結果有太多細小形狀，改用 Simple 可以得到較大的區塊和較小的檔案。

照片的檔案可能很大

整張照片可能產生數千條路徑，檔案 1–2 MB；圖示通常只有幾 KB。

API 快速上手

三步驟呼叫 Ideogram Vector 1.0 API

建立 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，US$0.132/張起。API 使用獨立的美元餘額。網站點數不能用於 API，也不能轉入 API 餘額；API 餘額同樣不能轉為網站點數。任務受理時，從 API 餘額中保留報價的最高金額；完成後按實際用量結算，實際扣款不超過保留金額，並釋放剩餘金額。任務失敗則釋放保留金額。

Ideogram Vector 1.0 在 API 裡的模型名稱是什麼？

在 POST /jobs/createTask 的 model 欄位填圖片轉 SVG用 ideogram/vector-1/edit；SVG 產生器用 ideogram/vector-1/text-to-image。

Ideogram Vector 1.0 API 有哪些限制？

單一檔案大小上限：50 MB。超出這些限制的請求會在扣款之前被拒絕。

不寫程式能試 Ideogram Vector 1.0 嗎？

不需要 API 金鑰，即可在 Playground 用 API 美元餘額執行 Ideogram Vector 1.0。每次執行都記入開發者紀錄，並附對應程式碼。