VectoSolve API-Tutorial: Bildvektorisierung für Entwickler automatisieren

Ob Sie ein SaaS-Produkt bauen, Design-Workflows automatisieren oder Tausende von Bildern verarbeiten — die VectoSolve API ermöglicht es Ihnen, Rasterbilder programmatisch in saubere SVG-Vektoren umzuwandeln. Dieser Leitfaden deckt alles ab, von Ihrem ersten API-Aufruf bis zu fortgeschrittenen Integrationen.

• Batch-Verarbeitung — Hunderte von Bildern automatisch konvertieren
• SaaS-Integration — Vektorisierung zu Ihrem Produkt hinzufügen
• Workflow-Automatisierung — Verbindung mit n8n, Zapier oder OpenClaw
• Konstante Qualität — Jedes Mal die gleichen KI-gestützten Ergebnisse

Erste Schritte

Schritt 1: API-Schlüssel erstellen

Navigieren Sie zu Ihrem API-Schlüssel-Dashboard und klicken Sie auf "Neuen Schlüssel erstellen". Geben Sie ihm einen beschreibenden Namen wie "Produktion" oder "Test".

Wichtig: Kopieren Sie Ihren API-Schlüssel sofort — er wird aus Sicherheitsgründen nicht erneut angezeigt.

Schritt 2: Credits hinzufügen

Jede API-Konvertierung kostet $0.20. Abonnieren Sie auf der Preisseite. Credits verfallen nie, kaufen Sie was Sie brauchen.

Schritt 3: Erste Anfrage senden

Der API-Endpunkt akzeptiert POST-Anfragen mit Ihrem Bild als Form-Data:

POST https://vectosolve.com/api/v1/vectorize
Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data

Code-Beispiele

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');
?>

API-Antwortformat

Eine erfolgreiche Antwort sieht so aus:

{
  "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
  }
}

Fehlerbehandlung

Die API gibt Standard-HTTP-Statuscodes zurück:

"

Die besten APIs sind die, die Ihnen nicht im Weg stehen. Laden Sie eine Datei hoch, bekommen Sie ein SVG zurück — keine Konfiguration, kein Herumschrauben an Parametern.

Fortgeschritten: Hintergrundentfernung

Fügen Sie removeBackground=true hinzu, um Hintergründe vor der Vektorisierung automatisch zu entfernen. Dies kostet zusätzliche $0.07 pro Anfrage:

curl -X POST https://vectosolve.com/api/v1/vectorize \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@photo.jpg" \
  -F "removeBackground=true"

Automatisierungs-Integrationen

n8n-Workflow

n8n ist ein leistungsstarkes Workflow-Automatisierungstool. Um VectoSolve zu integrieren:

• Fügen Sie einen HTTP Request-Knoten hinzu
• Setzen Sie die Methode auf POST
• URL: https://vectosolve.com/api/v1/vectorize
• Authentifizierung: Header Auth
• Header-Name: Authorization
• Header-Wert: Bearer YOUR_API_KEY
• Body Content Type: Form-Data
• Fügen Sie den Parameter file mit Ihrer Binäreingabe hinzu

Zapier

Verwenden Sie "Webhooks by Zapier", um VectoSolve mit über 5.000 Apps zu verbinden:

• Fügen Sie eine Webhooks by Zapier-Aktion hinzu
• Wählen Sie POST-Anfrage
• URL: https://vectosolve.com/api/v1/vectorize
• Fügen Sie Header hinzu: Authorization: Bearer YOUR_API_KEY
• Payload-Typ: Form
• Ordnen Sie Ihr Dateifeld vom Trigger zu

OpenClaw / KI-Agenten

Für KI-gestützte Automatisierungstools wie OpenClaw:

• Erstellen Sie einen API-Schlüssel in Ihrem VectoSolve-Dashboard
• Fügen Sie ein neues HTTP-Tool in Ihrem KI-Agenten hinzu
• Konfigurieren Sie die POST-Anfrage wie oben gezeigt
• Parsen Sie die JSON-Antwort, um svg oder svgUrl zu extrahieren

Ratenlimits und Best Practices

• Ratenlimit: 60 Anfragen pro Minute
• Max. Dateigröße: 5 MB
• Unterstützte Formate: PNG, JPG, JPEG, WEBP, GIF
• Credits: Verfallen nie

Tipps für die Batch-Verarbeitung:

• Implementieren Sie exponentiellen Backoff für Ratenlimits
• Stellen Sie Anfragen in Warteschlangen und verarbeiten Sie in Batches von 50
• Cachen Sie Ergebnisse, um die gleiche Datei nicht erneut zu konvertieren
• Verwenden Sie Webhooks für große Batch-Aufträge

Häufig gestellte Fragen

Was kostet die API?

Jede Konvertierung kostet $0.20. Hintergrundentfernung fügt $0.07 hinzu. Kaufen Sie Credits in großen Mengen zum Sparen — sie verfallen nie.

Welche Bildformate werden unterstützt?

PNG, JPG, JPEG, WEBP und GIF. Die maximale Dateigröße beträgt 5 MB.

Verfallen Credits?

Nein! Einmal gekauft, bleiben Credits für immer auf Ihrem Konto, bis sie verwendet werden.

Was ist das Ratenlimit?

60 Anfragen pro Minute. Für höhere Limits kontaktieren Sie uns für Enterprise-Pläne.

Kann ich die API in kommerziellen Produkten verwenden?

Ja! Sie können die VectoSolve API in Ihre kommerziellen Anwendungen, SaaS-Produkte oder Kundenprojekte integrieren.

• API-Schlüssel-Dashboard — Verwalten Sie Ihre Schlüssel und sehen Sie die Nutzung
• FAQ — Häufige Fragen beantwortet
• Preise — Monats- und Jahrespläne

Bereit loszulegen? Holen Sie sich Ihren API-Schlüssel und konvertieren Sie Ihr erstes Bild in Sekunden!

Quellen und weiterführende Lektüre

• MDN Web Docs — Fetch API — Referenz für HTTP-Anfragen mit multipart form-data, verwendet in den API-Integrationsbeispielen
• Google AI Blog — Image Processing APIs — Einblicke in KI-gestützte Bildverarbeitung, REST-API-Designmuster und skalierbare Cloud-Architekturen
• Smashing Magazine — API Integration — Entwickleranleitungen zum Konsumieren von REST-APIs in Node.js, Python und Frontend-JavaScript
• W3C SVG 2 Specification — Offizieller SVG-Standard zum Verständnis des Ausgabeformats der Vektorisierungs-API-Antworten