Browse docs
Overview
Browse docs
Overview
Overview
Image2URL API
Filter by section
Getting Started
Create a key, make the first request, and understand the v1 surface.
Guides
Authentication, billing semantics, and operational behavior you need in production.
Reference
Route-by-route request and response patterns for the current external namespace.
API docs built for implementation, not for sales copy.
This section documents the current external namespace, authentication model, quota headers, webhook delivery semantics, and the request shapes that already exist in code.
Recent views
Recently opened docs on this device.
No recent docs yet
Open a route reference or guide and it will show up here.
Recommended reading
Core docs to keep moving without relying on search every time.
Quickstart
Create an API key, submit your first request, and poll an async job to completion.
Authentication And Usage
Understand API key headers, quota headers, structured errors, and how monthly metering works.
Route Reference
Current request and response patterns for the Image2URL external API namespace.
Webhooks
Configure signed async task callbacks and verify delivery from Image2URL.
https://www.image2url.com/api/external/v1Use Authorization: Bearer <API_KEY> or x-api-key.
Terminal jobs emit api.task.completed and api.task.failed.
Ship the first async job in one paste.
Start with the Image-to-SVG submit route, copy the language example your team uses, and poll the paired status route with the returned task ID.
Submit route
/image-to-svg/vectorizeStatus route
/image-to-svg/status/{taskId}Replace `{taskId}` with the accepted task ID.
curl -X POST "https://www.image2url.com/api/external/v1/image-to-svg/vectorize" \
-H "Authorization: Bearer $IMAGE2URL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://cdn.example.com/assets/logo.png",
"output_format": "svg",
"preset": "logo"
}'Auth header
Authorization: Bearer <API_KEY>Payload snapshots
Inspect the accepted response, terminal status payload, or webhook event before wiring consumers.
{
"success": true,
"taskId": "task_123456",
"originalUrl": "https://cdn.example.com/assets/logo.png"
}Status values
Webhook event
api.task.completedSignature header
X-Image2Url-Signature: t=<timestamp>,v1=<hex>Start Here
Quickstart
Create an API key, submit your first request, and poll an async job to completion.
First Call
- 1. Upgrade to a plan with API access.
- 2. Create a key in the dashboard.
- 3. Submit a JSON request with a public asset URL.
- 4. Poll the status route or configure webhooks.
Developer Docs
Reference map
Current docs: 4
Guides
Authentication, billing semantics, and operational behavior you need in production.
Reference
Route-by-route request and response patterns for the current external namespace.
Need Operational Context?
The reference pages focus on what exists today in code. If your team is wiring retries, quota dashboards, or webhook consumers, read the auth and webhook guides before you ship.