Carpe Diem – Dokumentation

Was Carpe Diem ist

Carpe Diem ist ein Marktplatz für KI-Inferenz auf Base. Du rufst Sprach-, Bild-, Audio-, Video- und Embedding-Modelle auf – den Katalog von Venice, einschließlich Claude-, GPT-, DeepSeek-, Kimi-, Qwen- und GLM-Modellen – über eine OpenAI- und Anthropic-kompatible API und zahlst nur, was du nutzt, meist unter dem Listenpreis von Venice selbst.

Anfragen werden auf zwei Arten bedient:

• Im TEE von Carpe (/v1): versiegelte Hardware, in die weder der Host noch das Carpe-Diem-Team hineinsehen kann, vor Venice.ai, dem auf Privatsphäre ausgerichteten KI-Anbieter.
• Zum besten Preis (/router): Jede Anfrage wird bei Carpe und mehreren anderen Märkten bepreist, und der günstigste bedient sie – mit einem Schalter, um auf TEE-Märkten zu bleiben oder auf Märkten, die nichts speichern.

Es gibt drei Einstiege:

Und DIEM-Inhaber können verdienen, indem sie das Venice-Inferenzkontingent verkaufen, das sie nicht nutzen: siehe Provider werden.

Unser Platz im Venice-Ökosystem

Carpe Diem ist kein Konkurrent von Venice – es erweitert Venice. Wer DIEM auf Venice stakt, erhält ein tägliches Inferenzkontingent von rund 1 $ pro DIEM; die meisten Inhaber schöpfen es nie aus, und was beim täglichen Reset nicht verbraucht ist, verfällt. Carpe Diem macht aus diesem brachliegenden Kontingent einen Marktplatz: Ein DIEM-Inhaber hinterlegt einen Key und verdient an Nachfrage, die sonst verpufft wäre, ein Entwickler bekommt Venice-Modelle zu einem niedrigeren, marktgetriebenen Preis, und mehr von der Kapazität des Netzwerks wird tatsächlich genutzt.

Schnellstart

Von null zur ersten Antwort in wenigen Minuten. Alles passiert im Bereich API der Website.

1. Anmelden

Öffne API → Start und melde dich mit einer EVM-Wallet an (MetaMask, Rabby, WalletConnect…) – eine kostenlose Signatur, kein Gas – oder mit deiner E-Mail-Adresse. In beiden Fällen ohne KYC.

2. Guthaben aufladen

In API → Balance, mit einer Wallet auf Base:

• Credits – zahle USDC ein (oder einen anderen Token, der in derselben Transaktion in USDC getauscht wird) und erhalte ein Guthaben, das pro Anfrage abgebaut wird. 1 Credit = 0,01 $.
• Prepaid-Konto – zahle USDC auf ein Konto ein, das für dich angelegt wird und dir gehört; Carpe zieht nur die exakten Kosten jeder Anfrage ein, und den Rest kannst du jederzeit abheben.

Kartenzahlung für Konten ohne Wallet wird gerade freigeschaltet. Die Unterschiede zwischen den Zahlungswegen findest du unter Bezahlmöglichkeiten.

3. API-Key erstellen

Erstelle in API → Keys einen Key. Er sieht aus wie cdm_… und wird nur einmal angezeigt: Bewahre ihn sicher auf. Leg pro App oder Agent einen eigenen Key an, damit die Ausgaben jedes einzelnen separat sichtbar sind, und widerrufe jeden davon, wann immer du willst.

4. Dein erster Aufruf

curl https://carpe-diem.xyz/api/operator/v1/chat/completions \
  -H "Authorization: Bearer $CARPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-v4-flash", "messages": [{"role": "user", "content": "Hello in one sentence."}]}'

from openai import OpenAI
 
client = OpenAI(base_url="https://carpe-diem.xyz/api/operator/v1", api_key="cdm_your_key")
r = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "Hello in one sentence."}],
)
print(r.choices[0].message.content)

import OpenAI from "openai";
 
const client = new OpenAI({ baseURL: "https://carpe-diem.xyz/api/operator/v1", apiKey: process.env.CARPE_API_KEY });
const r = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [{ role: "user", content: "Hello in one sentence." }],
});
console.log(r.choices[0].message.content);

Jede Modell-ID aus /v1/models funktioniert in model; die Seite Models zeigt sie mit Live-Preisen.

5. Nächste Schritte

• Binde Carpe in deine Tools ein – Claude Code, OpenCode, Cursor, das OpenAI- oder Anthropic-SDK, LangChain, Open WebUI…: Integrationen.
• Gib deinem KI-Assistenten Tools für Bild, Video, Stimme und Web: MCP-Server.
• Vollständige Rezepte mit Code und Kosten – Bilder, Video, Stimme, RAG, Web-Recherche, Extraktion: Anwendungsfälle.
• Alle Endpoints: API-Referenz.

So funktioniert es

Das Gesamtbild

Eine Anfrage macht einen Hin- und Rückweg über den Operator, einen privaten Proxy, der in einem TEE vor den Modellanbietern läuft:

Auf /v1 leitet der Operator deine Anfrage mit dem Key eines Providers an Venice weiter, gibt die Antwort zurück und belastet dein Guthaben. Auf /router bepreist er die Anfrage zuerst auf jedem Markt – bei Carpe selbst und bei externen – und schickt sie an den günstigsten, der sie bedienen kann (siehe Zwei Zugänge). In beiden Fällen hast du immer nur deinen cdm_-Key in der Hand.

Die Bausteine

Der Escrow – Zahlungen und Guthaben, on-chain. Der Escrow ist ein einzelner Smart Contract auf Base. Wenn du Credits kaufst, werden deine USDC dort eingezahlt, und ein On-Chain-Eintrag hält dein Credit-Guthaben fest – die Menge an Inferenz, die du ausgeben darfst. Credits sind ein Nutzungsanspruch, keine Einlage: Es gibt keine Auszahlung, und die eingehenden USDC werden zu Protokollmitteln, die die Provider bezahlen und das Netzwerk betreiben. (Die anderen Zahlungswege – das Prepaid-Konto und Wallet-Zahlungen (x402), siehe Bezahlmöglichkeiten – funktionieren anders: Dort bleiben die Mittel auf einem Konto, das dir gehört und von dem du abheben kannst; der Escrow zieht nur die exakten Kosten pro Anfrage ein.) Da der Contract öffentlich ist, kann jeder jederzeit die Gesamtguthaben und die On-Chain-Abrechnung überprüfen.

Der Operator – das private Gehirn. Der Operator authentifiziert deinen API-Key, wählt einen verfügbaren Provider, leitet deine Anfrage an Venice weiter und gibt die Antwort zurück. Er läuft in einem TEE (Trusted Execution Environment) – versiegelter Hardware, in die weder der Host-Rechner noch das Carpe-Diem-Team hineinsehen können. Das hält deine Prompts und die Venice-Keys der Provider vertraulich.

Venice – die Inferenz. Venice.ai führt die Modelle tatsächlich aus. Der Operator hält die Venice-Keys der Provider und nutzt sie, um deine Anfrage zu bedienen; du siehst oder verwaltest selbst nie einen Venice-Key.

On-Chain-Guthaben vs. Live-Credit-Guthaben

Dein Credit-Guthaben wird an zwei Stellen geführt, und es lohnt sich zu wissen, warum:

Bei einer Anfrage wird dein Live-Guthaben sofort im Operator belastet. Der On-Chain-Eintrag ändert sich nur, wenn du weitere Credits kaufst oder wenn der Operator periodisch einen Nutzungs-Batch on-chain abrechnet. Zwischen zwei Abrechnungen können die beiden Werte abweichen: Der On-Chain-Wert spiegelt die Käufe wider, der Live-Wert die Käufe abzüglich allem, was du bereits ausgegeben hast.

Stell es dir wie eine Prepaid-Karte vor: Credits kaufen lädt die Karte auf (on-chain verbucht); jede Anfrage ist ein Bezahlvorgang, der das Live-Guthaben sofort reduziert. Der Operator gleicht seine Bücher periodisch mit der Chain ab – das ist die Abrechnung (Settlement).

Der Lebenszyklus einer Anfrage

Vom Aufruf der API bis zur Bezahlung der Provider:

1. Du sendest eine Anfrage mit deinem API-Key (cdm_…) an einen Standard-Endpoint wie /v1/chat/completions (oder /router/chat/completions, der zuerst die Märkte vergleicht – siehe Zwei Zugänge).
2. Der Operator authentifiziert den Key und ordnet ihn deiner Wallet zu.
3. Er führt eine Vorabprüfung durch – hast du genug Live-Credits, und hat ein Provider genug Venice-Kapazität, um die Anfrage zu bedienen? Falls nicht, wird die Anfrage sauber abgelehnt, bevor irgendeine Inferenz stattfindet.
4. Er wählt einen Provider anhand von Echtzeit-Zustand, verfügbarer Kapazität und aktuellem dynamischem Preis.
5. Er leitet die Anfrage an Venice weiter, das das Modell ausführt und die Antwort an den Operator zurückgibt.
6. Er bepreist und belastet – der Operator berechnet die Kosten (Venices Rohkosten × aktueller Preismultiplikator), belastet sofort dein Live-Credit-Guthaben und erfasst die Nutzung.
7. Er gibt dir die Antwort zurück, inklusive Headern, die deine verbleibenden Credits melden.

Bis hierhin wurde die Blockchain nicht berührt – alles geschieht sofort, im TEE. Die Bezahlung der Provider läuft separat:

8. Abrechnung (Settlement). Während sich Nutzung ansammelt, rechnet der Operator periodisch einen Batch on-chain in einer einzigen Transaktion ab: Er wandelt die geschuldeten USDC in DIEM um, verteilt sie an die Provider, die die Anfragen bedient haben, und behält die Protokollgebühr ein. Das ist der einzige On-Chain-Schreibvorgang im normalen Ablauf – durch das Bündeln bleiben die Gaskosten pro Anfrage vernachlässigbar.

Zwei Zugänge: /v1 und /router

Derselbe Key, dieselben Request-Bodies, zwei Basis-URLs:

Lass dir eine Anfrage vor dem Senden kostenlos auf jedem Markt bepreisen: POST /router/quote. Der Router-Abschnitt der API-Referenz enthält das Pfad-Mapping, die Liste der Märkte und wie du einen bestimmten Markt festlegst.

Bezahlmöglichkeiten

Pay-as-you-go: kein Abo, kein Mindestbetrag. Alle Zahlungswege zahlen pro Anfrage denselben Preis; sie unterscheiden sich darin, wie das Geld verwahrt wird.

Prepaid-Konto. Zahle USDC über API → Balance ein: Das Konto wird im selben gasfreien Schritt angelegt und autorisiert. Carpe zieht nur die exakten Kosten jeder Anfrage ein, und du kannst den Rest jederzeit auf deine Wallet abheben oder die Autorisierung widerrufen.

Credits. Zahle USDC ein (oder tausche einen anderen Token in derselben Transaktion) und erhalte ein nicht erstattungsfähiges Nutzungsguthaben: Die USDC werden zu Protokollmitteln, die die Provider bezahlen. 1 Credit = 0,01 $. Credits werden nie umgewandelt oder ausgezahlt.

Wallet (x402). Ein Agent mit einem Private Key und USDC auf Base bezahlt jede Anfrage aus seiner Wallet, ohne Registrierung und ohne Key: Er erhält eine 402-Challenge, signiert einmal (ein auf sein Budget gedeckeltes Permit) und sendet erneut. Siehe Pro Anfrage bezahlen.

Welcher Zahlungsweg zahlt. Dein Konto hat einen Zahlungsmodus – Credits, Prepaid oder Auto (zuerst Credits, dann das Prepaid-Konto) –, den du in API → Balance einstellst; einem Key kannst du beim Erstellen einen eigenen Modus geben. Kann der Zahlungsweg eine Anfrage nicht decken, lautet die Antwort 402 PAYMENT_REQUIRED, bevor irgendetwas ausgeführt wird. E-Mail-Konten zahlen mit Credits.

Jede Antwort meldet, was sie gekostet hat und was übrig ist (X-Carpe-Available-Credits), sodass sich eine App oder ein Agent selbst budgetieren kann; GET /v1/credits liefert das Guthaben auf Abruf.

Dynamische Preise

Der Preis von Carpe Diem schwankt danach, wie viel von der geteilten Inferenzkapazität des Tages noch verfügbar ist – je mehr vom täglichen DIEM-Pool übrig ist, desto weniger zahlst du. Die zentrale Garantie: Dein Gesamtpreis, Protokollgebühr inklusive, liegt nie über dem Direktpreis von Venice.

• Eine Untergrenze und eine harte Obergrenze. Dein Gesamtpreis reicht von einer Untergrenze bei etwa 15 % des Venice-Preises bis zu maximal 100 % des Venice-Preises – nie mehr.
• Die Gebühr von 5 % liegt innerhalb dieser Obergrenze, nicht obendrauf. Der nachfrageabhängige Anteil ist so gedeckelt, dass Nachfrage + Gebühr selbst in der Spitze genau beim Venice-Preis landen. Die Gebühr hebt dich nie darüber.
• Gesteuert durch die tägliche Pool-Auslastung. Jeden Tag füllt das gestakte DIEM der Provider einen gemeinsamen Pool auf. Ist wenig davon verbraucht, liegen die Preise nahe der Untergrenze; je mehr verbraucht wird, desto mehr steigen sie Richtung Obergrenze.
• Auch die Größe deiner Anfrage zählt. Der Preis ist der höhere von zwei Werten: wie stark der tägliche Pool erschöpft ist und wie groß deine Anfrage im Verhältnis zur Kapazität ist, die sie bedienen kann. Eine kleine Anfrage (ein Chat-Turn, ein Bild) bleibt nahe am Pool-Preis; eine große (ein Video, das einen großen Teil der verbleibenden Kapazität beansprucht) zahlt einen Aufschlag für ihren Fußabdruck – du zahlst für deine eigene Nachfrage, nicht nur für die Tageszeit.
• Täglicher Reset um 00:00 UTC.

Beispiel. Angenommen, eine Anfrage kostet 0,10 $ zum Direktpreis von Venice.

• Früh am Tag, Pool größtenteils frei → du zahlst etwa 0,015 $ (~15 %).
• Spät am Tag, Pool fast aufgebraucht → dieselbe Anfrage steigt Richtung 0,10 $ – der Venice-Preis, Gebühr inklusive, und nie darüber.

Dieselbe Anfrage, dasselbe Modell – der Preis spiegelt nur wider, wie viel geteilte Kapazität übrig ist.

Den Live-Stand siehst du auf der Seite Models oder mit GET /v1/capacity und /pricing. Der Best-Price-Router findet auf einem anderen Markt womöglich einen noch niedrigeren Preis – siehe Zwei Zugänge.

Authentifizierung

API-Keys (cdm_…) – zum Aufrufen der API. Sende bei jeder Anfrage Authorization: Bearer cdm_…. Keys laufen nicht ab; du kannst mehrere haben und jeden davon sofort in API → Keys widerrufen – oder einen geleakten Key sich mit POST /v1/keys/self/revoke selbst widerrufen lassen. Die Anthropic-Endpoints (/v1/messages) akzeptieren den Key auch als x-api-key.

Sessions – zum Verwalten deines Kontos. Die Anmeldung auf der Website, per Wallet-Signatur oder E-Mail-Code, öffnet eine Session (ein Token, 30 Minuten gültig und verlängert, solange du aktiv bist, höchstens 8 Stunden). Keys erstellen oder widerrufen und Zahlungseinstellungen ändern erfordert eine Session: Ein API-Key kann keine Keys verwalten, ein geleakter Key kann also keine weiteren erzeugen.

x402 – ganz ohne Konto. Das signierte USDC-Permit eines Agents ist zugleich seine Zahlung und seine Identität. Siehe Bezahlmöglichkeiten.

Modelle

Carpe bedient den gesamten Katalog von Venice, automatisch synchronisiert – heute rund 400 Modelle:

GET /v1/models ist die OpenAI-kompatible Liste (sie funktioniert mit client.models.list()); jeder Eintrag enthält zusätzlich:

• privacy – private (Venice führt das Modell aus, ohne Prompts oder Antworten zu speichern) oder anonymized (über einen Drittanbieter bedient, etwa bei Claude- und GPT-Modellen, ohne deine Identität).
• capabilities – Vision, Tool Calling, Reasoning, JSON-Schema, Websuche, TEE-Attestierung…
• constraints – die Parameter, die das Modell akzeptiert: Dauern und Größen für Video, Stimmen für Sprachausgabe, Längen für Musik. Lies sie, bevor du ein Formular baust.
• tier – standard, premium oder frontier: der Basispreis vor dem dynamischen Preis.

GET /models liefert denselben Katalog nach Typ gruppiert, und GET /router/models ergänzt für jedes Textmodell die Märkte, die es bedienen können.

Datenschutz & Sicherheit

Kein KYC. Eine Wallet oder eine E-Mail-Adresse – mehr ist ein Konto nicht. Mit x402 nicht einmal das: Die Wallet ist die Identität.

Versiegelte Ausführung. Der Operator läuft in einem Trusted Execution Environment (Intel TDX auf Phala Cloud): Weder der Host noch das Carpe-Diem-Team können hineinsehen. Deine Prompts und Antworten, die Venice-Keys der Provider und das Live-Ledger bleiben darin. Auf /v1 läuft jede Anfrage hindurch; auf /router kann eine Anfrage von einem externen Markt bedient werden, es sei denn, du sendest "privacy": true (nur TEE-Märkte) oder "privacy": "private" (Märkte, die nichts speichern).

Private Modelle. Über das TEE hinaus: Wähle ein als privacy: "private" gelistetes Modell – Venice bedient es, ohne irgendetwas zu speichern.

Überprüfbar statt „vertrau uns“. Das TEE erzeugt eine Hardware-Attestierung des exakten Codes, den es ausführt: GET /attestation oder die Seite Privacy.

Transparentes Geld. Einzahlungen, Abrechnungen, Gebühren und Gesamtguthaben liegen auf Base, öffentlich und prüfbar.

Limits & Fehler

• Rate Limits. Pro Konto: derzeit 600 Anfragen pro Minute, mit deinen parallelen Lanes wachsend (eine pro 10 $ Guthaben), plus ein separates Budget für kostenlose Lesezugriffe wie dein Guthaben. Deine Werte liest du mit GET /v1/rate_limits. Jedes Modell hat zudem die eigenen Limits von Venice: GET /v1/limits/:model und GET /v1/capacity.
• Fehler sind JSON mit einem stabilen code; die Chat-Endpoints nutzen das Fehlerformat von OpenAI, /v1/messages das von Anthropic. Diese solltest du behandeln: 402 PAYMENT_REQUIRED (aufladen), 429 (Retry-After abwarten), 503 (gerade keine Kapazität – später erneut versuchen), 400 INVALID_TOOLS (eine Tool-Definition ist fehlerhaft). Die vollständige Tabelle, inklusive was sich zu wiederholen lohnt: Fehler & Retries.
• Regionen. Sanktionierte Länder werden abgelehnt (451). Inferenz aus den USA zu kaufen ist erlaubt; als Provider tätig zu sein und zu staken nicht.
• Was es nicht gibt. Carpe bedient Chat Completions, nicht die Responses API von OpenAI (/v1/responses), und hat kein /v1/messages/count_tokens. Tools, die eines davon benötigen, sind unter Integrationen aufgeführt.

Provider werden

Die Idee

Es gibt zwei Wege, Provider zu werden, und sie unterscheiden sich nur darin, woher der Venice-Key kommt.

Bring deinen eigenen Key mit. Wenn du DIEM auf Venice stakst, hast du ein tägliches Inferenzkontingent, das du vermutlich nicht voll nutzt. Du leihst dieses Kontingent dem Marktplatz: Carpe Diem leitet bezahlte Anfragen an deinen Venice-Key, und du verdienst DIEM an jeder Anfrage, die du bedienst – so wird brachliegende Kapazität zu Einnahmen. Siehe Deinen Venice-Key hinterlegen.

Oder stake DIEM hier und lass uns einen minten. Wenn du DIEM hältst, aber kein Venice-Konto hast, kann der Operator in seiner Enclave einen Key für dich minten, wo er versiegelt bleibt – du siehst ihn nie, und wir auch nicht. Siehe Stattdessen DIEM staken.

Das Geld funktioniert in beiden Fällen gleich:

Du verdienst 65 % des Werts jeder Anfrage, die dein Key bedient, nach einem Protokollaufschlag (5 % der Venice-Basiskosten, die zuerst abgezogen werden; das Protokoll behält den Aufschlag plus 35 % des Rests). Gemessen an dem, was der Käufer tatsächlich bezahlt hat, liegt dein Anteil je nach dynamischem Preis bei etwa 43–62 % – das Panel Where every dollar goes im Revenue-Tab zeigt die echten Zahlen deines Zeitfensters. Die Einnahmen laufen in DIEM auf und gehören dir; du kannst sie jederzeit on-chain abheben.

Deinen Venice-Key hinterlegen

1. Erstelle in deinem Venice-Konto einen API-Key nur für Inferenz, idealerweise mit einem Verbrauchslimit und einem Ablaufdatum. Ein Inferenz-Key ist alles, was Carpe Diem braucht – es gibt keinen Grund, einen Admin-Key zu hinterlegen.
2. Öffne die Earn-Seite und verbinde die Wallet, mit der du dein DIEM stakst.
3. Signiere eine Nachricht (kostenlos, kein Gas), um zu beweisen, dass dir die Wallet gehört, und übermittle deinen Venice-Key.
4. Wähle die Persistenz: persistiert (verschlüsselt gespeichert, übersteht Neustarts) oder nur im RAM (nach jedem Neustart neu hinterlegen – maximale Geheimhaltung).

Dein Venice-Key wird im TEE verschlüsselt, sobald er ankommt – nie sichtbar für den Host oder das Carpe-Diem-Team. Du kannst bis zu 5 Keys pro Wallet registrieren, um deine Kapazität zu vervielfachen.

Key-Hygiene. Das TEE schützt deinen Key im Einsatz – er wird nie auf die Festplatte geschrieben, geloggt oder offengelegt und kann nicht aus der Enclave extrahiert werden (selbst ein Admin-Key ließe sich nicht auslesen). Den Key auf nur Inferenz, mit Limit und Ablaufdatum zu beschränken, ist einfach Defense-in-Depth, die vollständig unter deiner Kontrolle bleibt, und du kannst ihn jederzeit widerrufen – bei Venice oder auf der Provider-Seite, die ihn sofort aus dem TEE entfernt.

Stattdessen DIEM staken und den Key von uns minten lassen

Wenn du kein Venice-Konto hast, erledigt der Stake-Zugang der Earn-Seite das gesamte Setup allein mit DIEM. Du signierst jede Transaktion selbst; kein Key von dir wird je geteilt, denn es gibt keinen Key von dir – der Operator mintet einen in seiner Enclave und versiegelt ihn dort.

1. Berechtigung. Venice mintet einen Key nur für eine Wallet, die etwas gestaktes VVV hält. Hast du keins, bepreist die Seite einen Swap im Wert von ein paar Cent aus deinem ETH, zeigt dir die Zahlen und sendet nichts, bevor du bestätigst.
2. DIEM staken. Das ist der Treibstoff: Gestaktes DIEM ist die Inferenzkapazität, mit der dein Key Anfragen bedient. Es bleibt auf deinen eigenen Namen gestakt, und du kannst es selbst unstaken, vorbehaltlich der Cooldown-Phase von Venice von etwa einem Tag.
3. Minten. Du signierst eine Challenge von Venice; der Operator leitet sie weiter und versiegelt den resultierenden Key in seinem TEE.
4. Wähle deine Märkte. Carpes eigene Käuferseite ist immer aktiv. Carpe Reach ist optional – dein Key bedient dann zusätzliche Käufer über unseren Partner Surplus Intelligence, der einen dedizierten Venice-Key hält, solange du verkaufst: Hake es beim Minten an und akzeptiere die Bedingungen, die direkt unter dem Kästchen stehen, und der Verkauf startet, sobald dein Key bereit ist – eine weitere kostenlose Signatur. Dein Reward-Splitter wird so oder so beim Minten erstellt, sodass du den Verkauf auch später im Markets-Tab einschalten kannst.

Wie du bezahlt wirst, hängt vom Markt ab – und diesen Teil solltest du zweimal lesen. Carpes eigener Traffic zahlt in DIEM direkt auf das Escrow-Guthaben deiner Wallet, ohne Gebühr – das Protokoll nimmt seine Marge bereits auf die Anfrage selbst, hier noch einmal etwas abzuziehen hieße, dich doppelt zu belasten. Carpe Reach zahlt USDC über einen RewardSplitter, der auf deinen Namen deployt wird: 90 % für dich, 10 % für die Treasury, unveränderlich. Dieser Splitter ist der einzige Zahlungsweg mit Gebühr. Er wird beim Minten deines ersten Keys deployt, ob du Carpe Reach anhakst oder nicht – er muss zu diesem Zeitpunkt am Key hinterlegt werden, und ein ohne ihn geminteter Key könnte Carpe Reach später nie beitreten. Das Aufstocken eines bestehenden Keys deployt nie einen.

Alles funktioniert per Pull. Beide Guthaben laufen on-chain auf, bis du sie einforderst; nichts wird je ungefragt in deine Wallet geschoben.

Ein so geminteter Key gehört in deinem Auftrag dem Operator und erscheint daher nicht in der Tabelle Keys des Provider-Dashboards – diese Tabelle listet die Keys, die du selbst hinterlegt hast (der Tab zählt deine gestakten Keys in einer Zeile). Deine Kapazität findest du im Stake-Tab, ihre Märkte im Markets-Tab und beide Claims – das DIEM im Escrow sowie die USDC und DIEM im Splitter – im Revenue-Tab.

Verdienen & abheben

Während dein Key Anfragen bedient, laufen deine DIEM-Einnahmen on-chain auf und werden bei jeder Abrechnung gutgeschrieben. Hebe sie jederzeit mit withdrawDiem des Escrows ab – sie gehen direkt auf deine Wallet. Offene und gesamte Einnahmen verfolgst du über GET /provider/stats und die Earn-Konsole, wo du sie auch einforderst.

Monitoring & Kontrolle

• Log pro Anfrage – GET /provider/usage liefert jede Anfrage, die dein Key bedient hat, neueste zuerst, jeweils mit Zeitstempel, Modell und Kosten. Es ist der maßgebliche Nachweis darüber, was Carpe Diem wann genau über deinen Key geleitet hat – einschließlich sehr neuer Anfragen, die noch nicht on-chain abgerechnet sind.
• Statistiken & Rendite – GET /provider/stats für Anfragezahlen und Einnahmen; GET /providers/:wallet/yield für deine APR auf verkaufte DIEM (aprOnSold7d): sämtliche Einnahmen – Carpe-Verkäufe, Carpe-Reach-Verkäufe und die Rückvergütung des Routers für ungenutzte Kapazität – geteilt durch die DIEM, die du in den letzten 7 Tagen auf Carpe und auf Carpe Reach verkauft hast, annualisiert. sold7d gibt an, wie viele DIEM das waren; Carpe Reach wird über das Verkäuferkonto von Carpe Diem beim Partner gemessen. In der API ist Carpe Reach der Markt surplus mit seinen Feldern.
• Jederzeit widerrufen – entferne einen Key oder deine gesamte Provider-Registrierung mit DELETE /tee/providers/:address (oder pro Key mit …/keys/:keyId). Der Key erhält sofort keinen Traffic mehr.

FAQ

Brauche ich ein Konto? Für einen API-Key ja – eine Wallet oder eine E-Mail-Adresse, ohne KYC. Ein Agent, der mit x402 zahlt, braucht überhaupt kein Konto.

Wie bezahle ich? In USDC auf Base: Credits oder ein Prepaid-Konto, das dir gehört; Agents können pro Anfrage aus einer Wallet zahlen. Kartenzahlung wird gerade freigeschaltet. Siehe Bezahlmöglichkeiten.

Ist es günstiger als direkt? Auf /v1 beginnt der dynamische Preis bei etwa 15 % des Venice-Preises und übersteigt ihn nie, Gebühr inklusive. Auf /router bekommst du für jede Anfrage den günstigsten Markt.

Welche Modelle? Der gesamte Katalog von Venice – Text (einschließlich Claude- und GPT-Modellen), Code, Bild, Video, Sprachausgabe, Musik, Embeddings. GET /v1/models oder die Seite Models.

Kann ich es mit Claude Code, Cursor, ChatGPT… nutzen? Claude Code, OpenCode, Aider, Cline, Continue, Zed und VS Code können mit Carpe-Modellen laufen; Claude Desktop, Claude Code, Cursor, Codex, VS Code und andere können den MCP-Server nutzen. ChatGPT und claude.ai im Web brauchen einen gehosteten MCP-Server, der geplant ist. Details: Integrationen.

Kann jemand meine Prompts sehen? Auf /v1 nicht: Anfragen werden im TEE verarbeitet, und bei einem private-Modell speichert der Anbieter nichts. Auf /router kann ein externer Markt die Anfrage bedienen, es sei denn, du forderst privacy an.

Was, wenn nicht genug Kapazität da ist? Eine Vorabprüfung lehnt sauber ab, bevor irgendetwas ausgeführt oder berechnet wird; der Router kann zudem auf einen anderen Markt ausweichen.

Welches Netzwerk? Base (Ethereum L2): Escrow, Abrechnung und USDC.

Support

• Integrationen, Anwendungsfälle und die API-Referenz
• Protokolldesign: das Whitepaper
• Community & Support: Telegram