● Documentation

Carpe Diem — Documentation

Une seule API compatible OpenAI et Anthropic pour les modèles de Venice et plus encore — dans un TEE ou au meilleur prix du marché, à l'usage, depuis votre code, votre agent de code ou votre assistant IA.

Qu'est-ce que Carpe Diem ?

Carpe Diem est une place de marché d'inférence IA sur Base. Vous appelez des modèles de langage, d'image, d'audio, de vidéo et d'embeddings — le catalogue de Venice, y compris des modèles Claude, GPT, DeepSeek, Kimi, Qwen et GLM — via une seule API compatible OpenAI et Anthropic, et vous ne payez que ce que vous consommez, généralement moins cher que le tarif public de Venice.

Les requêtes sont servies de deux façons :

  • Dans le TEE de Carpe (/v1) : un matériel scellé que ni l'hébergeur ni l'équipe Carpe Diem ne peuvent lire, placé devant Venice.ai, le fournisseur d'IA axé sur la confidentialité.
  • Au meilleur prix (/router) : chaque requête est chiffrée sur Carpe et plusieurs autres marchés, et le moins cher la sert — avec une option pour rester sur des marchés TEE ou sur des marchés qui ne conservent rien.

Il y a trois points d'entrée :

PourCommencer ici
L'APIVotre code, votre agent de code (Claude Code, OpenCode, Aider…), votre application de chatDémarrage rapide, puis Intégrations
Le serveur MCPVotre assistant IA (Claude Desktop, Claude Code, Cursor, Codex, VS Code…), qui dispose alors de l'image, de la vidéo, de la voix, de la musique, de la recherche web et de tous les modèles sous forme d'outilsIntégrations → Serveur MCP
L'application webEssayer des modèles, générer des images et des vidéos, sans codeCreate

Et les détenteurs de DIEM peuvent gagner en vendant l'allocation d'inférence Venice qu'ils n'utilisent pas : voir Devenir provider.

Notre place dans l'écosystème Venice

Carpe Diem n'est pas un concurrent de Venice : il le prolonge. Staker du DIEM sur Venice donne droit à une allocation d'inférence quotidienne d'environ 1 $ par DIEM ; la plupart des détenteurs ne l'utilisent jamais entièrement, et ce qui n'est pas consommé à la réinitialisation quotidienne est perdu. Carpe Diem transforme cette allocation inutilisée en place de marché : un détenteur de DIEM provisionne une clé et gagne sur une demande qu'il aurait sinon gaspillée, un développeur obtient les modèles Venice à un prix plus bas fixé par le marché, et une plus grande part de la capacité du réseau est réellement utilisée.

Démarrage rapide

De zéro à une première réponse en quelques minutes. Tout se passe dans l'espace API du site.

1. Se connecter

Ouvrez API → Start et connectez-vous avec un wallet EVM (MetaMask, Rabby, WalletConnect…) — une signature gratuite, sans gas — ou avec votre adresse e-mail. Aucun KYC dans les deux cas.

2. Approvisionner son compte

Dans API → Balance, avec un wallet sur Base :

  • Crédits — déposez de l'USDC (ou un autre token, converti en USDC dans la même transaction) pour obtenir un solde consommé à chaque requête. 1 crédit = 0,01 $.
  • Compte prépayé — déposez de l'USDC sur un compte créé pour vous et dont vous êtes propriétaire ; Carpe ne prélève que le coût exact de chaque requête, et vous pouvez retirer le reste à tout moment.

Le paiement par carte, pour les comptes sans wallet, est en cours d'ouverture. Les différences entre les modes de paiement sont détaillées dans Moyens de paiement.

3. Créer une clé API

Dans API → Keys, créez une clé. Elle a la forme cdm_… et n'est affichée qu'une seule fois : conservez-la en lieu sûr. Créez une clé par application ou par agent, pour suivre séparément les dépenses de chacun, et révoquez-en n'importe laquelle à tout moment.

4. Votre premier appel

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."}]}'

Tout identifiant de modèle de /v1/models fonctionne dans model ; la page Models les affiche avec leurs prix en direct.

5. Et ensuite

  • Branchez Carpe sur vos outils — Claude Code, OpenCode, Cursor, le SDK OpenAI ou Anthropic, LangChain, Open WebUI… : Intégrations.
  • Donnez à votre assistant IA des outils d'image, de vidéo, de voix et de recherche web : Serveur MCP.
  • Des recettes complètes avec code et coûts — images, vidéo, voix, RAG, recherche web, extraction : Cas d'usage.
  • Tous les endpoints : Référence de l'API.

Fonctionnement

Vue d'ensemble

Une requête fait l'aller-retour via l'operator, un proxy privé qui tourne dans un TEE devant les fournisseurs de modèles :

1YouAPI key — OpenAI / Anthropic-compatible request
2Carpe Diem Operator/v1: picks a provider key · /router: picks the cheapest marketTEE · sealed
3Venice.ai — or the winning marketgenerates the response
4Carpe Diem Operatordebits your balance, relays the responseTEE · sealed
5Youreceive the response

Sur /v1, l'operator transmet votre requête à Venice avec la clé d'un provider, relaie la réponse et débite votre solde. Sur /router, il chiffre d'abord la requête sur chaque marché — Carpe lui-même et des marchés externes — puis l'envoie au moins cher capable de la servir (voir Deux surfaces). Dans les deux cas, vous ne détenez jamais que votre clé cdm_.

Les briques

L'escrow — paiements et soldes, on-chain. L'escrow est un smart contract unique sur Base. Quand vous achetez des crédits, votre USDC y est versé et une entrée on-chain enregistre votre solde de crédits — le volume d'inférence que vous avez le droit de consommer. Les crédits sont un droit d'usage, pas un dépôt : ils ne peuvent pas être retirés, et l'USDC reçu devient des fonds du protocole qui rémunèrent les providers et font tourner le réseau. (Les autres modes de paiement — le compte prépayé et le paiement par wallet (x402), voir Moyens de paiement — fonctionnent autrement : les fonds restent sur un compte dont vous êtes propriétaire et sur lequel vous pouvez retirer ; l'escrow ne prélève que le coût exact de chaque requête.) Le contrat étant public, chacun peut vérifier à tout moment les soldes totaux et le règlement on-chain.

L'operator — le cerveau privé. L'operator authentifie votre clé API, choisit un provider disponible, transmet votre requête à Venice et vous relaie la réponse. Il s'exécute dans un TEE (Trusted Execution Environment) — un matériel scellé dont ni la machine hôte ni l'équipe Carpe Diem ne peuvent lire le contenu. C'est ce qui garantit la confidentialité de vos prompts et des clés Venice des providers.

Venice — l'inférence. Venice.ai exécute réellement les modèles. L'operator détient les clés Venice des providers et s'en sert pour servir votre requête ; vous ne voyez ni ne manipulez jamais vous-même de clé Venice.

Solde on-chain et solde de crédits en direct

Votre solde de crédits est suivi à deux endroits, et il est utile de savoir pourquoi :

On-chain (registre de l'escrow)Operator (registre en direct)
Répond à« ce qui est enregistré sur la blockchain »« ce que je peux dépenser maintenant »
Mis à jourà l'achat + à chaque règlement périodiqueà chaque requête
Se trouvesur Base (public, vérifiable)dans le TEE

Quand vous envoyez une requête, votre solde en direct est débité instantanément dans l'operator. L'entrée on-chain ne change que lorsque vous achetez des crédits, ou lorsque l'operator règle périodiquement un lot de consommation on-chain. Entre deux règlements, les deux peuvent différer : le chiffre on-chain reflète les achats, le chiffre en direct reflète les achats moins tout ce que vous avez déjà dépensé.

Pensez à une carte prépayée : acheter des crédits recharge la carte (enregistré on-chain) ; chaque requête est un paiement sans contact qui réduit instantanément le solde en direct. L'operator rapproche périodiquement ses comptes de la chaîne — c'est le règlement.

La vie d'une requête

Du moment où vous appelez l'API jusqu'au paiement des providers :

  1. Vous envoyez une requête avec votre clé API (cdm_…) à un endpoint standard comme /v1/chat/completions (ou /router/chat/completions, qui compare d'abord les marchés — voir Deux surfaces).
  2. L'operator authentifie la clé et la rattache à votre wallet.
  3. Il effectue une vérification préalable — avez-vous assez de crédits en direct, et un provider a-t-il assez de capacité Venice pour servir la requête ? Sinon, la requête est refusée proprement, avant toute inférence.
  4. Il choisit un provider selon son état de santé en temps réel, sa capacité disponible et le prix dynamique du moment.
  5. Il transmet la requête à Venice, qui exécute le modèle et renvoie la réponse à l'operator.
  6. Il calcule le prix et débite — l'operator calcule le coût (coût brut Venice × multiplicateur de prix du moment), débite instantanément votre solde de crédits en direct et enregistre la consommation.
  7. Il vous relaie la réponse, avec des en-têtes indiquant vos crédits restants.

Jusqu'ici, rien n'a touché la blockchain — tout est instantané, dans le TEE. Le paiement des providers se fait à part :

  1. Règlement. À mesure que la consommation s'accumule, l'operator règle périodiquement un lot on-chain en une seule transaction : il convertit l'USDC dû en DIEM, le distribue aux providers qui ont servi les requêtes et prélève la commission du protocole. C'est la seule écriture on-chain du flux normal — le regroupement en lots rend le coût en gas par requête négligeable.

Deux surfaces : /v1 et /router

Même clé, mêmes corps de requête, deux URL de base :

https://carpe-diem.xyz/api/operator/v1https://carpe-diem.xyz/api/operator/router
Servi parCarpe seul, via son TEE, avec VeniceLe marché le moins cher pour chaque requête : Carpe, Surplus, AntSeed, OpenRouter, Chutes, Venice ou Engy
ConfidentialitéToujours via le TEEPeut en sortir — envoyez "privacy": true pour rester sur des marchés TEE, "privacy": "private" pour rester sur des marchés qui ne conservent rien
PrixLe prix dynamique de CarpeLe prix du marché retenu, plus des frais de routage sur les marchés externes
Vous indiqueX-Carpe-Cost-Usdc-MicroX-Carpe-Route-Market, X-Carpe-Route-Cost-Usdc, X-Carpe-Route-Saved-Usdc

Obtenez gratuitement un devis sur chaque marché avant d'envoyer une requête : POST /router/quote. La section router de la référence de l'API détaille la correspondance des chemins, la liste des marchés et la façon d'en imposer un.

Moyens de paiement

Paiement à l'usage : ni abonnement, ni minimum. Tous les modes de paiement facturent le même prix par requête ; ils diffèrent par la façon dont l'argent est détenu.

DétentionRetirableClé cdm_ requiseIdéal pour
Compte prépayéUn compte dont vous êtes propriétaire (ERC-4337, contrôlé par votre wallet)OuiOuiLes utilisateurs de wallet qui veulent que leurs fonds restent les leurs
CréditsUn solde d'usage détenu par le protocoleNonOuiRecharger puis consommer ; le seul mode pour les comptes e-mail
Wallet (x402)Votre wallet, rien n'est préfinancé—NonLes agents autonomes sans compte

Compte prépayé. Déposez de l'USDC depuis API → Balance : le compte est créé et autorisé dans la même étape, sans gas. Carpe ne prélève que le coût exact de chaque requête, et vous pouvez retirer le reste vers votre wallet, ou révoquer l'autorisation, à tout moment.

Crédits. Déposez de l'USDC (ou convertissez un autre token dans la même transaction) pour obtenir un solde d'usage non remboursable : l'USDC devient des fonds du protocole qui rémunèrent les providers. 1 crédit = 0,01 $. Les crédits ne sont jamais convertis ni retirés.

Wallet (x402). Un agent disposant d'une clé privée et d'USDC sur Base paie chaque requête depuis son wallet, sans inscription ni clé : il reçoit un challenge 402, signe une fois (un permit plafonné à son budget) et renvoie la requête. Voir Paiement à la requête.

Quel mode paie. Votre compte a un mode de paiement — crédits, prépayé ou auto (les crédits d'abord, puis le compte prépayé) — réglé dans API → Balance ; une clé peut recevoir son propre mode à sa création. Si le mode choisi ne peut pas couvrir une requête, la réponse est 402 PAYMENT_REQUIRED, avant toute exécution. Les comptes e-mail paient en crédits.

Chaque réponse indique son coût et ce qu'il reste (X-Carpe-Available-Credits), pour qu'une application ou un agent puisse gérer son budget ; GET /v1/credits renvoie le solde à la demande.

Tarification dynamique

Le prix de Carpe Diem varie selon la part de la capacité d'inférence partagée du jour encore disponible — plus il reste de pool DIEM quotidien, moins vous payez. La garantie essentielle : votre prix total, commission du protocole comprise, ne dépasse jamais le tarif direct de Venice.

  • Un plancher et un plafond strict. Votre prix tout compris va d'un plancher d'environ 15 % du tarif Venice à un maximum de 100 % du tarif Venice — jamais plus.
  • La commission de 5 % est incluse dans ce plafond, pas ajoutée par-dessus. La part liée à la demande est plafonnée de sorte que, même au pic, demande + commission atteignent exactement le tarif Venice. La commission ne vous fait jamais dépasser ce tarif.
  • Piloté par l'utilisation du pool quotidien. Chaque jour, le DIEM staké des providers recharge un pool partagé. Tant qu'il est peu utilisé, les prix restent proches du plancher ; à mesure qu'il se consomme, ils montent vers le plafond.
  • La taille de votre requête compte aussi. Le prix est le plus élevé de deux facteurs : l'épuisement du pool quotidien, et la taille de votre requête rapportée à la capacité qui peut la servir. Une petite requête (un tour de chat, une image) reste proche du prix du pool ; une grosse (une vidéo qui consomme une large part de la capacité restante) paie une prime pour son empreinte — vous payez votre propre demande, pas seulement l'heure de la journée.
  • Réinitialisation quotidienne à 00:00 UTC.

Exemple. Supposons qu'une requête coûte 0,10 $ au tarif direct de Venice.

  • En début de journée, pool presque libre → vous payez environ 0,015 $ (~15 %).
  • En fin de journée, pool presque épuisé → la même requête monte vers 0,10 $ — le tarif Venice, commission comprise, et jamais au-delà.

Même requête, même modèle — le prix reflète simplement la capacité partagée restante.

Consultez l'état en direct sur la page Models, ou avec GET /v1/capacity et /pricing. Le router au meilleur prix peut trouver un prix encore plus bas sur un autre marché — voir Deux surfaces.

Authentification

Clés API (cdm_…) — pour appeler l'API. Envoyez Authorization: Bearer cdm_… à chaque requête. Les clés n'expirent pas ; vous pouvez en détenir plusieurs et révoquer n'importe laquelle instantanément depuis API → Keys — ou laisser une clé divulguée se révoquer elle-même avec POST /v1/keys/self/revoke. Les endpoints Anthropic (/v1/messages) acceptent aussi la clé en x-api-key.

Sessions — pour gérer votre compte. Se connecter sur le site, par signature de wallet ou par code e-mail, ouvre une session (un jeton valable 30 minutes, renouvelé tant que vous êtes actif, pour 8 heures au maximum). Créer ou révoquer des clés et modifier les réglages de paiement exigent une session : une clé API ne peut pas gérer les clés, si bien qu'une clé divulguée ne peut pas en créer d'autres.

x402 — sans aucun compte. Le permit USDC signé d'un agent est à la fois son paiement et son identité. Voir Moyens de paiement.

Modèles

Carpe sert tout le catalogue de Venice, synchronisé automatiquement — environ 400 modèles aujourd'hui :

Type (carpe_diem_type)UsageEndpoint
textChat, raisonnement, code, vision/v1/chat/completions, /v1/messages
embeddingEmbeddings vectoriels/v1/embeddings
image, imageEdit, upscaleGénérer, modifier, agrandir/v1/image/generate, /v1/image/edit, /v1/image/upscale
video, imageToVideo, referenceToVideoVidéo à partir de texte, d'image ou de référence (asynchrone)/v1/video/queue
tts, asr, musicSynthèse vocale, transcription, musique et sons (asynchrone)/v1/audio/speech, /v1/audio/transcriptions, /v1/audio/music/queue

GET /v1/models est la liste compatible OpenAI (elle fonctionne avec client.models.list()) ; chaque entrée comporte en plus :

  • privacy — private (Venice exécute le modèle sans conserver prompts ni réponses) ou anonymized (servi par un tiers, comme les modèles Claude et GPT, sans votre identité).
  • capabilities — vision, appel d'outils, raisonnement, JSON schema, recherche web, attestation TEE…
  • constraints — les paramètres acceptés par le modèle : durées et tailles pour la vidéo, voix pour la synthèse vocale, durées pour la musique. Lisez-les avant de construire un formulaire.
  • tier — standard, premium ou frontier : le tarif de base avant le prix dynamique.

GET /models renvoie le même catalogue regroupé par type, et GET /router/models ajoute, pour chaque modèle de texte, les marchés capables de le servir.

Confidentialité et sécurité

Aucun KYC. Un wallet ou une adresse e-mail : un compte, ce n'est rien de plus. Avec x402, pas même cela : le wallet est l'identité.

Exécution scellée. L'operator s'exécute dans un Trusted Execution Environment (Intel TDX sur Phala Cloud) : ni l'hébergeur ni l'équipe Carpe Diem ne peuvent y lire quoi que ce soit. Vos prompts et réponses, les clés Venice des providers et le registre en direct restent à l'intérieur. Sur /v1, chaque requête y passe ; sur /router, une requête peut être servie par un marché externe, sauf si vous envoyez "privacy": true (marchés TEE uniquement) ou "privacy": "private" (marchés qui ne conservent rien).

Modèles privés. Au-delà du TEE, choisissez un modèle listé privacy: "private" : Venice le sert sans rien conserver.

Vérifiable, pas « faites-nous confiance ». Le TEE produit une attestation matérielle du code exact qu'il exécute : GET /attestation, ou la page Privacy.

Argent transparent. Dépôts, règlements, commissions et soldes totaux sont sur Base, publics et auditables.

Privé (dans le TEE)Public (sur Base)
Vos prompts et réponsesDépôts et règlements
Les clés Venice des providersSoldes totaux et commissions
Registre de crédits en directCode et rôles du contrat

Limites et erreurs

  • Limites de débit. Par compte : 600 requêtes par minute aujourd'hui, davantage avec vos voies parallèles (une par tranche de 10 $ de crédit), plus un budget séparé pour les lectures gratuites comme votre solde. Consultez les vôtres avec GET /v1/rate_limits. Chaque modèle a aussi ses propres limites côté Venice : GET /v1/limits/:model et GET /v1/capacity.
  • Les erreurs sont en JSON avec un code stable ; les endpoints de chat utilisent le format d'erreur d'OpenAI, /v1/messages celui d'Anthropic. Celles à gérer : 402 PAYMENT_REQUIRED (rechargez), 429 (attendez Retry-After), 503 (pas de capacité pour l'instant — réessayez plus tard), 400 INVALID_TOOLS (une définition d'outil est mal formée). Le tableau complet, avec ce qu'il faut réessayer : Errors & retries.
  • Régions. Les pays sous sanctions sont refusés (451). Acheter de l'inférence depuis les États-Unis est autorisé ; être provider et staker ne le sont pas.
  • Ce qui n'existe pas. Carpe sert Chat Completions, pas la Responses API d'OpenAI (/v1/responses), et n'a pas de /v1/messages/count_tokens. Les outils qui exigent l'un ou l'autre sont listés dans Intégrations.

Devenir provider

Le principe

Il y a deux façons de devenir provider, qui ne diffèrent que par l'origine de la clé Venice.

Apporter votre propre clé. Si vous stakez du DIEM sur Venice, vous disposez d'une allocation d'inférence quotidienne que vous n'utilisez probablement pas entièrement. Vous la prêtez à la place de marché : Carpe Diem achemine des requêtes payantes vers votre clé Venice, et vous gagnez du DIEM sur chaque requête servie — votre capacité inutilisée devient un revenu. Voir Provisionner votre clé Venice.

Ou staker du DIEM ici et nous laisser en créer une. Si vous détenez du DIEM sans compte Venice, l'operator peut créer une clé pour vous dans son enclave, où elle reste scellée — vous ne la voyez jamais, et nous non plus. Voir Staker du DIEM à la place.

Dans les deux cas, la rémunération fonctionne de la même façon :

Vous gagnez 65 % de la valeur de chaque requête servie par votre clé, après une surtaxe du protocole (5 % du coût de base Venice, prélevés en premier ; le protocole conserve la surtaxe plus 35 % du reste). Rapportée à ce que l'acheteur a réellement payé, votre part représente environ 43 à 62 % selon le prix dynamique — le panneau Where every dollar goes de l'onglet Revenue affiche les chiffres réels de votre période. Les gains s'accumulent en DIEM, que vous pouvez retirer on-chain à tout moment.

Provisionner votre clé Venice

  1. Créez une clé API Venice inférence uniquement dans votre compte Venice, idéalement avec une limite de consommation et une date d'expiration. Une clé d'inférence suffit à Carpe Diem — aucune raison de provisionner une clé admin.
  2. Ouvrez la page Earn et connectez le wallet qui stake votre DIEM.
  3. Signez un message (gratuit, sans gas) pour prouver que le wallet vous appartient, puis soumettez votre clé Venice.
  4. Choisissez la persistance : persistée (chiffrée au repos, survit aux redémarrages) ou RAM uniquement (à reprovisionner après chaque redémarrage — secret maximal).

Votre clé Venice est chiffrée dans le TEE dès son arrivée — jamais visible par l'hébergeur ni par l'équipe Carpe Diem. Vous pouvez enregistrer jusqu'à 5 clés par wallet pour multiplier votre capacité.

Hygiène des clés. Le TEE protège votre clé pendant son utilisation — elle n'est jamais écrite sur disque, journalisée ni exposée, et ne peut pas être extraite de l'enclave (même une clé admin ne pourrait pas être lue). Restreindre la clé à l'inférence uniquement, avec une limite et une expiration est simplement une défense en profondeur qui reste entièrement sous votre contrôle, et vous pouvez la révoquer à tout moment — depuis Venice, ou depuis la page provider, ce qui la retire immédiatement du TEE.

Staker du DIEM à la place, et nous laisser créer la clé

Si vous n'avez pas de compte Venice, la porte stake de la page Earn fait toute la configuration à partir de votre seul DIEM. Vous signez vous-même chaque transaction ; aucune de vos clés n'est jamais partagée, puisque vous n'en avez pas — l'operator en crée une dans son enclave et l'y scelle.

  1. Justificatif. Venice ne crée une clé que pour un wallet détenant un peu de VVV staké. Si vous n'en avez pas, la page chiffre l'échange de quelques centimes de votre ETH, vous montre les montants, et n'envoie rien avant votre confirmation.
  2. Staker du DIEM. C'est le carburant : le DIEM staké est la capacité d'inférence avec laquelle votre clé sert les requêtes. Il reste staké à votre nom et vous pouvez le déstaker vous-même, sous réserve du délai de Venice, d'environ une journée.
  3. Création. Vous signez un challenge de Venice ; l'operator le relaie et scelle la clé obtenue dans son TEE.
  4. Choisir vos marchés. Le côté acheteur de Carpe est toujours actif. Carpe Reach est optionnel — votre clé sert alors davantage d'acheteurs, via notre partenaire Surplus Intelligence, qui détient une clé Venice dédiée tant que vous vendez : cochez-le lors de la création et acceptez ses conditions, affichées juste sous la case, et la vente démarre dès que votre clé est prête — une signature gratuite de plus. Votre reward splitter est créé lors de la création de la clé dans tous les cas, vous pouvez donc aussi activer la vente plus tard depuis l'onglet Markets.

La façon dont vous êtes payé dépend du marché, et c'est la partie à lire deux fois. Le trafic propre à Carpe paie en DIEM directement sur le solde escrow de votre wallet, sans commission — le protocole prend déjà sa marge sur la requête elle-même, prélever une part de plus ici reviendrait à vous facturer deux fois. Carpe Reach paie en USDC via un RewardSplitter déployé à votre nom : 90 % pour vous, 10 % pour la trésorerie, de façon immuable. Ce splitter est le seul canal qui comporte une commission. Il est déployé lors de la création de votre première clé, que vous cochiez Carpe Reach ou non — il doit être enregistré sur la clé à ce moment-là, et une clé créée sans splitter ne pourrait jamais rejoindre Carpe Reach plus tard. Recharger une clé existante n'en déploie jamais.

Tout fonctionne en pull. Les deux soldes s'accumulent on-chain jusqu'à ce que vous les réclamiez ; rien n'est jamais envoyé sur votre wallet sans que vous le demandiez.

Une clé créée de cette façon appartient à l'operator pour votre compte ; elle n'apparaît donc pas dans le tableau Keys du tableau de bord provider — ce tableau liste les clés que vous avez provisionnées vous-même (l'onglet compte vos clés stakées sur une ligne). Votre capacité se trouve dans l'onglet Stake, ses marchés dans l'onglet Markets, et les deux réclamations — le DIEM de l'escrow, l'USDC et le DIEM du splitter — dans l'onglet Revenue.

Gains et retraits

À mesure que votre clé sert des requêtes, vos gains en DIEM s'accumulent on-chain, crédités à chaque règlement. Retirez-les à tout moment avec withdrawDiem de l'escrow — ils vont directement sur votre wallet. Suivez vos gains en attente et cumulés via GET /provider/stats et la console Earn, où se fait la réclamation.

Suivi et contrôle

  • Journal par requête — GET /provider/usage renvoie chaque requête servie par votre clé, de la plus récente à la plus ancienne, avec horodatage, modèle et coût. C'est l'historique de référence de ce que Carpe Diem a fait passer par votre clé, et quand — y compris les requêtes très récentes pas encore réglées on-chain.
  • Statistiques et rendement — GET /provider/stats pour le nombre de requêtes et les gains ; GET /providers/:wallet/yield pour votre APR sur le DIEM vendu (aprOnSold7d) : l'ensemble des revenus — ventes Carpe, ventes Carpe Reach et la ristourne du router sur la capacité inutilisée — divisé par le DIEM que vous avez vendu sur Carpe et sur Carpe Reach au cours des 7 derniers jours, annualisé. sold7d indique combien de DIEM cela représente ; Carpe Reach est mesuré via le compte vendeur de Carpe Diem chez le partenaire. Dans l'API, Carpe Reach correspond au marché surplus et à ses champs.
  • Révocation à tout moment — retirez une clé ou tout votre enregistrement de provider avec DELETE /tee/providers/:address (ou clé par clé avec …/keys/:keyId). La clé cesse immédiatement de recevoir du trafic.

FAQ

Faut-il un compte ? Pour utiliser une clé API, oui — un wallet ou une adresse e-mail, sans KYC. Un agent qui paie en x402 n'a besoin d'aucun compte.

Comment payer ? En USDC sur Base : crédits, ou compte prépayé dont vous êtes propriétaire ; les agents peuvent payer chaque requête depuis un wallet. Le paiement par carte est en cours d'ouverture. Voir Moyens de paiement.

Est-ce moins cher qu'en direct ? Sur /v1, le prix dynamique démarre vers 15 % du tarif Venice et ne le dépasse jamais, commission comprise. Sur /router, vous obtenez le marché le moins cher pour chaque requête.

Quels modèles ? Tout le catalogue de Venice — texte (y compris les modèles Claude et GPT), code, image, vidéo, voix, musique, embeddings. GET /v1/models ou la page Models.

Puis-je l'utiliser avec Claude Code, Cursor, ChatGPT… ? Claude Code, OpenCode, Aider, Cline, Continue, Zed et VS Code peuvent tourner sur les modèles Carpe ; Claude Desktop, Claude Code, Cursor, Codex, VS Code et d'autres peuvent utiliser le serveur MCP. ChatGPT et claude.ai sur le web nécessitent un serveur MCP hébergé, qui est prévu. Détails : Intégrations.

Quelqu'un peut-il voir mes prompts ? Sur /v1, non : les requêtes sont traitées dans le TEE, et avec un modèle private le fournisseur ne conserve rien. Sur /router, un marché externe peut servir la requête, sauf si vous demandez privacy.

Et s'il n'y a pas assez de capacité ? Une vérification préalable refuse proprement la requête avant toute exécution ou facturation ; le router peut aussi se rabattre sur un autre marché.

Quel réseau ? Base (L2 Ethereum) : escrow, règlement et USDC.

Support

Mis à jour 2026-11-06