**Cost**: 5 credits per successful conversion (failures do not consume credit).

SVG Converter Create supports two input modes:

1. **JSON URL mode**: send `application/json` with the existing URL field.
2. **Direct upload mode**: send `multipart/form-data` with a local image file in the `image` field. The compatible field name `file` is also accepted for the primary image. Codia checks credits before reading and uploading the file, so insufficient-credit requests return `402` without uploading anything.

Direct upload example:

```bash
curl 'https://openapi.codia.ai/v2/open/svg_converter/create' \
  -H 'Authorization: Bearer {codia_api_key}' \
  -F 'image=@./logo.png' \
  -F 'file_name=logo.png'
```

Submit a raster image (PNG / JPG / GIF / WebP) for vectorization to **SVG**. The conversion runs asynchronously — call this endpoint to enqueue, then poll `GET /v2/open/svg_converter/result/{record_id}` with the returned `record_id` until the SVG is ready.

## What this API is for

Auto-trace a bitmap into clean vector paths so it scales to any resolution without aliasing. Designed for logos, icons, illustrations, and other flat-art assets — not for photographic content (which doesn't vectorize well by nature).

Typical use cases: rebuilding a missing logo source from a PNG export; preparing assets for print or large-format displays; reducing file size for icon sets; preserving crisp edges in design systems.

## Lifecycle

This is an async, polling-based task (no webhook):

1. **Submit** here. Returns immediately with `data.record_id` (UUID).
2. **Poll** `GET /v2/open/svg_converter/result/{record_id}` with that `record_id`. The result's integer `svg_convert_status` transitions `1` (doing) → `2` (complete, with `svg_url`) or `3` (failed).
3. **Download** the `.svg` from `svg_url` once complete. URLs are pre-signed; fetch promptly and self-host for long-term use.

Typical end-to-end is **5–30 seconds** depending on detail level. Poll every 1–3 seconds.

## Request

| Field | Required | Notes |
|---|---|---|
| `image_url` | yes | Public URL of the raster image (PNG / JPG / GIF / WebP). Must be reachable from Codia's network. The legacy name `pic_url` is still accepted. |
| `file_name` | no | Original file name, used only for record-keeping in your dashboard. |

## Plan limits

Maximum image dimensions and file size depend on your subscription plan. Use `GET /v2/open/svg_converter/limit` at runtime to read your live limits — values below are indicative defaults:

| Plan | Max dimensions | Max file size |
|---|---|---|
| Free | 512×512 | 512 KB |
| Starter | 1024×1024 | 2 MB |
| Pro | 2048×2048 | 4 MB |

## Response

Standard envelope. On 200, `data.record_id` is the UUID you'll need to poll for the result. **Nothing else is returned at this stage** — the SVG itself comes from the `get` endpoint.

## Billing

5 credits per **successful** conversion (deducted when the task completes, not at submission — failed jobs don't consume credit). Uses the unified Codia Open API balance.

## Errors

- `400` — missing `image_url`, unsupported MIME, or input exceeds your plan's dimensions / file size limits.
- `401` / `403` — auth issues.
- `402` — credits exhausted.
- `429` — rate limit. Back off.
- `500` — internal error; safe to retry.

Optional user-supplied key (up to 255 chars). When set, a successful (2xx) response is cached for 7 days. A retry with the same key + identical request body returns the cached response (no extra credit charged); a retry with the same key but a different body returns 409. Use to make POST safe to retry on network failures. For multipart/form-data uploads, requests are compared by form fields and file contents, so a retried upload is replayed even though the client picks a new multipart boundary.

Idempotency-Key

Deprecated alias of `image_url`, still accepted when `image_url` is omitted.

pic_url

Original file name (optional, used for record-keeping)

file_name

Public URL of the raster image to vectorize. Canonical field name (preferred over `pic_url`).

image_url

image

Compatible source image file field (deprecated: use `image` instead).

file

Source image URL when not uploading image (deprecated: use `image_url` instead).

Public URL of the raster image to vectorize when not uploading a file. Canonical field name (preferred over `pic_url`).

code

message

Use this ID to poll for the conversion result

record_id

data

The request body is malformed or missing required parameters

The API key is missing, invalid, or revoked

Account balance is insufficient or subscription has expired

Account does not have access to this endpoint

Idempotency-Key reused with a different request body.

Rate limited. Wait for the number of seconds in the `Retry-After` header before retrying.

An unexpected error occurred on the server

Traces a raster image into clean vector paths and returns an SVG that scales without blur.

Image to SVG

Input

Output