[{"data":1,"prerenderedAt":405},["ShallowReactive",2],{"help-article-\u002Fde\u002Fhelp\u002Fdata-and-automation\u002Fdeveloper-area":3},{"id":4,"title":5,"body":6,"category":383,"description":384,"extension":385,"keywords":386,"meta":395,"navigation":396,"order":397,"path":398,"published":399,"rawbody":400,"seo":401,"stem":402,"updated":403,"__hash__":404},"helpDe\u002Fhelp\u002Fdata-and-automation\u002Fdeveloper-area.de.md","Developer-Bereich: API-Keys und Explorer",{"type":7,"value":8,"toc":374},"minimark",[9,28,43,47,50,84,92,95,144,155,159,179,182,188,283,289,305,309,316,324,341,345,354],[10,11,12,13,17,18,21,22,27],"p",{},"Unter ",[14,15,16],"strong",{},"Settings"," → ",[14,19,20],{},"Developer"," findest du alles für die Bluepic API: deine API-Keys, den Explorer zum Testen von Anfragen und die API-Referenz. Jeder Account kann den Developer-Bereich nutzen, mit oder ohne Team. Wie du für ein Template eine Bild-URL oder eine API-Anfrage erzeugst, steht in ",[23,24,26],"a",{"href":25},"\u002Fde\u002Fhelp\u002Fdata-and-automation\u002Fautomation-campaigns","Automate: Bilder per URL und API erzeugen",".",[10,29,30,31,34,35,38,39,42],{},"Oben wechselst du zwischen den Tabs ",[14,32,33],{},"Keys"," und ",[14,36,37],{},"Explorer",". ",[14,40,41],{},"Reference"," oben rechts öffnet die Dokumentation.",[44,45,33],"h2",{"id":46},"keys",[10,48,49],{},"Einen neuen Key erstellst du so:",[51,52,53,65,76],"ol",{},[54,55,56,60,61,64],"li",{},[57,58,59],"click",{},"Klicke"," auf ",[14,62,63],{},"New API key",". Ein Popup öffnet sich.",[54,66,67,71,72,75],{},[68,69,70],"type",{},"Gib"," bei ",[14,73,74],{},"Label"," einen Namen ein, zum Beispiel den Namen deiner Integration.",[54,77,78,60,80,83],{},[57,79,59],{},[14,81,82],{},"Create",". Der neue Key erscheint in der Liste.",[10,85,86],{},[87,88],"img",{"alt":89,"src":90,"width":91},"Settings → Developer → Keys mit dem Button New API key und der Key-Liste; die Secrets sind verdeckt.","https:\u002F\u002Fimagedelivery.net\u002FmudX-CmAqIANL8bxoNCToA\u002Fhelp\u002FKB-developer-area-01\u002Fpublic?v=7d1e04e0",1791,[10,93,94],{},"Nutze für jede Integration einen eigenen Key. Dann kannst du einen abschalten, ohne dass die anderen ausfallen. Die Liste zeigt für jeden Key:",[96,97,98,104,110,116,129],"ul",{},[54,99,100,103],{},[14,101,102],{},"Key",": den Namen, wann er erstellt und zuletzt genutzt wurde.",[54,105,106,109],{},[14,107,108],{},"Secret",": den Key selbst. Mit dem Symbol mit den zwei Blättern in der Zeile kopierst du ihn jederzeit.",[54,111,112,115],{},[14,113,114],{},"Webhook signing secret",": steht unter jedem aktiven Key. Du brauchst es nur, um zu prüfen, ob eine Webhook-Nachricht wirklich von Bluepic kommt.",[54,117,118,121,122,125,126,27],{},[14,119,120],{},"Status",": ",[14,123,124],{},"active"," oder ",[14,127,128],{},"revoked",[54,130,131,135,136,140,141,143],{},[132,133,134],"close",{},"×",": widerruft den Key nach einer Bestätigung. Ab dann bekommt jedes System, das ihn nutzt, einen ",[137,138,139],"code",{},"401","-Fehler. Der Key bleibt als ",[14,142,128],{}," in der Liste. Du kannst ihn nicht wieder einschalten.",[10,145,146,147,150,151,154],{},"Sende den Key als ",[137,148,149],{},"Authorization: Bearer bp_live_…"," an ",[137,152,153],{},"https:\u002F\u002Fapi.bluepic.io\u002Fv1",". Bewahre Keys auf deinem Server oder in Umgebungsvariablen auf, nie in öffentlichem Browsercode oder in einem Code-Repository.",[44,156,158],{"id":157},"keys-im-team","Keys im Team",[96,160,161,164,167,170,173],{},[54,162,163],{},"Ein Key handelt für den Bereich, in dem die Person, die ihn erstellt hat, gerade ist: für ihr Team oder, ohne Team, für ihren persönlichen Account. Verlässt du das Team, handeln deine Keys ab dann für deinen persönlichen Account, nicht mehr für das Team.",[54,165,166],{},"Renderings werden dem Besitzer des Templates berechnet: dem Team, wenn das Template dem Team gehört, sonst dem persönlichen Account.",[54,168,169],{},"Im Team zählen die Renderings aller Keys zum Rate Limit des Teams.",[54,171,172],{},"Anfragen zur Teamverwaltung, etwa Mitglieder einladen oder entfernen, funktionieren nur, wenn du Owner oder Admin bist. Deine Rolle wird bei jeder Anfrage geprüft. Verlierst du diese Rechte, verliert sie auch der Key.",[54,174,175,176,178],{},"Die Liste unter ",[14,177,33],{}," zeigt nur die Keys, die du selbst erstellt hast.",[44,180,37],{"id":181},"explorer",[10,183,184,185,187],{},"Im Tab ",[14,186,37],{}," baust du Anfragen an die API zusammen und sendest sie. Beim Öffnen ist der Render-Endpunkt ausgewählt.",[96,189,190,197,214,232,242,255,261,268],{},[54,191,192,193,196],{},"Links die Liste der Endpunkte: Hier wählst du einen anderen Endpunkt. ",[14,194,195],{},"Search endpoints"," filtert die Liste.",[54,198,199,202,203,202,206,209,210,213],{},[14,200,201],{},"Path",", ",[14,204,205],{},"Query",[14,207,208],{},"Body",": die Felder der Anfrage. Pflichtfelder haben ein ",[137,211,212],{},"*",". Das Info-Symbol neben einem Feld erklärt es.",[54,215,216,219,220,223,224,227,228,231],{},[137,217,218],{},"templateId",": Wählst du eines deiner Templates, zeigt der Explorer unter ",[137,221,222],{},"canvas"," seine Canvases und unter ",[137,225,226],{},"data"," seine Input-Felder, ausgefüllt mit den Standardwerten. ",[14,229,230],{},"Default canvas"," rendert den Standard-Canvas.",[54,233,234,235,238,239,27],{},"Oben rechts die Auswahl, womit die Anfrage gesendet wird: mit einem deiner aktiven Keys oder mit ",[14,236,237],{},"Studio session",", also deinem Studio-Login. Widerrufene Keys stehen nicht zur Auswahl. Daneben zeigt ein Tag, wie viele Renderings du in dieser Minute noch übrig hast, zum Beispiel ",[14,240,241],{},"87\u002F100 renders this minute",[54,243,244,247,248,252,253,27],{},[14,245,246],{},"Send",": sendet eine echte Anfrage. Ein Rendering verbraucht ",[23,249,251],{"href":250},"\u002Fde\u002Fhelp\u002Faccount-management\u002Fcredits","Credits"," und zählt zum Rate Limit, egal ob mit Key oder ",[14,254,237],{},[54,256,257,260],{},[14,258,259],{},"Debug (free)",": zeigt die Render-Anfrage als JSON, so wie die API sie verarbeiten würde. Es wird nichts gerendert und nichts berechnet. Die Anfrage zählt aber zum Rate Limit.",[54,262,263,264,267],{},"Rechts die Antwort mit Status, Dauer und Größe: Ein Bild erscheint als Vorschau, ein Video als Player mit seinen Fortschrittsmeldungen, andere Dateien mit einem Button ",[14,265,266],{},"Download",", JSON als formatierter Text. Ein Fehler zeigt Code und Meldung. Hast du Eingabenamen verwendet, die das Template nicht kennt, siehst du die richtigen.",[54,269,270,202,273,202,276,279,280,27],{},[14,271,272],{},"cURL",[14,274,275],{},"fetch (JS)",[14,277,278],{},"Python",": dieselbe Anfrage als Code unter der Anfrage. Dein Key steht nie darin. Der Code liest ihn aus der Umgebungsvariable ",[137,281,282],{},"BLUEPIC_API_KEY",[10,284,285],{},[87,286],{"alt":287,"src":288},"Explorer: links die Liste der Endpunkte, in der Mitte die Felder der Anfrage, rechts das gerenderte Bild. Oben rechts: verbleibende Renderings pro Minute und Studio session.","https:\u002F\u002Fimagedelivery.net\u002FmudX-CmAqIANL8bxoNCToA\u002Fhelp\u002FKB-developer-area-02\u002Fpublic",[10,290,291,292,295,296,300,301,304],{},"Aus ",[14,293,294],{},"Automate"," im ",[297,298,299],"place",{},"Template-Editor"," öffnest du mit ",[14,302,303],{},"Open in Explorer"," den Explorer in einem neuen Browser-Tab, mit dem Template schon ausgewählt.",[44,306,308],{"id":307},"rate-limit","Rate Limit",[10,310,311,312,315],{},"Render-Anfragen an ",[137,313,314],{},"POST \u002Fv1\u002Frenders"," sind pro Minute begrenzt:",[96,317,318,321],{},[54,319,320],{},"100 pro Minute für ein Team,",[54,322,323],{},"10 pro Minute für einen Account ohne Team.",[10,325,326,327,330,331,202,334,34,337,340],{},"Das Limit gilt für das ganze Team, nicht pro Key. Ein weiterer Key erhöht es also nicht. Ist das Limit erreicht, antwortet die API mit ",[137,328,329],{},"429"," und sagt dir, wann du es wieder versuchen kannst. Jede Render-Antwort enthält die Header ",[137,332,333],{},"X-RateLimit-Limit",[137,335,336],{},"X-RateLimit-Remaining",[137,338,339],{},"X-RateLimit-Reset",". Damit kann deine Integration langsamer werden, bevor sie das Limit erreicht.",[44,342,344],{"id":343},"referenz","Referenz",[10,346,347,349,350,353],{},[14,348,41],{}," oben rechts öffnet die vollständige API-Dokumentation in einem neuen Tab unter ",[137,351,352],{},"https:\u002F\u002Fapi.bluepic.io\u002Fv1\u002Fdocs",". Sie listet alle Endpunkte mit ihren Parametern und Antworten. Du musst dich dafür nicht einloggen. Der Explorer nutzt dieselbe API-Beschreibung, neue Endpunkte erscheinen also auch dort.",[355,356,357],"related",{},[96,358,359,363,368],{},[54,360,361],{},[23,362,26],{"href":25},[54,364,365],{},[23,366,367],{"href":250},"Credits: was Exporte kosten",[54,369,370],{},[23,371,373],{"href":372},"\u002Fde\u002Fhelp\u002Faccount-management\u002Fteams","Team verwalten: Team-Mitglieder einladen, Rollen vergeben, entfernen",{"title":375,"searchDepth":376,"depth":376,"links":377},"",2,[378,379,380,381,382],{"id":46,"depth":376,"text":33},{"id":157,"depth":376,"text":158},{"id":181,"depth":376,"text":37},{"id":307,"depth":376,"text":308},{"id":343,"depth":376,"text":344},"data-and-automation","Was der Developer-Bereich bietet: API-Keys erstellen und widerrufen, Keys im Team, Anfragen im Explorer testen, Rate Limit und API-Referenz.","md",[20,387,388,389,63,37,41,390,391,308,392,114,237,259,393,394],"API","API Keys","API-Key","Bearer","rate limit","curl","Entwickler","Schlüssel",{},true,40,"\u002Fhelp\u002Fdata-and-automation\u002Fdeveloper-area.de","2026-10-13","---\ntitle: \"Developer-Bereich: API-Keys und Explorer\"\ndescription: \"Was der Developer-Bereich bietet: API-Keys erstellen und widerrufen, Keys im Team, Anfragen im Explorer testen, Rate Limit und API-Referenz.\"\ncategory: data-and-automation\norder: 40\nkeywords: [\"Developer\", \"API\", \"API Keys\", \"API-Key\", \"New API key\", \"Explorer\", \"Reference\", \"Bearer\", \"rate limit\", \"Rate Limit\", \"curl\", \"Webhook signing secret\", \"Studio session\", \"Debug (free)\", \"Entwickler\", \"Schlüssel\"]\n---\n\nUnter **Settings** → **Developer** findest du alles für die Bluepic API: deine API-Keys, den Explorer zum Testen von Anfragen und die API-Referenz. Jeder Account kann den Developer-Bereich nutzen, mit oder ohne Team. Wie du für ein Template eine Bild-URL oder eine API-Anfrage erzeugst, steht in [Automate: Bilder per URL und API erzeugen](\u002Fde\u002Fhelp\u002Fdata-and-automation\u002Fautomation-campaigns).\n\nOben wechselst du zwischen den Tabs **Keys** und **Explorer**. **Reference** oben rechts öffnet die Dokumentation.\n\n## Keys\n\nEinen neuen Key erstellst du so:\n\n1. :click[Klicke] auf **New API key**. Ein Popup öffnet sich.\n2. :type[Gib] bei **Label** einen Namen ein, zum Beispiel den Namen deiner Integration.\n3. :click[Klicke] auf **Create**. Der neue Key erscheint in der Liste.\n\n![Settings → Developer → Keys mit dem Button New API key und der Key-Liste; die Secrets sind verdeckt.](https:\u002F\u002Fimagedelivery.net\u002FmudX-CmAqIANL8bxoNCToA\u002Fhelp\u002FKB-developer-area-01\u002Fpublic?v=7d1e04e0){width=\"1791\"}\n\nNutze für jede Integration einen eigenen Key. Dann kannst du einen abschalten, ohne dass die anderen ausfallen. Die Liste zeigt für jeden Key:\n\n- **Key**: den Namen, wann er erstellt und zuletzt genutzt wurde.\n- **Secret**: den Key selbst. Mit dem Symbol mit den zwei Blättern in der Zeile kopierst du ihn jederzeit.\n- **Webhook signing secret**: steht unter jedem aktiven Key. Du brauchst es nur, um zu prüfen, ob eine Webhook-Nachricht wirklich von Bluepic kommt.\n- **Status**: **active** oder **revoked**.\n- :close[×]: widerruft den Key nach einer Bestätigung. Ab dann bekommt jedes System, das ihn nutzt, einen `401`-Fehler. Der Key bleibt als **revoked** in der Liste. Du kannst ihn nicht wieder einschalten.\n\nSende den Key als `Authorization: Bearer bp_live_…` an `https:\u002F\u002Fapi.bluepic.io\u002Fv1`. Bewahre Keys auf deinem Server oder in Umgebungsvariablen auf, nie in öffentlichem Browsercode oder in einem Code-Repository.\n\n## Keys im Team\n\n- Ein Key handelt für den Bereich, in dem die Person, die ihn erstellt hat, gerade ist: für ihr Team oder, ohne Team, für ihren persönlichen Account. Verlässt du das Team, handeln deine Keys ab dann für deinen persönlichen Account, nicht mehr für das Team.\n- Renderings werden dem Besitzer des Templates berechnet: dem Team, wenn das Template dem Team gehört, sonst dem persönlichen Account.\n- Im Team zählen die Renderings aller Keys zum Rate Limit des Teams.\n- Anfragen zur Teamverwaltung, etwa Mitglieder einladen oder entfernen, funktionieren nur, wenn du Owner oder Admin bist. Deine Rolle wird bei jeder Anfrage geprüft. Verlierst du diese Rechte, verliert sie auch der Key.\n- Die Liste unter **Keys** zeigt nur die Keys, die du selbst erstellt hast.\n\n## Explorer\n\nIm Tab **Explorer** baust du Anfragen an die API zusammen und sendest sie. Beim Öffnen ist der Render-Endpunkt ausgewählt.\n\n- Links die Liste der Endpunkte: Hier wählst du einen anderen Endpunkt. **Search endpoints** filtert die Liste.\n- **Path**, **Query**, **Body**: die Felder der Anfrage. Pflichtfelder haben ein `*`. Das Info-Symbol neben einem Feld erklärt es.\n- `templateId`: Wählst du eines deiner Templates, zeigt der Explorer unter `canvas` seine Canvases und unter `data` seine Input-Felder, ausgefüllt mit den Standardwerten. **Default canvas** rendert den Standard-Canvas.\n- Oben rechts die Auswahl, womit die Anfrage gesendet wird: mit einem deiner aktiven Keys oder mit **Studio session**, also deinem Studio-Login. Widerrufene Keys stehen nicht zur Auswahl. Daneben zeigt ein Tag, wie viele Renderings du in dieser Minute noch übrig hast, zum Beispiel **87\u002F100 renders this minute**.\n- **Send**: sendet eine echte Anfrage. Ein Rendering verbraucht [Credits](\u002Fde\u002Fhelp\u002Faccount-management\u002Fcredits) und zählt zum Rate Limit, egal ob mit Key oder **Studio session**.\n- **Debug (free)**: zeigt die Render-Anfrage als JSON, so wie die API sie verarbeiten würde. Es wird nichts gerendert und nichts berechnet. Die Anfrage zählt aber zum Rate Limit.\n- Rechts die Antwort mit Status, Dauer und Größe: Ein Bild erscheint als Vorschau, ein Video als Player mit seinen Fortschrittsmeldungen, andere Dateien mit einem Button **Download**, JSON als formatierter Text. Ein Fehler zeigt Code und Meldung. Hast du Eingabenamen verwendet, die das Template nicht kennt, siehst du die richtigen.\n- **cURL**, **fetch (JS)**, **Python**: dieselbe Anfrage als Code unter der Anfrage. Dein Key steht nie darin. Der Code liest ihn aus der Umgebungsvariable `BLUEPIC_API_KEY`.\n\n![Explorer: links die Liste der Endpunkte, in der Mitte die Felder der Anfrage, rechts das gerenderte Bild. Oben rechts: verbleibende Renderings pro Minute und Studio session.](https:\u002F\u002Fimagedelivery.net\u002FmudX-CmAqIANL8bxoNCToA\u002Fhelp\u002FKB-developer-area-02\u002Fpublic)\n\nAus **Automate** im :place[Template-Editor] öffnest du mit **Open in Explorer** den Explorer in einem neuen Browser-Tab, mit dem Template schon ausgewählt.\n\n## Rate Limit\n\nRender-Anfragen an `POST \u002Fv1\u002Frenders` sind pro Minute begrenzt:\n\n- 100 pro Minute für ein Team,\n- 10 pro Minute für einen Account ohne Team.\n\nDas Limit gilt für das ganze Team, nicht pro Key. Ein weiterer Key erhöht es also nicht. Ist das Limit erreicht, antwortet die API mit `429` und sagt dir, wann du es wieder versuchen kannst. Jede Render-Antwort enthält die Header `X-RateLimit-Limit`, `X-RateLimit-Remaining` und `X-RateLimit-Reset`. Damit kann deine Integration langsamer werden, bevor sie das Limit erreicht.\n\n## Referenz\n\n**Reference** oben rechts öffnet die vollständige API-Dokumentation in einem neuen Tab unter `https:\u002F\u002Fapi.bluepic.io\u002Fv1\u002Fdocs`. Sie listet alle Endpunkte mit ihren Parametern und Antworten. Du musst dich dafür nicht einloggen. Der Explorer nutzt dieselbe API-Beschreibung, neue Endpunkte erscheinen also auch dort.\n\n::related\n- [Automate: Bilder per URL und API erzeugen](\u002Fde\u002Fhelp\u002Fdata-and-automation\u002Fautomation-campaigns)\n- [Credits: was Exporte kosten](\u002Fde\u002Fhelp\u002Faccount-management\u002Fcredits)\n- [Team verwalten: Team-Mitglieder einladen, Rollen vergeben, entfernen](\u002Fde\u002Fhelp\u002Faccount-management\u002Fteams)\n::\n",{"title":5,"description":384},"help\u002Fdata-and-automation\u002Fdeveloper-area.de","2026-10-22","YEHHyFWbYDCm6H1lBbCS8blY1NKaJFTolA4dG9E20Q4",1792680563111]