Rasterless

Ontwikkelaars: de Rasterless API en de MCP-server

Roep dezelfde omzetter aan vanuit een script of agent, met één API-sleutel.

Werkt met uw favoriete agents

Alles wat de omzetter op deze site doet, is via HTTP beschikbaar: één afbeelding erin, de formaten die u vraagt eruit, met dezelfde opties en dezelfde grenzen. Een agent die het Model Context Protocol spreekt, kan de omzetter via de remote MCP-server als tool aanroepen, met dezelfde sleutel.

De tabellen op deze pagina worden gegenereerd uit de code die de verzoeken beantwoordt, dus een optienaam of een limiet kan niet afwijken van wat de server accepteert. Waarden die nog niet vaststaan, zijn als zodanig gemarkeerd in plaats van geraden.

Snel aan de slag

Log eerst in met Google en maak een API-sleutel aan in het paneel dat volgt. Sleutels beginnen met rl_live_ en worden maar één keer getoond. Houd de sleutel buiten versiebeheer; de voorbeelden lezen hem uit een omgevingsvariabele met de naam RASTERLESS_API_KEY.

Uw API-sleutels

Log op deze pagina in met Google om uw API-sleutels aan te maken en te beheren. Het paneel heeft JavaScript nodig.

Uw eerste aanroep

1. Zet de sleutel in een omgevingsvariabele. Vervang de plaatshouder door uw sleutel. De variabele blijft gelden tot u dat terminalvenster sluit.

bash
export RASTERLESS_API_KEY='UW_API_SLEUTEL'
PowerShell
$env:RASTERLESS_API_KEY = 'UW_API_SLEUTEL'

2. Controleer de sleutel. GET /v1/account antwoordt met de sleutel en het resterende quotum, en telt niet als omzetting. Een 401 api_key_invalid betekent meestal dat bij het kopiëren een deel van de sleutel is weggevallen.

bash
curl -sS https://api.rasterless.com/v1/account \
  -H "Authorization: Bearer $RASTERLESS_API_KEY"
PowerShell
curl.exe -sS https://api.rasterless.com/v1/account `
  -H "Authorization: Bearer $env:RASTERLESS_API_KEY"

3. Zet een bestand van uw computer om. Na @ staat het pad van de afbeelding; ./logo.png is het bestand logo.png in de map waarin de terminal staat. Typ in PowerShell curl.exe: in Windows PowerShell start curl op zichzelf een ander commando. curl.exe zit in Windows 10 vanaf build 17063.

bash
curl -X POST https://api.rasterless.com/v1/vectorize \
  -H "Authorization: Bearer $RASTERLESS_API_KEY" \
  -F image=@./logo.png \
  -F formats=svg,dxf \
  -F colors=auto
PowerShell
curl.exe -X POST https://api.rasterless.com/v1/vectorize `
  -H "Authorization: Bearer $env:RASTERLESS_API_KEY" `
  -F "image=@./logo.png" `
  -F "formats=svg,dxf" `
  -F "colors=auto"

4. Lees het antwoord. Dit voorbeeld heeft de velden en typen van een echt antwoord; de waarden komen uit een testomzetting en de downloadlinks zijn ter illustratie:

Voorbeeldantwoord
{
  "id": "d23ed01b4e504118855e620297706bbb",
  "colors_used": 4,
  "seconds": 2.61,
  "outputs": {
    "svg": "https://storage.googleapis.com/…/output.svg?X-Goog-Algorithm=GOOG4-RSA-SHA256&…",
    "dxf": "https://storage.googleapis.com/…/output.dxf?X-Goog-Algorithm=GOOG4-RSA-SHA256&…"
  },
  "expires_in": 3600,
  "preview_url": "https://storage.googleapis.com/…/output_preview.png?X-Goog-Algorithm=GOOG4-RSA-SHA256&…",
  "colors_auto": {
    "detected": true,
    "regime": "A",
    "margin": 11590.0
  },
  "shapes": 5
}

Het antwoord is JSON: outputs bevat een ondertekende downloadlink voor elk formaat dat u vroeg, en colors_used het aantal kleuren dat de engine heeft gebruikt. Links verlopen na 1 uur, dus haal de bestanden op zodra het antwoord binnenkomt, in plaats van de links te bewaren. Vraag één formaat en voeg ?return=file toe aan het adres om het bestand zelf te ontvangen in plaats van JSON.

id benoemt de taak en seconds is hoe lang de omzetting duurde. shapes telt de vormen in het resultaat, preview_url is een PNG-voorbeeld met dezelfde levensduur als de links, en colors_auto.detected zegt of colors=auto het aantal in de afbeelding vond of de standaardwaarde gebruikte.

Authenticatie

Elk verzoek draagt de sleutel in de header Authorization: Bearer, via HTTPS. De API plaatst geen cookie en toont geen browsercontrole: de sleutel is de hele identiteit, dus behandel hem als een wachtwoord en doe de aanroepen vanaf uw server. Een sleutel in browsercode of in een mobiele app is een sleutel die iedereen kan lezen. Een verzoek zonder sleutel geeft 401 api_key_missing, een onjuiste sleutel 401 api_key_invalid en een ingetrokken sleutel 401 api_key_revoked. Intrekken werkt vanaf het volgende verzoek, en elk account kan tegelijk een beperkt aantal actieve sleutels hebben.

Schorten wij op grond van de servicevoorwaarden een van uw sleutels op of trekken wij hem in, dan staat hij in uw sleutellijst als ingetrokken en schrijven wij naar het e-mailadres van uw Google-account.

Endpoints en parameters

EndpointBeschrijving
POST /v1/vectorize Zet één afbeelding om en geeft per formaat een ondertekende link terug.
GET /v1/options Toont de geaccepteerde waarden van elke optie.
GET /v1/account Toont het quotum van de sleutel en hoeveel daarvan nog over is.

POST /v1/vectorize neemt multipart/form-data aan: de afbeelding in een veld met de naam image en de opties als gewone formuliervelden. De waarden zijn de assen die GET /v1/options teruggeeft, en de tabel wordt uit dezelfde constanten opgebouwd, dus hij kan de server niet tegenspreken.

Formuliervelden van POST /v1/vectorize
ParameterWaarden StandaardBeschrijving
image verplicht PNG, JPEG, WEBP, BMP, GIF, AVIF — De afbeelding, als multipart-bestandsveld. De eerste bytes bepalen het type, niet de bestandsnaam.
formats svg, pdf, eps, dxf, png svg Eén of meer, gescheiden door komma's; het antwoord bevat één link per formaat.
colors 2–64, auto auto Paletgrootte; 2 geeft een zwart-wittracering. auto leest het aantal af uit een afbeelding met vlakke kleuren en valt terug op 26.
svg_version svg_1_0, svg_1_1, svg_tiny_1_2 svg_1_1 De versie die op het root-element van de SVG wordt geschreven.
draw_style fill_shapes, stroke_shapes, stroke_edges fill_shapes Gevulde vormen, omlijnde vormen of uitsluitend randen. In een DXF geven de eerste twee dezelfde gesloten contouren; uitsluitend randen geeft open paden.
shape_stacking cutouts, stacked cutouts Uitsparingen ponsen gaten in de vormen eronder; gestapeld schildert ze over elkaar heen.
group_by none, color, parent, layer none Uitsluitend SVG-groepering: geen, op kleur, op bovenliggende vorm of op laag.
size_mm WxH, 1–5000 mm — Fysieke maat zoals 150x150. Geldt voor SVG, PDF, EPS en DXF; laat het leeg om pixeleenheden te houden.
denoise 0–50 0 Sterkte van een randbehoudend voorfilter; 0 schakelt het uit. Niet beschikbaar in de MCP-tool.

group_by verandert uitsluitend hoe een SVG zijn paden groepeert. In een DXF schrijven fill_shapes en stroke_shapes dezelfde gesloten contouren (LWPOLYLINE en SPLINE van de derde graad) op één FILL_-laag per kleur; stroke_edges schrijft in plaats daarvan het randennetwerk, elke grens één keer als open pad, op EDGE_-lagen. De DXF wordt geschreven als R2010 (AC1024) met millimeters als eenheid.

Fouten

Een fout geeft JSON terug onder error: een code, een type dat codes in families groepeert (bad_input, auth, quota, too_complex, timeout, busy, not_found, server), de waarden daarachter in params en een message in het Engels als terugval. Baseer uw logica op type, log code en ontleed nooit de tekst van het bericht. Een typische body is {"error": {"code": "file_too_large", "type": "bad_input", "params": {"max_mb": 25}}}, met het bericht ernaast.

Een wijziging in /v1 waardoor een verzoek dat vandaag werkt niet meer werkt, kondigen wij ten minste 30 dagen voordat die ingaat op deze pagina aan. Toevoegingen waarbij werkende verzoeken blijven zoals ze zijn, zoals een nieuw optioneel veld, kunnen zonder aankondiging verschijnen.

HTTPCodeBetekenis
400 image_missing Geen bestand in het veld image.
400 multipart_invalid De body kon niet worden gelezen als multipart/form-data.
400 unsupported_input De bestandsextensie is geen geaccepteerde invoer.
400 not_an_image De eerste bytes van het bestand zijn geen geaccepteerde rasterafbeelding.
400 invalid_option Een optie heeft een waarde buiten haar lijst; params noemt welke.
400 size_mm_format size_mm is niet geschreven als BxH, bijvoorbeeld 150x150.
400 size_mm_range Een zijde van size_mm valt buiten het geaccepteerde bereik.
400 return_needs_one_format ?return=file werd gevraagd met meer dan één formaat.
401 api_key_missing Geen sleutel in de Authorization-header.
401 api_key_invalid De sleutel is niet geldig.
401 api_key_revoked De sleutel is ingetrokken; maak een nieuwe aan.
403 key_suspended Een sleutel van het account is geschorst; er kan geen nieuwe sleutel worden aangemaakt.
409 key_limit Het account heeft al het maximale aantal actieve sleutels.
413 file_too_large De upload is groter dan de limiet voor de bestandsgrootte.
413 image_too_large De gedecodeerde afbeelding is groter dan de pixellimiet.
422 too_complex De taak is niet gestart: de schatting ligt boven het tijdbudget, of (image_bound false) de server had voor dit verzoek te weinig tijd over. Een lager aantal kleuren wordt voorgesteld als er een door de schatting komt.
422 timeout De conversie is over haar tijdbudget gegaan; minder kleuren helpen niet, een kleinere afbeelding kan helpen.
429 busy Alle workers zijn bezet; probeer het opnieuw na de tijd uit de Retry-After-header.
429 quota_hourly De sleutel heeft zijn uurquotum opgebruikt.
429 quota_daily De sleutel heeft zijn dagquotum opgebruikt.
429 quota_url_fetch De sleutel heeft zijn image_url-ophaalacties voor dit uur opgebruikt (MCP-tool).
429 quota_requests De sleutel heeft zijn aantal conversieverzoeken voor dit uur verstuurd, ongeacht de uitkomst; probeer opnieuw na de tijd in de Retry-After-header.
429 key_create_limit Het account heeft zijn nieuwe sleutels voor de afgelopen 24 uur al gebruikt; probeer het opnieuw na de tijd uit de Retry-After-header.

Bij 429 busy wacht u de tijd uit de header Retry-After af en stuurt u het verzoek opnieuw.

Bij 422 too_complex is de conversie niet begonnen, en error.image_bound zegt waarom. Is de waarde true, dan ligt de afbeelding zelf boven de grens. Is error.suggested_n_colors dan een getal, dan is dat een lager aantal kleuren waarvan we de schatting hebben getoetst aan de grenzen van een nieuw verzoek, meestal het grootste dat erdoor komt; een nieuwe poging met dat aantal komt door deze controle. Het is een schatting, geen belofte: de nieuwe poging kan alsnog op timeout eindigen. Is de waarde null en fewer_colors_help false, dan blijft de schatting zelfs bij 2 kleuren boven de grens; minder kleuren helpen niet, een kleinere afbeelding misschien wel. Zijn beide null, dan kon er geen voorstel worden berekend.

Is image_bound false, dan ligt het niet aan de afbeelding: de server had voor dit verzoek te weinig tijd over. suggested_n_colors en fewer_colors_help zijn dan allebei null, en hetzelfde verzoek kan zo meteen opnieuw worden verstuurd.

Bij 422 timeout is de conversie begonnen en over haar tijdbudget gegaan. Het aantal kleuren verandert nauwelijks hoe lang een conversie duurt, dus de body stelt geen aantal kleuren voor: suggested_n_colors is null en fewer_colors_help is false. Een kleinere afbeelding helpt alleen onder 1,5 megapixel, omdat grotere afbeeldingen toch op dat formaat worden getraceerd; probeer ongeveer de helft daarvan (bijv. 1000 × 750 px), of verminder ruis en textuur. image_bound staat alleen in een too_complex-body.

Een timeout geeft de conversie terug aan het quotum van de sleutel (quota_refunded: true): één keer per afbeelding per uur en ten hoogste 2 keer per sleutel per klokuur; daarboven staat in de body quota_refunded: false.

Heel soms gaat een conversie over haar tijdbudget en sluit de verbinding na ongeveer 100 seconden met HTTP 524, zonder JSON-body; behandel dat als een timeout.

Limieten en quotum

LimietWaarde
Conversies per sleutel, per uur 20
Conversies per sleutel, per dag 100
Actieve sleutels per account 2
Nieuwe sleutels per account per 24 uur, na de eerste 2 1
MCP-ophaalacties van image_url per sleutel, per uur 120
Conversieverzoeken per sleutel, per uur (API en MCP) 200
Bestandsgrootte 25 MB
Grootte van de gedecodeerde afbeelding 40 MP
Tijdbudget per conversie 90 s
Geldigheid van de downloadlink 1 h
size_mm, per zijde 1–5000 mm

De ophaalregel telt elke keer dat de MCP-tool vectorize_image een image_url downloadt. De telling gebeurt voordat de download begint, dus een download die mislukt of iets anders dan een afbeelding oplevert, telt ook. Deze teller staat los van het omzettingsquotum.

Afbeeldingen boven 1,5 megapixel worden vóór het traceren verkleind, dus de pixelmaat van de uitvoer volgt de verkleinde kopie; stel size_mm in als u fysieke afmetingen nodig hebt. Eén afbeelding per verzoek.

Prijzen

API-sleutels en de omzettingen die u ermee uitvoert binnen het quotum hierboven zijn gratis tijdens de bèta. Er wordt niets in rekening gebracht zonder uw duidelijke instemming vooraf (servicevoorwaarden, onderdeel 4).

MCP-server

Met de MCP-server kan een agent de omzetter als tool aanroepen. Hij spreekt Streamable HTTP op https://api.rasterless.com/mcp en neemt dezelfde sleutel als bearer-token in dezelfde header aan. Hij biedt twee tools: vectorize_image zet één afbeelding om, aangeleverd als image_url (een openbaar https-adres) of als image_base64, met de opties uit de parametertabel; get_options geeft de geaccepteerde waarden en het resterende quotum van de sleutel terug, zodat de agent kan kiezen. Kies uw client voor de installatie:

Claude Code

Het commando slaat de sleutel op in uw gebruikersinstellingen. De .mcp.json-variant leest hem uit de omgeving, zodat het bestand kan worden gecommit. Een lange conversie kan de standaardtime-out voor tools overschrijden; MCP_TOOL_TIMEOUT=120000 verhoogt die.

Terminal
claude mcp add --transport http rasterless https://api.rasterless.com/mcp \
  --header "Authorization: Bearer $RASTERLESS_API_KEY"
.mcp.json
{
  "mcpServers": {
    "rasterless": {
      "type": "http",
      "url": "https://api.rasterless.com/mcp",
      "headers": { "Authorization": "Bearer ${RASTERLESS_API_KEY}" }
    }
  }
}

Officiële installatiedocumentatie (Claude Code)

Claude Desktopnog niet getest

Deze configuratie hebben wij nog niet met een echte sleutel tegen de live server geprobeerd; ze volgt de eigen documentatie van de client.

Request headers bij aangepaste connectors zijn in bèta en alleen sommige organisaties hebben ze. Ontbreekt de sectie Request headers, dan kan deze client de sleutel nog niet meesturen. De connector wordt gedeeld door iedereen in de organisatie, met één sleutel.

Customize › Connectors › Add custom connector
URL             https://api.rasterless.com/mcp
Authentication  none (the request header carries the key)
Request header  authorization: Bearer rl_live_…

Officiële installatiedocumentatie (Claude Desktop)

Cursornog niet getest

Deze configuratie hebben wij nog niet met een echte sleutel tegen de live server geprobeerd; ze volgt de eigen documentatie van de client.

Cursor leest de sleutel uit de omgevingsvariabele, dus het bestand bevat geen geheim.

~/.cursor/mcp.json
{
  "mcpServers": {
    "rasterless": {
      "url": "https://api.rasterless.com/mcp",
      "headers": { "Authorization": "Bearer ${env:RASTERLESS_API_KEY}" }
    }
  }
}

Officiële installatiedocumentatie (Cursor)

Visual Studio Codenog niet getest

Deze configuratie hebben wij nog niet met een echte sleutel tegen de live server geprobeerd; ze volgt de eigen documentatie van de client.

Het eerste bestand is het huidige formaat. Het oudere .vscode/mcp.json vraagt om de sleutel en houdt hem buiten het bestand; het werkt nog, maar wordt uitgefaseerd.

.mcp.json
{
  "mcpServers": {
    "rasterless": {
      "type": "http",
      "url": "https://api.rasterless.com/mcp",
      "headers": { "Authorization": "Bearer ${RASTERLESS_API_KEY}" },
      "tools": ["*"]
    }
  }
}
.vscode/mcp.json
{
  "inputs": [
    { "type": "promptString", "id": "rasterless-key",
      "description": "API key", "password": true }
  ],
  "servers": {
    "rasterless": {
      "type": "http",
      "url": "https://api.rasterless.com/mcp",
      "headers": { "Authorization": "Bearer ${input:rasterless-key}" }
    }
  }
}

Officiële installatiedocumentatie (Visual Studio Code)

Windsurfnog niet getest

Deze configuratie hebben wij nog niet met een echte sleutel tegen de live server geprobeerd; ze volgt de eigen documentatie van de client.

De agentinstellingen van Windsurf staan nu onder Devin Desktop. Het .local.json-bestand blijft buiten versiebeheer.

.devin/mcp_config.local.json
{
  "mcpServers": {
    "rasterless": {
      "url": "https://api.rasterless.com/mcp",
      "transport": "http",
      "headers": { "Authorization": "Bearer rl_live_…" }
    }
  }
}

Officiële installatiedocumentatie (Windsurf)

Codex CLInog niet getest

Deze configuratie hebben wij nog niet met een echte sleutel tegen de live server geprobeerd; ze volgt de eigen documentatie van de client.

Codex stuurt de waarde van de variabele mee als bearer-token; het bestand zelf bevat geen geheim.

~/.codex/config.toml
[mcp_servers.rasterless]
url = "https://api.rasterless.com/mcp"
bearer_token_env_var = "RASTERLESS_API_KEY"

Officiële installatiedocumentatie (Codex CLI)

Gemini CLInog niet getest

Deze configuratie hebben wij nog niet met een echte sleutel tegen de live server geprobeerd; ze volgt de eigen documentatie van de client.

Gebruik httpUrl: in dit bestand betekent url het oudere SSE-transport.

~/.gemini/settings.json
{
  "mcpServers": {
    "rasterless": {
      "httpUrl": "https://api.rasterless.com/mcp",
      "headers": { "Authorization": "Bearer rl_live_…" }
    }
  }
}

Officiële installatiedocumentatie (Gemini CLI)

Zednog niet getest

Deze configuratie hebben wij nog niet met een echte sleutel tegen de live server geprobeerd; ze volgt de eigen documentatie van de client.

Zonder Authorization-header start Zed in plaats daarvan een aanmeldprocedure, dus laat de header staan.

settings.json
{
  "context_servers": {
    "rasterless": {
      "url": "https://api.rasterless.com/mcp",
      "headers": { "Authorization": "Bearer rl_live_…" }
    }
  }
}

Officiële installatiedocumentatie (Zed)

Clinenog niet getest

Deze configuratie hebben wij nog niet met een echte sleutel tegen de live server geprobeerd; ze volgt de eigen documentatie van de client.

Laat type op streamableHttp staan; zonder die waarde valt Cline terug op het oudere SSE-transport.

cline_mcp_settings.json
{
  "mcpServers": {
    "rasterless": {
      "type": "streamableHttp",
      "url": "https://api.rasterless.com/mcp",
      "headers": { "Authorization": "Bearer rl_live_…" }
    }
  }
}

Officiële installatiedocumentatie (Cline)

Een configuratiebestand bevat de sleutel als platte tekst, tenzij de client hem uit een omgevingsvariabele kan lezen. Waar een client dat documenteert, gebruikt het fragment die variabele; houd het bestand anders buiten versiebeheer.

De MCP-tool kan geen bestand op uw computer openen: hij neemt een openbaar https-adres of de bytes van het bestand als base64. Gebruik het curl-commando uit Snel aan de slag om een bestand op uw schijf vanuit een script om te zetten.

Wat de API niet doet

Vragen

Is de uitvoer dezelfde als op de website?

Ja. De API draait dezelfde engine met dezelfde opties als de omzetter op deze site, dus dezelfde afbeelding met dezelfde instellingen levert dezelfde bestanden op. Alleen het tijdbudget verschilt: 90 seconden per omzetting via de API of MCP tegenover 300 seconden op de site, omdat de API één antwoord aan het eind stuurt; zware afbeeldingen zet u beter op de site om.

Kan ik de API vanuit een webpagina aanroepen?

Doe de aanroepen vanaf uw server. Een sleutel in browsercode kan worden gelezen door iedereen die de pagina opent, en elke conversie die ermee wordt gedaan, telt mee voor uw quotum.

Welke agents kunnen de MCP-server gebruiken?

Elke MCP-client die via Streamable HTTP verbinding kan maken met een remote server en een Authorization-header kan meesturen. Het installatiegedeelte noemt de clients die wij aan de hand van hun eigen documentatie hebben gecontroleerd, met de configuratie die elk van hen verwacht.

Wat gebeurt er met de afbeeldingen die ik stuur?

Hetzelfde als op de site: downloadlinks verlopen na 1 uur, en geüploade afbeeldingen en gemaakte bestanden worden door een automatische verwijderregel na 1 dag verwijderd. Ze worden nergens anders voor gebruikt.

Wat als een conversie te zwaar is?

Ze loopt niet langer door dan haar tijdbudget. U krijgt een 422 in plaats van een bestand. Stelt de body een lager aantal kleuren voor, stuur het verzoek dan opnieuw met dat aantal. Is image_bound false, dan was niet de afbeelding te zwaar maar de tijd van de server krap: stuur hetzelfde verzoek zo meteen opnieuw. Probeer anders een kleinere afbeelding.

Gerelateerde pagina's