**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.

Optionaler, vom Client festgelegter Schlüssel (bis zu 255 Zeichen). Ist er gesetzt, wird eine erfolgreiche (2xx) Antwort 7 Tage lang zwischengespeichert. Eine Wiederholung mit demselben Schlüssel und identischem Request-Body liefert die gespeicherte Antwort (ohne zusätzliche Credits); eine Wiederholung mit demselben Schlüssel, aber anderem Body liefert 409. Damit lassen sich POST-Requests bei Netzwerkfehlern gefahrlos wiederholen. Bei multipart/form-data-Uploads werden Requests anhand der Formularfelder und Dateiinhalte verglichen, sodass ein wiederholter Upload auch dann als Wiederholung erkannt wird, wenn der Client eine neue Multipart-Boundary wählt.

Idempotency-Key

Veralteter Alias von `image_url`, wird weiterhin akzeptiert, wenn `image_url` fehlt.

pic_url

Ursprünglicher Dateiname (optional, dient nur der Dokumentation)

file_name

Öffentliche URL des zu vektorisierenden Rasterbildes. Kanonischer Feldname (gegenüber `pic_url` bevorzugt).

image_url

image

Kompatibilitätsfeld für die Quellbilddatei (veraltet: verwenden Sie stattdessen `image`).

file

URL des Quellbildes, wenn kein Bild hochgeladen wird (veraltet: verwenden Sie stattdessen `image_url`).

Öffentliche URL des zu vektorisierenden Rasterbildes, wenn keine Datei hochgeladen wird. Kanonischer Feldname (gegenüber `pic_url` bevorzugt).

code

message

Mit dieser ID fragen Sie das Konvertierungsergebnis ab

record_id

data

Der Request-Body ist fehlerhaft oder es fehlen erforderliche Parameter

Der API-Schlüssel fehlt, ist ungültig oder wurde widerrufen

Das Kontoguthaben reicht nicht aus oder das Abonnement ist abgelaufen

Das Konto hat keinen Zugriff auf diesen Endpunkt

Idempotency-Key mit einem anderen Request-Body wiederverwendet.

Rate-Limit erreicht. Warten Sie vor einem erneuten Versuch die im Header `Retry-After` angegebene Anzahl an Sekunden.

Auf dem Server ist ein unerwarteter Fehler aufgetreten

Vektorisiert ein Rasterbild in saubere Pfade und liefert ein SVG, das sich ohne Unschärfe skalieren lässt.

Bild zu SVG

Eingabe

Ausgabe