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

استخدم هذا المعرّف للاستعلام الدوري عن نتيجة التحويل

record_id

data

جسم الطلب غير صالح أو تنقصه معاملات مطلوبة

مفتاح API مفقود أو غير صالح أو تم إبطاله

رصيد الحساب غير كافٍ أو انتهت صلاحية الاشتراك

لا يملك الحساب صلاحية الوصول إلى نقطة النهاية هذه

أُعيد استخدام Idempotency-Key مع جسم طلب مختلف.

تم تجاوز حد المعدل. انتظر عدد الثواني المحدد في الترويسة `Retry-After` قبل إعادة المحاولة.

حدث خطأ غير متوقع في الخادم

يتتبّع صورة نقطية ويحوّلها إلى مسارات متجهة نظيفة، ويُعيد ملف SVG يمكن تكبيره دون تشويش.

الصورة إلى SVG

المدخلات

المخرجات