SVG GeneratorAbout Recraft V4 Vector
Clean SVG logos and marks from a short prompt.
Call it with the model name recraft/v4-vector/text-to-image on POST /jobs/createTask, from $0.096.
Introduction
Recraft V4 Vector turns a written brief into an SVG file. Recraft built V4 for designers, with attention to composition, colour and clean geometry, and this endpoint calls its vector mode.
Key features
Clean, layered geometry
Shapes are separate paths, so you can recolour a fox's ear or move a badge ribbon without redrawing anything.
Colour schemes that hold
Palettes named in the prompt, such as teal and coral or cream and brown, were followed closely in our runs.
Wordmarks in the design
Short names like Rise & Crumb are lettered as part of the artwork.
Request parameters
| Parameter | Required | Description |
|---|---|---|
prompt | Yes | Describe what you want to make. |
aspect_ratio | No | The shape of the frame: wide, square or tall. 1:1 · 4:3 · 3:4 · 3:2 · 2:3 · 16:9 · 9:16 · Default: 1:1 |
Pricing
Prices are in USD. The API uses a separate USD balance. Website credits cannot be used or transferred to it, and API funds cannot be transferred to website credits. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.
| Option | USD per image |
|---|---|
| Standard | $0.096 |
Send the same request body to POST /jobs/quote to see the estimated and maximum USD charge before running. A quote does not run the task or charge your balance.
Use cases
Identity drafts
Explore marks and badges for a new business before handing the best one to a designer.
Packaging and labels
Draw label art that can be enlarged for print.
Prompt guide & pro tips
Keep marks simple
For logos, ask for flat or geometric shapes and two or three colours.
Proof the lettering
Check spelling and spacing, then adjust in a vector editor if needed.
API quick start
Call the Recraft V4 Vector API in three steps
- Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow-. API calls use your separate USD balance.
- Send the request. POST /jobs/createTask with model recraft/v4-vector/text-to-image and an input object that follows the parameter table. The response returns a task ID straight away.
- Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.
# 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": "recraft/v4-vector/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"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"Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.
Recraft V4 Vector API questions
How much does the Recraft V4 Vector API cost?
Recraft V4 Vector costs $0.096 per image. The API uses a separate USD balance. Website credits cannot be used or transferred to it, and API funds cannot be transferred to website credits. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.
What is the model name for Recraft V4 Vector in the API?
Put recraft/v4-vector/text-to-image for SVG Generator in the model field of POST /jobs/createTask.
Is the output a true vector?
Yes. The files we received contained path elements only, with no embedded bitmap, and we reject any SVG that wraps a bitmap before it reaches you.
Can I set the output size in pixels?
An SVG has no fixed pixel size. aspect_ratio sets the canvas shape; you can export the file at any resolution afterwards.
Does it keep the file's text as live type?
No. Letters are drawn as outlines, so the spelling cannot be edited as text, but the shapes stay sharp at any size.
What are the limits of the Recraft V4 Vector API?
Aspect ratios: 1:1 · 4:3 · 3:4 · 3:2 · 2:3 · 16:9 · 9:16; Prompt length (characters): 10,000. Requests outside these limits are rejected before anything is charged.
Can I try Recraft V4 Vector without writing code?
Run Recraft V4 Vector in the Playground with your API USD balance, without an API key. Each run appears in your developer history with its matching code.