● Documentación

Carpe Diem — Documentación

Una sola API compatible con OpenAI y Anthropic para los modelos de Venice y más — dentro de un TEE o al mejor precio entre mercados, pago por uso, desde tu código, tu agente de programación o tu asistente de IA.

Qué es Carpe Diem

Carpe Diem es un mercado de inferencia de IA en Base. Llamas a modelos de lenguaje, imagen, audio, video y embeddings — el catálogo de Venice, incluidos los modelos Claude, GPT, DeepSeek, Kimi, Qwen y GLM — a través de una sola API compatible con OpenAI y Anthropic, y pagas solo por lo que usas, normalmente por debajo del precio de lista de la propia Venice.

Las solicitudes se atienden de dos maneras:

  • Dentro del TEE de Carpe (/v1): hardware sellado que ni el host ni el equipo de Carpe Diem pueden leer, delante de Venice.ai, el proveedor de IA centrado en la privacidad.
  • Al mejor precio (/router): cada solicitud se cotiza en Carpe y en varios otros mercados, y la atiende el más barato — con una opción para quedarte en mercados TEE o en mercados que no guardan nada.

Hay tres formas de entrar:

ParaEmpieza aquí
La APITu código, tu agente de programación (Claude Code, OpenCode, Aider…), tu app de chatInicio rápido, luego Integraciones
El servidor MCPTu asistente de IA (Claude Desktop, Claude Code, Cursor, Codex, VS Code…), que obtiene imagen, video, voz, música, búsqueda web y todos los modelos como herramientasIntegraciones → Servidor MCP
La app webProbar modelos, generar imágenes y video, sin códigoCreate

Y quienes tienen DIEM pueden ganar vendiendo la asignación de inferencia de Venice que no usan: consulta Convertirse en proveedor.

Nuestro lugar en el ecosistema Venice

Carpe Diem no compite con Venice: la amplía. Hacer staking de DIEM en Venice otorga una asignación diaria de inferencia de aproximadamente $1 por DIEM; la mayoría de los titulares nunca la usa por completo, y lo que no se gasta antes del reinicio diario se pierde. Carpe Diem convierte esa asignación ociosa en un mercado: un titular de DIEM aporta una clave y gana con una demanda que de otro modo habría desperdiciado, un desarrollador obtiene los modelos de Venice a un precio más bajo y fijado por el mercado, y se aprovecha realmente más capacidad de la red.

Inicio rápido

De cero a una primera respuesta en unos minutos. Todo ocurre en el espacio API del sitio.

1. Inicia sesión

Abre API → Start e inicia sesión con una wallet EVM (MetaMask, Rabby, WalletConnect…) — una firma gratuita, sin gas — o con tu dirección de email. Sin KYC en ningún caso.

2. Añade fondos

En API → Balance, con una wallet en Base:

  • Créditos — deposita USDC (u otro token, convertido a USDC en la misma transacción) para obtener un saldo que se consume con cada solicitud. 1 crédito = $0.01.
  • Cuenta prepagada — deposita USDC en una cuenta creada para ti y de la que eres titular; Carpe retira solo el costo exacto de cada solicitud, y puedes retirar el resto cuando quieras.

El pago con tarjeta, para cuentas sin wallet, se está habilitando. Las diferencias entre los métodos están en Formas de pago.

3. Crea una clave de API

En API → Keys, crea una clave. Tiene la forma cdm_… y se muestra una sola vez: cópiala en un lugar seguro. Crea una clave por app o agente, para ver el gasto de cada uno por separado, y revoca cualquiera de ellas en cualquier momento.

4. Tu primera llamada

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

Cualquier id de modelo de /v1/models funciona en model; la página Models los muestra con precios en vivo.

5. Siguientes pasos

  • Conecta Carpe a tus herramientas — Claude Code, OpenCode, Cursor, el SDK de OpenAI o de Anthropic, LangChain, Open WebUI…: Integraciones.
  • Dale a tu asistente de IA herramientas de imagen, video, voz y web: Servidor MCP.
  • Recetas completas con código y costos — imágenes, video, voz, RAG, investigación web, extracción: Casos de uso.
  • Todos los endpoints: Referencia de la API.

Cómo funciona

La visión general

Una solicitud hace un viaje de ida y vuelta a través del operator, un proxy privado que se ejecuta en un TEE delante de los proveedores de modelos:

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

En /v1, el operator reenvía tu solicitud a Venice con la clave de un proveedor, devuelve la respuesta y descuenta tu saldo. En /router, primero cotiza la solicitud en todos los mercados — el propio Carpe y otros externos — y la envía al más barato que pueda atenderla (consulta Dos superficies). En ambos casos, tú solo manejas tu clave cdm_.

Las piezas

El escrow — pagos y saldos, on-chain. El escrow es un único smart contract en Base. Cuando compras créditos, tus USDC se pagan en él y un registro on-chain anota tu saldo de créditos — la cantidad de inferencia que tienes derecho a consumir. Los créditos son un derecho de uso, no un depósito: no se pueden retirar, y los USDC entrantes pasan a ser fondos del protocolo que pagan a los proveedores y mantienen la red. (Los otros métodos — la cuenta prepagada y los pagos desde wallet (x402), consulta Formas de pago — funcionan de otra manera: ahí los fondos permanecen en una cuenta de la que tú eres titular y desde la que puedes retirar; el escrow solo retira el costo exacto de cada solicitud). Como el contrato es público, cualquiera puede verificar en todo momento los saldos totales y la liquidación on-chain.

El operator — el cerebro privado. El operator autentica tu clave de API, elige un proveedor disponible, reenvía tu solicitud a Venice y te devuelve la respuesta. Se ejecuta dentro de un TEE (Trusted Execution Environment) — hardware sellado en el que ni la máquina host ni el equipo de Carpe Diem pueden leer lo que hay dentro. Esto es lo que mantiene confidenciales tus prompts y las claves de Venice de los proveedores.

Venice — la inferencia. Venice.ai ejecuta realmente los modelos. El operator guarda las claves de Venice de los proveedores y las usa para atender tu solicitud; tú nunca ves ni manejas una clave de Venice.

Saldo on-chain frente a saldo de créditos en vivo

Tu saldo de créditos se registra en dos lugares, y conviene saber por qué:

On-chain (registro del escrow)Operator (registro en vivo)
Responde a"qué está registrado en la blockchain""qué puedo gastar ahora mismo"
Se actualizaal comprar + en cada liquidación periódicaen cada solicitud
Viveen Base (público, verificable)dentro del TEE

Cuando haces una solicitud, tu saldo en vivo se descuenta al instante dentro del operator. El registro on-chain solo cambia cuando compras más créditos o cuando el operator liquida periódicamente un lote de uso on-chain. Entre liquidaciones, ambos pueden diferir: la cifra on-chain refleja las compras, mientras que la cifra en vivo refleja las compras menos todo lo que ya has gastado.

Piénsalo como una tarjeta prepagada: comprar créditos recarga la tarjeta (registrado on-chain); cada solicitud es un pago que descuenta el saldo en vivo al instante. El operator concilia periódicamente sus cuentas con la cadena — eso es la liquidación.

La vida de una solicitud

Desde que llamas a la API hasta que se paga a los proveedores:

  1. Envías una solicitud con tu clave de API (cdm_…) a un endpoint estándar como /v1/chat/completions (o /router/chat/completions, que primero compara mercados — consulta Dos superficies).
  2. El operator autentica la clave y la asocia a tu wallet.
  3. Hace una verificación previa — ¿tienes suficientes créditos en vivo, y tiene algún proveedor suficiente capacidad de Venice para atender esto? Si no, la solicitud se rechaza limpiamente, antes de que ocurra cualquier inferencia.
  4. Elige un proveedor según su estado en tiempo real, la capacidad disponible y el precio dinámico actual.
  5. Reenvía la solicitud a Venice, que ejecuta el modelo y devuelve la respuesta al operator.
  6. Calcula el precio y descuenta — el operator calcula el costo (costo bruto de Venice × el multiplicador de precio actual), descuenta al instante tu saldo de créditos en vivo y registra el uso.
  7. Te devuelve la respuesta, con encabezados que indican tus créditos restantes.

Hasta aquí nada ha tocado la blockchain — todo es instantáneo, dentro del TEE. El pago a los proveedores ocurre por separado:

  1. Liquidación. A medida que se acumula el uso, el operator liquida periódicamente un lote on-chain en una sola transacción: convierte los USDC adeudados en DIEM, los distribuye a los proveedores que atendieron las solicitudes y cobra la comisión del protocolo. Es la única escritura on-chain del flujo normal — agruparla en lotes mantiene el costo de gas por solicitud insignificante.

Dos superficies: /v1 y /router

La misma clave, los mismos cuerpos de solicitud, dos URL base:

https://carpe-diem.xyz/api/operator/v1https://carpe-diem.xyz/api/operator/router
Lo atiendeSolo Carpe, a través de su TEE, con VeniceEl mercado más barato para cada solicitud: Carpe, Surplus, AntSeed, OpenRouter, Chutes, Venice o Engy
ConfidencialidadSiempre a través del TEEPuede salir de él — envía "privacy": true para quedarte en mercados TEE, "privacy": "private" para quedarte en mercados que no guardan nada
PrecioEl precio dinámico de CarpeEl precio del mercado ganador, más una comisión de enrutamiento en los mercados externos
Te indicaX-Carpe-Cost-Usdc-MicroX-Carpe-Route-Market, X-Carpe-Route-Cost-Usdc, X-Carpe-Route-Saved-Usdc

Cotiza gratis una solicitud en todos los mercados antes de enviarla: POST /router/quote. La sección del router en la referencia de la API incluye la correspondencia de rutas, la lista de mercados y cómo fijar uno.

Formas de pago

Pago por uso: sin suscripción, sin mínimo. Todos los métodos pagan el mismo precio por solicitud; difieren en cómo se custodia el dinero.

CustodiaRetirableRequiere una clave cdm_Ideal para
Cuenta prepagadaUna cuenta de la que eres titular (ERC-4337, controlada por tu wallet)SíSíUsuarios con wallet que quieren que sus fondos sigan siendo suyos
CréditosUn saldo de uso custodiado por el protocoloNoSíRecargar e ir consumiendo; el único método para cuentas de email
Wallet (x402)Tu wallet, nada prefinanciado—NoAgentes autónomos sin cuenta

Cuenta prepagada. Deposita USDC desde API → Balance: la cuenta se crea y se autoriza en el mismo paso, sin gas. Carpe solo retira el costo exacto de cada solicitud, y puedes retirar el resto a tu wallet, o revocar la autorización, en cualquier momento.

Créditos. Deposita USDC (o convierte otro token en la misma transacción) para obtener un saldo de uso no reembolsable: los USDC pasan a ser fondos del protocolo que pagan a los proveedores. 1 crédito = $0.01. Los créditos nunca se convierten ni se retiran.

Wallet (x402). Un agente con una clave privada y USDC en Base paga cada solicitud desde su wallet, sin registro y sin clave: recibe un desafío 402, firma una vez (un permit limitado a su presupuesto) y reenvía. Consulta Pago por solicitud.

Qué método paga. Tu cuenta tiene un modo de pago — créditos, prepagado o auto (primero créditos, luego la cuenta prepagada) — que se configura en API → Balance; al crear una clave puedes asignarle un modo propio. Si el método no puede cubrir una solicitud, la respuesta es 402 PAYMENT_REQUIRED, antes de ejecutar nada. Las cuentas de email pagan con créditos.

Cada respuesta indica cuánto costó y cuánto queda (X-Carpe-Available-Credits), para que una app o un agente pueda gestionar su propio presupuesto; GET /v1/credits devuelve el saldo cuando lo necesites.

Precio dinámico

El precio de Carpe Diem varía según cuánta capacidad de inferencia compartida del día queda disponible — cuanto más queda del pool diario de DIEM, menos pagas. La garantía clave: tu precio total, comisión del protocolo incluida, nunca supera la tarifa directa de Venice.

  • Un mínimo y un tope estricto. Tu precio final va desde un mínimo de aproximadamente el 15 % de la tarifa de Venice hasta un máximo del 100 % de la tarifa de Venice — nunca más.
  • La comisión del 5 % está dentro de ese tope, no por encima. La parte que depende de la demanda está limitada de modo que, incluso en el pico, demanda + comisión quedan exactamente en la tarifa de Venice. La comisión nunca te lleva por encima.
  • Determinado por el uso diario del pool. Cada día, el DIEM en staking de los proveedores recarga un pool compartido. Cuando se ha usado poco, los precios se mantienen cerca del mínimo; a medida que se consume, suben hacia el tope.
  • El tamaño de tu solicitud también cuenta. El precio es el mayor de dos factores: cuánto se ha agotado el pool diario, y lo grande que es tu solicitud en relación con la capacidad que puede atenderla. Una solicitud pequeña (un turno de chat, una imagen) se mantiene cerca del precio del pool; una grande (un video que consume una parte importante de la capacidad restante) paga un recargo por su huella — pagas por tu propia demanda, no solo por la hora del día.
  • Se reinicia a diario a las 00:00 UTC.

Ejemplo. Supongamos que una solicitud cuesta $0.10 a la tarifa directa de Venice.

  • Al principio del día, con el pool casi libre → pagas unos $0.015 (~15 %).
  • Al final del día, con el pool casi agotado → la misma solicitud sube hacia $0.10 — la tarifa de Venice, comisión incluida, y nunca más.

Misma solicitud, mismo modelo — el precio solo refleja cuánta capacidad compartida queda.

Consulta el estado en vivo en la página Models, o con GET /v1/capacity y /pricing. El router de mejor precio puede encontrar un precio aún más bajo en otro mercado — consulta Dos superficies.

Autenticación

Claves de API (cdm_…) — para llamar a la API. Envía Authorization: Bearer cdm_… en cada solicitud. Las claves no caducan; puedes tener varias y revocar cualquiera al instante desde API → Keys — o dejar que una clave filtrada se revoque a sí misma con POST /v1/keys/self/revoke. Los endpoints de Anthropic (/v1/messages) también aceptan la clave como x-api-key.

Sesiones — para gestionar tu cuenta. Iniciar sesión en el sitio, con una firma de wallet o un código por email, abre una sesión (un token válido 30 minutos, renovado mientras estés activo, durante un máximo de 8 horas). Crear o revocar claves y cambiar la configuración de pago requieren una sesión: una clave de API no puede gestionar claves, así que una clave filtrada no puede generar otras.

x402 — sin cuenta alguna. El permit de USDC firmado por un agente es a la vez su pago y su identidad. Consulta Formas de pago.

Modelos

Carpe sirve todo el catálogo de Venice, sincronizado automáticamente — unos 400 modelos hoy:

Tipo (carpe_diem_type)Qué haceEndpoint
textChat, razonamiento, código, visión/v1/chat/completions, /v1/messages
embeddingEmbeddings vectoriales/v1/embeddings
image, imageEdit, upscaleGenerar, editar, escalar/v1/image/generate, /v1/image/edit, /v1/image/upscale
video, imageToVideo, referenceToVideoVideo a partir de texto, imagen o referencia (asíncrono)/v1/video/queue
tts, asr, musicVoz, transcripción, música y sonido (asíncrono)/v1/audio/speech, /v1/audio/transcriptions, /v1/audio/music/queue

GET /v1/models es la lista compatible con OpenAI (funciona con client.models.list()); cada entrada incluye además:

  • privacy — private (Venice ejecuta el modelo sin guardar prompts ni respuestas) o anonymized (servido a través de un tercero, como los modelos Claude y GPT, sin tu identidad).
  • capabilities — visión, llamada a herramientas, razonamiento, JSON schema, búsqueda web, atestación TEE…
  • constraints — los parámetros que acepta el modelo: duraciones y tamaños para video, voces para síntesis de voz, duraciones para música. Léelos antes de construir un formulario.
  • tier — standard, premium o frontier: la tarifa base antes del precio dinámico.

GET /models devuelve el mismo catálogo agrupado por tipo, y GET /router/models añade, para cada modelo de texto, los mercados que pueden servirlo.

Privacidad y seguridad

Sin KYC. Una wallet o una dirección de email es todo lo que es una cuenta. Con x402, ni siquiera eso: la wallet es la identidad.

Ejecución sellada. El operator se ejecuta en un Trusted Execution Environment (Intel TDX en Phala Cloud): ni el host ni el equipo de Carpe Diem pueden ver su interior. Tus prompts y respuestas, las claves de Venice de los proveedores y el registro en vivo permanecen dentro. En /v1 cada solicitud pasa por él; en /router, una solicitud puede ser atendida por un mercado externo, salvo que envíes "privacy": true (solo mercados TEE) o "privacy": "private" (mercados que no guardan nada).

Modelos privados. Además del TEE, elige un modelo listado como privacy: "private": Venice lo sirve sin retener nada.

Verificable, no "confía en nosotros". El TEE produce una atestación por hardware del código exacto que ejecuta: GET /attestation, o la página Privacy.

Dinero transparente. Depósitos, liquidaciones, comisiones y saldos totales están en Base, públicos y auditables.

Privado (dentro del TEE)Público (en Base)
Tus prompts y respuestasDepósitos y liquidaciones
Claves de Venice de los proveedoresSaldos totales y comisiones
Registro de créditos en vivoCódigo del contrato y roles

Límites y errores

  • Límites de tasa. Por cuenta: 600 solicitudes por minuto hoy, que aumentan con tus carriles paralelos (uno por cada $10 de crédito), más un presupuesto aparte para lecturas gratuitas como tu saldo. Consulta los tuyos con GET /v1/rate_limits. Cada modelo tiene además los límites propios de Venice: GET /v1/limits/:model y GET /v1/capacity.
  • Los errores son JSON con un code estable; los endpoints de chat usan el formato de error de OpenAI, /v1/messages el de Anthropic. Los que debes gestionar: 402 PAYMENT_REQUIRED (recarga), 429 (espera Retry-After), 503 (sin capacidad en este momento — reintenta más tarde), 400 INVALID_TOOLS (una definición de herramienta está mal formada). La tabla completa, con qué reintentar: Errors & retries.
  • Regiones. Se rechazan los países sancionados (451). Comprar inferencia desde Estados Unidos está permitido; ser proveedor y hacer staking, no.
  • Lo que no hay. Carpe sirve Chat Completions, no la Responses API de OpenAI (/v1/responses), y no tiene /v1/messages/count_tokens. Las herramientas que necesitan alguno de los dos se enumeran en Integraciones.

Convertirse en proveedor

La idea

Hay dos formas de convertirse en proveedor, y solo difieren en el origen de la clave de Venice.

Trae tu propia clave. Si haces staking de DIEM en Venice, tienes una asignación diaria de inferencia que probablemente no usas por completo. Prestas esa asignación al mercado: Carpe Diem enruta solicitudes pagadas a tu clave de Venice, y ganas DIEM por cada solicitud que atiendes — convirtiendo capacidad ociosa en ingresos. Consulta Aportar tu clave de Venice.

O haz staking de DIEM aquí y deja que generemos una. Si tienes DIEM pero no tienes cuenta en Venice, el operator puede generar una clave para ti dentro de su enclave, donde permanece sellada — tú nunca la ves, y nosotros tampoco. Consulta Hacer staking de DIEM en su lugar.

En ambos casos, el dinero funciona igual:

Ganas el 65 % del valor de cada solicitud que atiende tu clave, después de un recargo del protocolo (el 5 % del costo base de Venice, que se descuenta primero; el protocolo se queda con el recargo más el 35 % del resto). Medido sobre lo que el comprador pagó realmente, tu parte equivale aproximadamente a entre el 43 y el 62 % según el precio dinámico — el panel Where every dollar goes de la pestaña Revenue muestra las cifras reales de tu periodo. Las ganancias se acumulan en DIEM, y puedes retirarlas on-chain cuando quieras.

Aportar tu clave de Venice

  1. Crea en tu cuenta de Venice una clave de API de solo inferencia, idealmente con un límite de consumo y una fecha de caducidad. Una clave de inferencia es todo lo que Carpe Diem necesita — no hay ninguna razón para aportar una clave de administrador.
  2. Abre la página Earn y conecta la wallet con la que haces staking de tu DIEM.
  3. Firma un mensaje (gratis, sin gas) para demostrar que eres el titular de la wallet, y envía tu clave de Venice.
  4. Elige la persistencia: persistida (cifrada en reposo, sobrevive a los reinicios) o solo en RAM (vuelve a aportarla tras cada reinicio — máximo secreto).

Tu clave de Venice se cifra dentro del TEE en cuanto llega — nunca es visible para el host ni para el equipo de Carpe Diem. Puedes registrar hasta 5 claves por wallet para multiplicar tu capacidad.

Higiene de claves. El TEE protege tu clave mientras se usa — nunca se escribe en disco, se registra en logs ni se expone, y no se puede extraer del enclave (ni siquiera una clave de administrador podría leerse). Limitar la clave a solo inferencia, con un límite y una caducidad es simplemente defensa en profundidad que queda totalmente bajo tu control, y puedes revocarla en cualquier momento — desde Venice, o desde la página de proveedor, que la elimina del TEE de inmediato.

Hacer staking de DIEM en su lugar y dejar que generemos la clave

Si no tienes cuenta en Venice, la puerta stake de la página Earn hace toda la configuración solo a partir de DIEM. Firmas tú mismo cada transacción; nunca se comparte ninguna clave tuya, porque no hay ninguna clave tuya — el operator genera una dentro de su enclave y la sella allí.

  1. Credencial. Venice solo genera una clave para una wallet que tenga algo de VVV en staking. Si no tienes, la página cotiza un swap de unos pocos céntimos desde tu ETH, te muestra las cifras y no envía nada hasta que confirmes.
  2. Haz staking de DIEM. Es el combustible: el DIEM en staking es la capacidad de inferencia con la que sirve tu clave. Permanece en staking a tu nombre y puedes retirarlo tú mismo, sujeto al periodo de espera de Venice de aproximadamente un día.
  3. Generación. Firmas un desafío de Venice; el operator lo transmite y sella la clave resultante en su TEE.
  4. Elige tus mercados. La demanda propia de Carpe está siempre activa. Carpe Reach es opcional — tu clave también sirve a más compradores, a través de nuestro socio Surplus Intelligence, que mantiene una clave de Venice dedicada mientras vendes: márcalo al generar la clave y acepta sus condiciones, que aparecen justo debajo de la casilla, y la venta empieza en cuanto tu clave está lista — una firma gratuita más. Tu reward splitter se crea al generar la clave en cualquier caso, así que también puedes activar la venta más tarde desde la pestaña Markets.

La forma de cobrar difiere según el mercado, y esta es la parte que vale la pena leer dos veces. El tráfico propio de Carpe paga en DIEM directamente al saldo del escrow de tu wallet, sin comisión — el protocolo ya cobra su margen sobre la propia solicitud, así que cobrar otra parte aquí sería cobrarte dos veces. Carpe Reach paga en USDC a través de un RewardSplitter desplegado a tu nombre: 90 % para ti, 10 % para la tesorería, inmutable. Ese splitter es el único método que conlleva una comisión. Se despliega cuando se genera tu primera clave, marques Carpe Reach o no — tiene que quedar registrado en la clave en ese momento, y una clave generada sin él nunca podría unirse a Carpe Reach más tarde. Recargar una clave existente nunca despliega uno.

Todo funciona por retiro (pull). Ambos saldos se acumulan on-chain hasta que los reclamas; nunca se envía nada a tu wallet sin que lo pidas.

Una clave generada de esta forma es propiedad del operator en tu nombre, así que no aparece en la tabla Keys del panel de proveedor — esa tabla lista las claves que aportaste tú mismo (la pestaña cuenta tus claves en staking en una sola línea). Tu capacidad está en la pestaña Stake, sus mercados en la pestaña Markets, y ambos cobros — el DIEM del escrow y los USDC y DIEM del splitter — en la pestaña Revenue.

Ganar y retirar

A medida que tu clave atiende solicitudes, tus ganancias en DIEM se acumulan on-chain y se abonan en cada liquidación. Retíralas cuando quieras con withdrawDiem del escrow — van directamente a tu wallet. Sigue tus ganancias pendientes y acumuladas con GET /provider/stats y en la consola Earn, donde está el cobro.

Supervisión y control

  • Registro por solicitud — GET /provider/usage devuelve cada solicitud que atendió tu clave, de la más reciente a la más antigua, cada una con fecha y hora, modelo y costo. Es el registro definitivo de exactamente qué enrutó Carpe Diem a través de tu clave y cuándo — incluidas solicitudes muy recientes aún no liquidadas on-chain.
  • Estadísticas y rendimiento — GET /provider/stats para el número de solicitudes y las ganancias; GET /providers/:wallet/yield para tu APR sobre el DIEM vendido (aprOnSold7d): todos los ingresos — ventas en Carpe, ventas en Carpe Reach y el reembolso del router por capacidad ociosa — divididos por el DIEM que vendiste en Carpe y en Carpe Reach en los últimos 7 días, anualizado. sold7d indica cuántos DIEM fueron; Carpe Reach se mide a través de la cuenta de vendedor de Carpe Diem con el socio. En la API, Carpe Reach es el mercado surplus y sus campos.
  • Revoca cuando quieras — elimina una clave o todo tu registro como proveedor con DELETE /tee/providers/:address (o por clave con …/keys/:keyId). La clave deja de recibir tráfico de inmediato.

Preguntas frecuentes

¿Necesito una cuenta? Para usar una clave de API, sí — una wallet o una dirección de email, sin KYC. Un agente que paga con x402 no necesita ninguna cuenta.

¿Cómo pago? En USDC en Base: créditos, o una cuenta prepagada de la que eres titular; los agentes pueden pagar por solicitud desde una wallet. El pago con tarjeta se está habilitando. Consulta Formas de pago.

¿Es más barato que ir directamente? En /v1, el precio dinámico empieza en torno al 15 % de la tarifa de Venice y nunca la supera, comisión incluida. En /router, obtienes el mercado más barato para cada solicitud.

¿Qué modelos? Todo el catálogo de Venice — texto (incluidos los modelos Claude y GPT), código, imagen, video, voz, música, embeddings. GET /v1/models o la página Models.

¿Puedo usarlo con Claude Code, Cursor, ChatGPT…? Claude Code, OpenCode, Aider, Cline, Continue, Zed y VS Code pueden funcionar con modelos de Carpe; Claude Desktop, Claude Code, Cursor, Codex, VS Code y otros pueden usar el servidor MCP. ChatGPT y claude.ai en la web necesitan un servidor MCP alojado, que está previsto. Detalles: Integraciones.

¿Alguien puede ver mis prompts? En /v1, no: las solicitudes se procesan dentro del TEE, y con un modelo private el proveedor no guarda nada. En /router, un mercado externo puede atender la solicitud salvo que pidas privacy.

¿Y si no hay suficiente capacidad? Una verificación previa rechaza limpiamente la solicitud antes de ejecutar o cobrar nada; el router también puede recurrir a otro mercado.

¿Qué red? Base (L2 de Ethereum): escrow, liquidación y USDC.

Soporte

Actualizado 2026-11-06