Руководство по API VectoSolve: автоматизация векторизации изображений для разработчиков
Узнайте, как интегрировать API VectoSolve в ваши приложения. Полное руководство с примерами кода на Node.js, Python и PHP, а также workflow-автоматизации.
Попробуйте на своём файле: бесплатный предпросмотр, без регистрации.
Founder and developer of VectoSolve
Self-taught developer who founded VectoSolve in 2024. He builds the conversion engine and the cutting, embroidery and 3D printing exports, working with the VectoSolve team of graphic designers.
How this article was made: drafted with AI assistance, then edited and fact-checked before publication. About the author
Key Takeaways
- API VectoSolve программно конвертирует растровые изображения в чистые SVG по $0.20 за конвертацию (кредиты никогда не истекают)
-
Простой REST-эндпоинт:
POST https://vectosolve.com/api/v1/vectorizeс Bearer-токен аутентификацией и multipart form-data -
Добавьте
removeBackground=trueза дополнительные $0.07 для автоматического удаления фона перед векторизацией - Лимит запросов — 60 в минуту — используйте экспоненциальный бэкофф и очереди для больших задач
- Интегрируется с n8n, Zapier и платформами ИИ-агентов для полностью автоматизированных workflow векторизации
Строите ли вы SaaS-продукт, автоматизируете дизайн-воркфлоу или обрабатываете тысячи изображений — API VectoSolve позволяет программно конвертировать растровые изображения в чистые SVG-векторы. Это руководство охватывает всё, от вашего первого API-вызова до продвинутых интеграций.
Почему стоит использовать API VectoSolve?
Ручная конвертация изображений не масштабируется. API VectoSolve обеспечивает:
- Пакетная обработка — Автоматическая конвертация сотен изображений
- SaaS-интеграция — Добавление векторизации в ваш продукт
- Автоматизация воркфлоу — Подключение к n8n, Zapier или OpenClaw
- Стабильное качество — Одинаковые результаты с ИИ каждый раз
Начало работы
Шаг 1: Создание API-ключа
Перейдите в панель управления API-ключами и нажмите «Создать новый ключ». Дайте ему описательное имя, например «Продакшен» или «Тест».
Важно: Скопируйте API-ключ немедленно — он не будет показан повторно из соображений безопасности.
Шаг 2: Получите кредиты
Каждая API-конвертация стоит $0.20. Оформите подписку на странице тарифов. Кредиты никогда не истекают, покупайте столько, сколько нужно.
Шаг 3: Первый запрос
API-эндпоинт принимает POST-запросы с изображением в form-data:
POST https://vectosolve.com/api/v1/vectorize
Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data
Pro Tip: Протестируйте API-ключ простой командой cURL перед построением интеграции. Это подтвердит, что ключ валиден, у вас есть кредиты и эндпоинт доступен из вашей среды. Занимает 10 секунд и экономит часы отладки.
Примеры кода
cURL
curl -X POST https://vectosolve.com/api/v1/vectorize \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@image.png" \
-F "removeBackground=false"
Node.js
const FormData = require('form-data');
const fs = require('fs');
const fetch = require('node-fetch');
async function vectorize(imagePath, apiKey) {
const formData = new FormData();
formData.append('file', fs.createReadStream(imagePath));
formData.append('removeBackground', 'false');
const response = await fetch('https://vectosolve.com/api/v1/vectorize', {
method: 'POST',
headers: {
'Authorization': `Bearer ${apiKey}`,
},
body: formData,
});
const result = await response.json();
if (result.success) {
console.log('SVG URL:', result.svgUrl);
console.log('Credits remaining:', result.credits.remaining);
return result.svg;
} else {
throw new Error(result.error);
}
}
// Usage
vectorize('./logo.png', 'YOUR_API_KEY');
Python
import requests
def vectorize(image_path, api_key):
url = "https://vectosolve.com/api/v1/vectorize"
with open(image_path, 'rb') as f:
files = {'file': f}
data = {'removeBackground': 'false'}
headers = {'Authorization': f'Bearer {api_key}'}
response = requests.post(url, files=files, data=data, headers=headers)
result = response.json()
if result.get('success'):
print(f"SVG URL: {result['svgUrl']}")
print(f"Credits remaining: {result['credits']['remaining']}")
return result['svg']
else:
raise Exception(result.get('error'))
# Usage
svg = vectorize('./logo.png', 'YOUR_API_KEY')
PHP
<?php
function vectorize($imagePath, $apiKey) {
$url = 'https://vectosolve.com/api/v1/vectorize';
$curl = curl_init();
$postFields = [
'file' => new CURLFile($imagePath),
'removeBackground' => 'false'
];
curl_setopt_array($curl, [
CURLOPT_URL => $url,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $postFields,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $apiKey
]
]);
$response = curl_exec($curl);
curl_close($curl);
$result = json_decode($response, true);
if ($result['success']) {
echo "SVG URL: " . $result['svgUrl'] . "\n";
return $result['svg'];
} else {
throw new Exception($result['error']);
}
}
// Usage
$svg = vectorize('./logo.png', 'YOUR_API_KEY');
?>
A Full Year of Conversions for $49
Starter Annual: 25 conversions every month, $49 for the whole year. That is about $4.08 a month · Cancel anytime
Get the Annual DealФормат ответа API
Успешный ответ выглядит так:
{
"success": true,
"svg": "<svg xmlns=\"http://www.w3.org/2000/svg\"...>",
"svgUrl": "https://vectosolve.com/api/files/abc123.svg",
"backgroundRemoved": false,
"credits": {
"cost": 0.20,
"remaining": 9.80
}
}
Обработка ошибок
API возвращает стандартные HTTP-коды статуса:
| Код | Значение | Решение |
|---|---|---|
| 401 | Недействительный API-ключ | Проверьте заголовок Authorization |
| 402 | Недостаточно кредитов | Купите больше кредитов |
| 403 | Требуется подписка | Обновите свой план |
| 429 | Лимит запросов превышен | Подождите и повторите (60 запр./мин) |
| 500 | Ошибка сервера | Повторите или свяжитесь с поддержкой |
«Лучшие API — те, которые не мешают. Загрузите файл, получите SVG — без настройки, без подбора параметров.» - Гильермо Раух, CEO Vercel
Продвинутое: удаление фона
Добавьте removeBackground=true для автоматического удаления фона перед векторизацией. Это стоит дополнительные $0.07 за запрос:
curl -X POST https://vectosolve.com/api/v1/vectorize \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@photo.jpg" \
-F "removeBackground=true"
Free SVG Tools for Crafters
Design Checker · Color Separator · Mat Preview · Offset Generator · Text to SVG
Check Your SVG FreeИнтеграции автоматизации
Воркфлоу n8n
n8n — мощный инструмент автоматизации воркфлоу. Для интеграции VectoSolve:
- Добавьте узел HTTP Request
- Установите метод на POST
- URL:
https://vectosolve.com/api/v1/vectorize - Аутентификация: Header Auth
- Имя заголовка:
Authorization - Значение заголовка:
Bearer YOUR_API_KEY - Тип содержимого тела: Form-Data
- Добавьте параметр
fileс вашим бинарным вводом
Zapier
Используйте «Webhooks by Zapier» для подключения VectoSolve к 5 000+ приложениям:
- Добавьте действие Webhooks by Zapier
- Выберите запрос POST
- URL:
https://vectosolve.com/api/v1/vectorize - Добавьте заголовок:
Authorization: Bearer YOUR_API_KEY - Тип полезной нагрузки: Form
- Подключите поле файла из триггера
OpenClaw / ИИ-агенты
Для ИИ-инструментов автоматизации вроде OpenClaw:
- Создайте API-ключ в панели VectoSolve
- Добавьте новый HTTP-инструмент в ваш ИИ-агент
- Настройте POST-запрос, как показано выше
- Распарсите JSON-ответ для извлечения
svgилиsvgUrl
Для пакетных задач большого объёма (1 000+ изображений) реализуйте архитектуру на основе очередей: помещайте запросы конвертации в очередь, обрабатывайте их воркерами с учётом лимита (макс. 60/мин) и сохраняйте результаты в собственном хранилище. Это предотвращает таймауты и гарантирует надёжную обработку каждого изображения.
Лимиты и лучшие практики
- Лимит запросов: 60 в минуту
- Макс. размер файла: 5 МБ
- Поддерживаемые форматы: PNG, JPG, JPEG, WEBP, GIF
- Кредиты: Никогда не истекают
Советы для пакетной обработки:
- Реализуйте экспоненциальный бэкофф для лимитов
- Ставьте запросы в очередь и обрабатывайте пакетами по 50
- Кэшируйте результаты, чтобы не конвертировать одно изображение повторно
- Используйте вебхуки для больших пакетных задач
Часто задаваемые вопросы
Сколько стоит API?
Каждая конвертация стоит $0.20. Удаление фона добавляет $0.07. Покупайте кредиты оптом для экономии — они никогда не истекают.
Какие форматы изображений поддерживаются?
PNG, JPG, JPEG, WEBP и GIF. Максимальный размер файла — 5 МБ.
Кредиты истекают?
Нет! После покупки кредиты остаются на вашем аккаунте навсегда до использования.
Какой лимит запросов?
60 запросов в минуту. Для более высоких лимитов свяжитесь с нами по поводу корпоративных планов.
Можно ли использовать API в коммерческих продуктах?
Да! Вы можете интегрировать API VectoSolve в свои коммерческие приложения, SaaS-продукты или клиентские проекты.
A Full Year of Conversions for $49
Starter Annual: 25 conversions every month, $49 for the whole year. That is about $4.08 a month · Cancel anytime
Get the Annual DealНужна помощь?
Ознакомьтесь с этими ресурсами:
- Панель API-ключей — Управляйте ключами и просматривайте использование
- FAQ — Ответы на частые вопросы
- Тарифы — Месячные и годовые тарифы
Готовы начать? Получите API-ключ и конвертируйте первое изображение за секунды!
| Параметр API | Тип | По умолчанию | Описание |
|---|---|---|---|
| image | File (multipart) | Обязательный | PNG, JPG или WebP до 10 МБ |
| removeBackground | Boolean | false | ИИ-удаление фона перед векторизацией |
| colorMode | String | "color" | "color", "grayscale" или "blackwhite" |
| detailLevel | String | "medium" | Сложность контуров: "low", "medium" или "high" |
| outputFormat | String | "svg" | Формат вывода: "svg" или "eps" |
Источники и дополнительное чтение
- MDN Web Docs — Fetch API — Справочник по HTTP-запросам с multipart form-data, использованный в примерах интеграции API
- Google AI Blog — Image Processing APIs — Обзоры ИИ-обработки изображений, паттернов проектирования REST API и масштабируемых облачных архитектур
- Smashing Magazine — API Integration — Руководства для разработчиков по использованию REST API в Node.js, Python и фронтенд JavaScript
- W3C SVG 2 Specification — Официальный стандарт SVG для понимания формата вывода ответов API векторизации