Entwickler: die Rasterless-API und der MCP-Server
Rufen Sie denselben Konverter per Bearer-Schlüssel aus einem Skript oder Agenten auf.
Funktioniert mit Ihren bevorzugten Agenten
Alles, was der Konverter auf dieser Website kann, steht auch über HTTP bereit: ein Bild hinein, die gewünschten Formate heraus, mit denselben Optionen und denselben Grenzen. Ein Agent, der das Model Context Protocol spricht, kann ihn über den entfernten MCP-Server als Werkzeug aufrufen, mit demselben Schlüssel.
Die Tabellen auf dieser Seite werden aus dem Code erzeugt, der die Anfragen beantwortet; ein Optionsname oder eine Grenze kann also nicht von dem abweichen, was der Server annimmt. Werte, die noch nicht feststehen, sind als solche gekennzeichnet, statt geschätzt zu werden.
Schnellstart
Melden Sie sich zuerst mit Google an und erstellen Sie im folgenden Bereich einen API-Schlüssel. Schlüssel beginnen mit rl_live_ und werden nur einmal angezeigt. Halten Sie den Schlüssel aus der Versionskontrolle heraus; die Beispiele lesen ihn aus einer Umgebungsvariablen namens RASTERLESS_API_KEY.
Ihre API-Schlüssel
Melden Sie sich auf dieser Seite mit Google an, um Ihre API-Schlüssel zu erstellen und zu verwalten. Der Bereich benötigt JavaScript.
Kopieren Sie diesen Schlüssel jetzt. Er wird nur einmal angezeigt: Wir speichern davon lediglich einen mit geheimem Schlüssel gebildeten Hash sowie die ersten und letzten vier Zeichen, damit Sie ihn in der Liste wiedererkennen.
Bis zu 2 aktive Schlüssel pro Konto.
| Schlüssel | Erstellt | Zuletzt verwendet | Diese Stunde | Heute | Aktion |
|---|
Ihr erster Aufruf
1. Legen Sie den Schlüssel in eine Umgebungsvariable. Ersetzen Sie den Platzhalter durch Ihren Schlüssel. Die Variable gilt, bis Sie dieses Terminalfenster schließen.
export RASTERLESS_API_KEY='IHR_API_SCHLUESSEL'
$env:RASTERLESS_API_KEY = 'IHR_API_SCHLUESSEL'
2. Prüfen Sie den Schlüssel. GET /v1/account antwortet mit dem Schlüssel und seinem verbleibenden Kontingent und zählt nicht als Umwandlung. Ein 401 api_key_invalid bedeutet meist, dass beim Kopieren ein Teil des Schlüssels verloren ging.
curl -sS https://api.rasterless.com/v1/account \
-H "Authorization: Bearer $RASTERLESS_API_KEY"
curl.exe -sS https://api.rasterless.com/v1/account `
-H "Authorization: Bearer $env:RASTERLESS_API_KEY"
3. Wandeln Sie eine Datei von Ihrem Computer um. Nach @ steht der Pfad des Bildes; ./logo.png ist die Datei logo.png in dem Ordner, in dem das Terminal gerade steht. Schreiben Sie in PowerShell curl.exe: In Windows PowerShell startet curl allein einen anderen Befehl. curl.exe ist in Windows 10 ab Build 17063 enthalten.
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
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. Lesen Sie die Antwort. Dieses Beispiel hat die Felder und Typen einer echten Antwort; die Werte stammen aus einer Testumwandlung, die Download-Links sind Platzhalter:
{
"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
}
Die Antwort ist JSON: outputs enthält für jedes angeforderte Format einen signierten Download-Link, colors_used die Farbanzahl, die die Engine verwendet hat. Links laufen nach 1 Stunde ab; laden Sie die Dateien also herunter, wenn die Antwort eintrifft, statt die Links zu speichern. Fordern Sie genau ein Format an und hängen Sie ?return=file an die Adresse, um statt JSON die Datei selbst zu erhalten.
id benennt den Auftrag, seconds ist die Dauer der Umwandlung. shapes zählt die Formen im Ergebnis, preview_url ist eine PNG-Vorschau mit derselben Lebensdauer wie die Links, und colors_auto.detected sagt, ob colors=auto die Anzahl im Bild gefunden oder den Standardwert verwendet hat.
Authentifizierung
Jede Anfrage trägt den Schlüssel über HTTPS im Header Authorization: Bearer. Die API setzt kein Cookie und zeigt keine Browserprüfung: Der Schlüssel ist die gesamte Identität, behandeln Sie ihn also wie ein Passwort und lassen Sie die Aufrufe auf Ihrem Server. Ein Schlüssel in Browsercode oder in einer mobilen App ist ein Schlüssel, den jeder lesen kann. Eine Anfrage ohne Schlüssel gibt 401 api_key_missing zurück, ein falscher Schlüssel 401 api_key_invalid und ein widerrufener Schlüssel 401 api_key_revoked. Ein Widerruf gilt ab der nächsten Anfrage, und jedes Konto kann gleichzeitig nur eine begrenzte Zahl aktiver Schlüssel haben.
Wenn wir einen Ihrer Schlüssel nach den Nutzungsbedingungen sperren oder widerrufen, erscheint er in Ihrer Schlüsselliste als widerrufen, und wir schreiben an die E-Mail-Adresse Ihres Google-Kontos.
Endpunkte und Parameter
| Endpunkt | Beschreibung |
|---|---|
POST /v1/vectorize |
Wandelt ein Bild um und gibt pro Format einen signierten Link zurück. |
GET /v1/options |
Listet die zulässigen Werte jeder Option auf. |
GET /v1/account |
Zeigt das Kontingent des Schlüssels und wie viel davon übrig ist. |
POST /v1/vectorize nimmt multipart/form-data an: das Bild in einem Feld namens image, die Optionen als gewöhnliche Formularfelder. Die Werte sind die Achsen, die GET /v1/options zurückgibt, und die Tabelle wird aus denselben Konstanten gebaut, kann dem Server also nicht widersprechen.
| Parameter | Werte | Standard | Beschreibung |
|---|---|---|---|
image erforderlich |
PNG, JPEG, WEBP, BMP, GIF, AVIF | — | Das Bild als Multipart-Dateifeld. Über den Typ entscheiden die ersten Bytes, nicht der Dateiname. |
formats |
svg, pdf, eps, dxf, png | svg | Ein oder mehrere, durch Kommas getrennt; die Antwort enthält einen Link pro Format. |
colors |
2–64, auto | auto | Palettengröße; 2 ergibt ein Schwarz-Weiß-Tracing. auto liest die Anzahl aus einer flächigen Grafik und fällt sonst auf 26 zurück. |
svg_version |
svg_1_0, svg_1_1, svg_tiny_1_2 | svg_1_1 | Die Version, die im SVG-Wurzelelement steht. |
draw_style |
fill_shapes, stroke_shapes, stroke_edges | fill_shapes | Gefüllte Formen, Konturformen oder nur Kanten. Im DXF ergeben die ersten beiden dieselben geschlossenen Konturen; nur Kanten ergibt offene Pfade. |
shape_stacking |
cutouts, stacked | cutouts | Ausschnitte stanzen Löcher in die darunterliegenden Formen; gestapelt malt sie übereinander. |
group_by |
none, color, parent, layer | none | Nur SVG-Gruppierung: keine, nach Farbe, nach Elternform oder nach Ebene. |
size_mm |
WxH, 1–5000 mm | — | Physische Größe wie 150x150. Gilt für SVG, PDF, EPS und DXF; leer lassen, um Pixeleinheiten zu behalten. |
denoise |
0–50 | 0 | Stärke eines kantenerhaltenden Vorfilters; 0 schaltet ihn ab. Im MCP-Werkzeug nicht verfügbar. |
group_by ändert nur, wie ein SVG seine Pfade gruppiert. Im DXF schreiben fill_shapes und stroke_shapes dieselben geschlossenen Konturen (LWPOLYLINE und SPLINE dritten Grades) auf einer FILL_-Ebene pro Farbe; stroke_edges schreibt stattdessen das Kantennetz, jede Grenze einmal als offenen Pfad, auf EDGE_-Ebenen. Das DXF wird als R2010 (AC1024) mit Millimetern als Einheit geschrieben.
Fehler
Ein Fehler gibt JSON unter error zurück: einen code, einen type, der Codes zu Familien zusammenfasst (bad_input, auth, quota, too_complex, timeout, busy, not_found, server), die zugehörigen Werte in params und eine englische Ersatzmeldung in message. Verzweigen Sie anhand von type, protokollieren Sie code, und parsen Sie nie den Meldungstext. Ein typischer Body ist {"error": {"code": "file_too_large", "type": "bad_input", "params": {"max_mb": 25}}}, die Meldung steht daneben.
Eine Änderung an /v1, die eine heute funktionierende Anfrage brechen würde, kündigen wir mindestens 30 Tage vor ihrem Inkrafttreten auf dieser Seite an. Ergänzungen, mit denen funktionierende Anfragen unverändert bleiben, etwa ein neues optionales Feld, können ohne Ankündigung erscheinen.
| HTTP | Code | Bedeutung |
|---|---|---|
| 400 | image_missing |
Keine Datei im Feld image. |
| 400 | multipart_invalid |
Der Body ließ sich nicht als multipart/form-data lesen. |
| 400 | unsupported_input |
Die Dateiendung ist keine zulässige Eingabe. |
| 400 | not_an_image |
Die ersten Bytes der Datei sind kein zulässiges Rasterbild. |
| 400 | invalid_option |
Eine Option hat einen Wert außerhalb ihrer Liste; params nennt sie. |
| 400 | size_mm_format |
size_mm ist nicht als BxH geschrieben, zum Beispiel 150x150. |
| 400 | size_mm_range |
Eine Seite von size_mm liegt außerhalb des zulässigen Bereichs. |
| 400 | return_needs_one_format |
?return=file wurde mit mehr als einem Format angefordert. |
| 401 | api_key_missing |
Kein Schlüssel im Authorization-Header. |
| 401 | api_key_invalid |
Der Schlüssel ist nicht gültig. |
| 401 | api_key_revoked |
Der Schlüssel wurde widerrufen; erstellen Sie einen neuen. |
| 403 | key_suspended |
Ein Schlüssel des Kontos ist gesperrt; es kann kein neuer Schlüssel erstellt werden. |
| 409 | key_limit |
Das Konto hat bereits die Höchstzahl aktiver Schlüssel. |
| 413 | file_too_large |
Die hochgeladene Datei überschreitet die Grenze für die Dateigröße. |
| 413 | image_too_large |
Das dekodierte Bild überschreitet die Pixelgrenze. |
| 422 | too_complex |
Der Auftrag wurde nicht gestartet: Seine Schätzung liegt über dem Zeitbudget, oder (image_bound false) der Server hatte für diese Anfrage zu wenig Zeit übrig. Eine geringere Farbanzahl wird vorgeschlagen, wenn eine besteht. |
| 422 | timeout |
Die Umwandlung hat ihr Zeitbudget überschritten; weniger Farben helfen nicht, ein kleineres Bild kann helfen. |
| 429 | busy |
Alle Worker sind ausgelastet; nach der Zeit im Retry-After-Header erneut versuchen. |
| 429 | quota_hourly |
Der Schlüssel hat sein Stundenkontingent aufgebraucht. |
| 429 | quota_daily |
Der Schlüssel hat sein Tageskontingent aufgebraucht. |
| 429 | quota_url_fetch |
Der Schlüssel hat seine stündlichen image_url-Abrufe aufgebraucht (MCP-Werkzeug). |
| 429 | quota_requests |
Der Schlüssel hat seine stündliche Zahl an Konvertierungsanfragen gesendet, unabhängig vom Ergebnis; nach der Zeit im Retry-After-Header erneut versuchen. |
| 429 | key_create_limit |
Das Konto hat sein Kontingent an neuen Schlüsseln für die letzten 24 Stunden verbraucht; nach der Zeit im Retry-After-Header erneut versuchen. |
Bei 429 busy warten Sie die Zeit aus dem Header Retry-After ab und senden die Anfrage erneut.
Bei 422 too_complex hat die Umwandlung gar nicht begonnen, und error.image_bound sagt, warum. Ist der Wert true, liegt das Bild selbst über der Grenze. Ist error.suggested_n_colors dann eine Zahl, ist es eine geringere Farbanzahl, deren Schätzung wir gegen die Grenzen einer neuen Anfrage geprüft haben, meist die größte, die besteht; ein neuer Versuch mit dieser Anzahl besteht diese Prüfung. Das ist eine Schätzung, kein Versprechen: Der neue Versuch kann trotzdem mit timeout enden. Ist der Wert null und fewer_colors_help false, bleibt die Schätzung selbst bei 2 Farben über der Grenze; weniger Farben helfen nicht, ein kleineres Bild vielleicht schon. Sind beide null, ließ sich kein Vorschlag berechnen.
Ist image_bound false, liegt es nicht am Bild: Der Server hatte für diese Anfrage zu wenig Zeit übrig. suggested_n_colors und fewer_colors_help sind dann beide null, und dieselbe Anfrage kann gleich noch einmal gesendet werden.
Bei 422 timeout hat die Umwandlung begonnen und ihr Zeitbudget überschritten. Die Farbanzahl ändert die Dauer einer Umwandlung kaum, daher schlägt der Body keine Farbanzahl vor: suggested_n_colors ist null und fewer_colors_help ist false. Ein kleineres Bild hilft nur unter 1,5 Megapixeln, weil größere Bilder für das Tracing ohnehin auf diese Größe verkleinert werden; versuchen Sie etwa die Hälfte davon (z. B. 1000 × 750 px) oder verringern Sie Rauschen und Textur. image_bound gibt es nur bei too_complex.
Ein timeout bucht die Umwandlung ins Kontingent des Schlüssels zurück (quota_refunded: true): einmal pro Bild und Stunde und höchstens 2 Mal pro Schlüssel in jeder vollen Uhrstunde; darüber hinaus steht im Body quota_refunded: false.
Selten überschreitet eine Umwandlung ihr Zeitbudget, und die Verbindung schließt sich nach etwa 100 Sekunden mit HTTP 524 und ohne JSON-Body; behandeln Sie das wie einen timeout.
Grenzen und Kontingent
| Grenze | Wert |
|---|---|
| Umwandlungen pro Schlüssel und Stunde | 20 |
| Umwandlungen pro Schlüssel und Tag | 100 |
| Aktive Schlüssel pro Konto | 2 |
| Neue Schlüssel pro Konto in 24 Stunden, nach den ersten 2 | 1 |
| MCP-Abrufe von image_url pro Schlüssel und Stunde | 120 |
| Konvertierungsanfragen pro Schlüssel und Stunde (API und MCP) | 200 |
| Dateigröße | 25 MB |
| Dekodierte Bildgröße | 40 MP |
| Zeitbudget pro Umwandlung | 90 s |
| Gültigkeit des Download-Links | 1 h |
| size_mm, pro Seite | 1–5000 mm |
Die Abruf-Zeile zählt jedes Mal, wenn das MCP-Werkzeug vectorize_image eine image_url herunterlädt. Gezählt wird, bevor der Download beginnt; ein fehlgeschlagener Download oder einer, der kein Bild liefert, zählt also ebenfalls. Dieser Zähler ist vom Umwandlungskontingent getrennt.
Bilder über 1,5 Megapixel werden vor dem Tracing verkleinert, die Pixelmaße der Ausgabe folgen also der verkleinerten Kopie; setzen Sie size_mm, wenn Sie physische Abmessungen brauchen. Ein Bild pro Anfrage.
Preise
API-Schlüssel und die Umwandlungen, die Sie damit innerhalb des Kontingents oben ausführen, sind während der Beta kostenlos. Ohne Ihre vorherige klare Zustimmung wird nichts berechnet (Nutzungsbedingungen, Abschnitt 4).
MCP-Server
Über den MCP-Server kann ein Agent den Konverter als Werkzeug aufrufen. Er spricht Streamable HTTP unter https://api.rasterless.com/mcp und nimmt denselben Bearer-Schlüssel im selben Header an. Er bietet zwei Werkzeuge: vectorize_image wandelt ein Bild, das entweder als image_url (eine öffentliche https-Adresse) oder als image_base64 übergeben wird, mit den Optionen aus der Parametertabelle um; get_options gibt die zulässigen Werte und das verbleibende Kontingent des Schlüssels zurück, damit der Agent wählen kann. Wählen Sie Ihren Client für die Einrichtung:
Claude Code
Der Befehl speichert den Schlüssel in Ihren Benutzereinstellungen. Die .mcp.json-Variante liest ihn aus der Umgebung, die Datei kann also committet werden. Eine lange Umwandlung kann das Standard-Zeitlimit für Werkzeuge überschreiten; MCP_TOOL_TIMEOUT=120000 hebt es an.
claude mcp add --transport http rasterless https://api.rasterless.com/mcp \
--header "Authorization: Bearer $RASTERLESS_API_KEY"
{
"mcpServers": {
"rasterless": {
"type": "http",
"url": "https://api.rasterless.com/mcp",
"headers": { "Authorization": "Bearer ${RASTERLESS_API_KEY}" }
}
}
}
Claude Desktopnoch nicht getestet
Diese Einrichtung haben wir noch nicht mit einem echten Schlüssel gegen den Live-Server ausprobiert; sie folgt der Dokumentation des Clients.
Request-Header bei benutzerdefinierten Connectors sind in der Beta und nur in manchen Organisationen verfügbar. Fehlt der Abschnitt Request headers, kann dieser Client den Schlüssel noch nicht senden. Den Connector teilen sich alle in der Organisation, mit einem gemeinsamen Schlüssel.
URL https://api.rasterless.com/mcp
Authentication none (the request header carries the key)
Request header authorization: Bearer rl_live_…
Cursornoch nicht getestet
Diese Einrichtung haben wir noch nicht mit einem echten Schlüssel gegen den Live-Server ausprobiert; sie folgt der Dokumentation des Clients.
Cursor liest den Schlüssel aus der Umgebungsvariablen, die Datei enthält also kein Geheimnis.
{
"mcpServers": {
"rasterless": {
"url": "https://api.rasterless.com/mcp",
"headers": { "Authorization": "Bearer ${env:RASTERLESS_API_KEY}" }
}
}
}
Visual Studio Codenoch nicht getestet
Diese Einrichtung haben wir noch nicht mit einem echten Schlüssel gegen den Live-Server ausprobiert; sie folgt der Dokumentation des Clients.
Die erste Datei ist das aktuelle Format. Die ältere .vscode/mcp.json fragt nach dem Schlüssel und hält ihn aus der Datei heraus; sie funktioniert noch, wird aber abgekündigt.
{
"mcpServers": {
"rasterless": {
"type": "http",
"url": "https://api.rasterless.com/mcp",
"headers": { "Authorization": "Bearer ${RASTERLESS_API_KEY}" },
"tools": ["*"]
}
}
}
{
"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}" }
}
}
}
Windsurfnoch nicht getestet
Diese Einrichtung haben wir noch nicht mit einem echten Schlüssel gegen den Live-Server ausprobiert; sie folgt der Dokumentation des Clients.
Die Agent-Einstellungen von Windsurf liegen jetzt unter Devin Desktop. Die .local.json-Datei bleibt außerhalb der Versionskontrolle.
{
"mcpServers": {
"rasterless": {
"url": "https://api.rasterless.com/mcp",
"transport": "http",
"headers": { "Authorization": "Bearer rl_live_…" }
}
}
}
Codex CLInoch nicht getestet
Diese Einrichtung haben wir noch nicht mit einem echten Schlüssel gegen den Live-Server ausprobiert; sie folgt der Dokumentation des Clients.
Codex sendet den Wert der Variablen als Bearer-Token; die Datei selbst enthält kein Geheimnis.
[mcp_servers.rasterless]
url = "https://api.rasterless.com/mcp"
bearer_token_env_var = "RASTERLESS_API_KEY"
Gemini CLInoch nicht getestet
Diese Einrichtung haben wir noch nicht mit einem echten Schlüssel gegen den Live-Server ausprobiert; sie folgt der Dokumentation des Clients.
Verwenden Sie in dieser Datei httpUrl:, denn url steht hier für den älteren SSE-Transport.
{
"mcpServers": {
"rasterless": {
"httpUrl": "https://api.rasterless.com/mcp",
"headers": { "Authorization": "Bearer rl_live_…" }
}
}
}
Zednoch nicht getestet
Diese Einrichtung haben wir noch nicht mit einem echten Schlüssel gegen den Live-Server ausprobiert; sie folgt der Dokumentation des Clients.
Ohne Authorization-Header startet Zed stattdessen einen Anmeldeablauf; lassen Sie den Header also stehen.
{
"context_servers": {
"rasterless": {
"url": "https://api.rasterless.com/mcp",
"headers": { "Authorization": "Bearer rl_live_…" }
}
}
}
Clinenoch nicht getestet
Diese Einrichtung haben wir noch nicht mit einem echten Schlüssel gegen den Live-Server ausprobiert; sie folgt der Dokumentation des Clients.
Lassen Sie type auf streamableHttp; ohne diese Angabe fällt Cline auf den älteren SSE-Transport zurück.
{
"mcpServers": {
"rasterless": {
"type": "streamableHttp",
"url": "https://api.rasterless.com/mcp",
"headers": { "Authorization": "Bearer rl_live_…" }
}
}
}
Eine Konfigurationsdatei enthält den Schlüssel im Klartext, sofern der Client ihn nicht aus einer Umgebungsvariablen lesen kann. Wo ein Client das dokumentiert, nutzt das Snippet diesen Weg; andernfalls halten Sie die Datei aus der Versionskontrolle heraus.
Das MCP-Werkzeug kann keine Datei auf Ihrem Computer öffnen: Es nimmt eine öffentliche https-Adresse oder die Bytes der Datei als Base64. Um eine Datei von Ihrer Festplatte aus einem Skript umzuwandeln, nutzen Sie den curl-Befehl aus dem Schnellstart.
Was die API nicht kann
- Ein Bild pro Anfrage. Es gibt keinen Endpunkt, der einen Ordner oder ein Archiv mit Bildern annimmt.
- Keine Webhooks und keine Auftragswarteschlange: Die Anfrage kehrt zurück, wenn die Umwandlung fertig ist oder ihr Zeitbudget aufgebraucht hat; dieses beträgt hier 90 Sekunden, auf der Website 300 Sekunden, schwere Bilder wandeln Sie also besser auf der Website um.
- Kein SDK. Jeder HTTP-Client, der
multipart/form-datasenden kann, funktioniert. - Eingaben sind PNG, JPEG, WEBP, BMP, GIF oder AVIF; SVG-, PDF-, TIFF- und HEIC-Dateien werden nicht angenommen. Ausgaben sind SVG, PDF, EPS, DXF und PNG, sonst nichts.
- Keine Bearbeitung nach dem Tracing: Die API liefert Dateien, keine bearbeitbare Zeichnung.
Fragen
Ist die Ausgabe dieselbe wie auf der Website?
Ja. Die API nutzt dieselbe Engine mit denselben Optionen wie der Konverter auf dieser Website; dasselbe Bild mit denselben Einstellungen ergibt also dieselben Dateien. Nur das Zeitbudget unterscheidet sich: 90 Sekunden pro Umwandlung über API oder MCP gegenüber 300 Sekunden auf der Website, weil die API eine einzige Antwort am Ende sendet; schwere Bilder wandeln Sie besser auf der Website um.
Kann ich die API aus einer Webseite heraus aufrufen?
Lassen Sie die Aufrufe auf Ihrem Server. Ein Schlüssel im Browsercode kann von jedem gelesen werden, der die Seite öffnet, und jede damit ausgeführte Umwandlung wird auf Ihr Kontingent angerechnet.
Welche Agenten können den MCP-Server nutzen?
Jeder MCP-Client, der sich über Streamable HTTP mit einem entfernten Server verbinden und einen Authorization-Header senden kann. Der Abschnitt zur Einrichtung listet die Clients, die wir anhand ihrer eigenen Dokumentation geprüft haben, jeweils mit der Konfiguration, die sie erwarten.
Was passiert mit den Bildern, die ich sende?
Dasselbe wie auf der Website: Download-Links laufen nach 1 Stunde ab, und hochgeladene Bilder sowie erzeugte Dateien werden durch eine automatische 1-Tages-Löschregel entfernt. Für nichts anderes werden sie verwendet.
Was passiert, wenn eine Umwandlung zu aufwendig ist?
Sie läuft nicht über ihr Zeitbudget hinaus. Statt einer Datei bekommen Sie eine 422. Schlägt der Body eine geringere Farbanzahl vor, senden Sie die Anfrage mit dieser Anzahl erneut. Ist image_bound false, war nicht das Bild zu schwer, sondern die Zeit des Servers knapp: Senden Sie dieselbe Anfrage gleich noch einmal. Sonst versuchen Sie ein kleineres Bild.