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

คีย์ที่ผู้ใช้กำหนดเอง (ไม่บังคับ ยาวสูงสุด 255 อักขระ) เมื่อกำหนดไว้ การตอบกลับที่สำเร็จ (2xx) จะถูกแคชไว้ 7 วัน การลองใหม่ด้วยคีย์เดิม + เนื้อหาคำขอที่เหมือนกันทุกประการจะได้การตอบกลับที่แคชไว้ (ไม่หักเครดิตเพิ่ม) ส่วนการลองใหม่ด้วยคีย์เดิมแต่เนื้อหาคำขอต่างกันจะได้ 409 ใช้เพื่อให้ส่ง POST ซ้ำได้อย่างปลอดภัยเมื่อเครือข่ายขัดข้อง สำหรับการอัปโหลดแบบ multipart/form-data ระบบจะเปรียบเทียบคำขอจากฟิลด์ในฟอร์มและเนื้อหาไฟล์ ดังนั้นการอัปโหลดซ้ำจะได้ผลลัพธ์เดิมแม้ไคลเอนต์จะสร้าง multipart boundary ใหม่

Idempotency-Key

ชื่อแฝงของ `image_url` ที่เลิกใช้แล้ว ยังรับค่าได้เมื่อไม่ได้ส่ง `image_url`

pic_url

ชื่อไฟล์ต้นฉบับ (ไม่บังคับ ใช้สำหรับบันทึกข้อมูล)

file_name

URL สาธารณะของรูปภาพแรสเตอร์ที่จะแปลงเป็นเวกเตอร์ เป็นชื่อฟิลด์หลัก (แนะนำให้ใช้แทน `pic_url`)

image_url

ไฟล์รูปภาพต้นฉบับ

image

ฟิลด์ไฟล์รูปภาพต้นฉบับสำหรับความเข้ากันได้ (เลิกใช้แล้ว: ให้ใช้ `image` แทน)

file

URL รูปภาพต้นฉบับ เมื่อไม่ได้อัปโหลดรูปภาพ (เลิกใช้แล้ว: ให้ใช้ `image_url` แทน)

ชื่อไฟล์ (ไม่บังคับ)

URL สาธารณะของรูปภาพแรสเตอร์ที่จะแปลงเป็นเวกเตอร์ เมื่อไม่ได้อัปโหลดไฟล์ เป็นชื่อฟิลด์หลัก (แนะนำให้ใช้แทน `pic_url`)

รับงานแปลงแล้ว

code

message

ใช้ ID นี้เพื่อ poll ผลลัพธ์การแปลง

record_id

data

เนื้อหาคำขอมีรูปแบบไม่ถูกต้องหรือขาดพารามิเตอร์ที่จำเป็น

ไม่มี API key หรือ key ไม่ถูกต้องหรือถูกเพิกถอนแล้ว

ยอดคงเหลือในบัญชีไม่เพียงพอหรือการสมัครใช้งานหมดอายุแล้ว

บัญชีไม่มีสิทธิ์เข้าถึง endpoint นี้

ใช้ Idempotency-Key ซ้ำกับเนื้อหาคำขอที่ต่างออกไป

ถูกจำกัดอัตราการเรียกใช้ (rate limit) ให้รอตามจำนวนวินาทีในเฮดเดอร์ `Retry-After` ก่อนลองใหม่

เกิดข้อผิดพลาดที่ไม่คาดคิดบนเซิร์ฟเวอร์

แปลงภาพแรสเตอร์เป็นพาธเวกเตอร์ที่สะอาด และส่งคืน SVG ที่ปรับขนาดได้โดยไม่เบลอ

รูปภาพเป็น SVG

อินพุต

เอาต์พุต