Ideogram Vector 1.0 API reference
SVG vectors from a prompt or a picture, with clean lettering
Call Ideogram Vector 1.0 from your own code with one PopNow API key. Below are the exact model IDs to send, every input field the model accepts, what each request costs in USD, and a request you can paste into a terminal.
At a glance
- Made by
- Ideogram
- Output
- Image
- From
- $0.132 USD per image
Prices are in USD, charged to your separate API wallet. A task reserves the maximum possible charge when accepted and settles actual usage on completion; any remainder is released. Failed tasks are not charged. Call POST /api/v1/jobs/quote for an exact quote before running.
SVG Generator
ideogram/vector-1/text-to-image
Price
| Option | USD |
|---|---|
quality = low, with_references = false | $0.174 per image |
quality = low, with_references = true | $0.174 per image |
quality = medium, with_references = false | $0.216 per image |
quality = medium, with_references = true | $0.216 per image |
quality = high, with_references = false | $0.264 per image |
quality = high, with_references = true | $0.432 per image |
Parameters
| Field | Type | Default | Allowed | What it does |
|---|---|---|---|---|
promptRequired | string | — | up to 9,500 characters | What to draw as an SVG: subject, style, colours and any short text to letter. |
qualityOptional | string | medium | low, medium, high | Generation quality tier. Higher tiers take longer and cost more. |
aspect_ratioOptional | string | 1:1 | 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, … (+3) | Shape of the SVG canvas. |
reference_image_urlsOptional | array<string> | — | up to 5 items | Optional style references, up to five images of up to 10 MB each. The first one counts most. |
Example request
This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.
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: $(uuidgen)" \
-d '{
"model": "ideogram/vector-1/text-to-image",
"input": {
"prompt": "A cozy reading nook beside a rain-streaked window, warm lamp light, a sleeping orange cat on a knitted blanket, soft film grain",
"quality": "medium"
}
}'The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"Image to SVG
ideogram/vector-1/edit
Price
| Option | USD |
|---|---|
Default | $0.132 per image |
Parameters
| Field | Type | Default | Allowed | What it does |
|---|---|---|---|---|
image_urlRequired | string | — | — | The picture to turn into an SVG: JPEG, PNG or WebP, up to 50 MB. |
detail_levelOptional | string | detailed | detailed, simple | detailed keeps finer shapes; simple merges them into fewer, larger shapes. Both cost the same. |
Example request
This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.
The example uses PopNow sample files in image_url. Replace them with your own public HTTPS links, uploads or saved assets.
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: $(uuidgen)" \
-d '{
"model": "ideogram/vector-1/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp"
}
}'The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"