● Documentação

Carpe Diem — Documentação

Uma única API compatível com OpenAI e Anthropic para os modelos da Venice e não só — dentro de um TEE ou ao melhor preço entre mercados, pagamento por utilização, a partir do seu código, do seu agente de programação ou do seu assistente de IA.

O que é o Carpe Diem

O Carpe Diem é um mercado de inferência de IA na Base. Chama modelos de linguagem, imagem, áudio, vídeo e embeddings — o catálogo da Venice, incluindo modelos Claude, GPT, DeepSeek, Kimi, Qwen e GLM — através de uma única API compatível com OpenAI e Anthropic, e paga apenas o que utiliza, normalmente abaixo do preço de tabela da própria Venice.

Os pedidos são servidos de duas formas:

  • Dentro do TEE do Carpe (/v1): hardware selado que nem o anfitrião nem a equipa do Carpe Diem conseguem ler, à frente da Venice.ai, o fornecedor de IA centrado na privacidade.
  • Ao melhor preço (/router): cada pedido é cotado no Carpe e em vários outros mercados, e o mais barato serve-o — com uma opção para ficar em mercados TEE ou em mercados que não guardam nada.

Há três formas de entrar:

ParaComece aqui
A APIO seu código, o seu agente de programação (Claude Code, OpenCode, Aider…), a sua aplicação de chatInício rápido, depois Integrações
O servidor MCPO seu assistente de IA (Claude Desktop, Claude Code, Cursor, Codex, VS Code…), que recebe imagem, vídeo, voz, música, pesquisa web e todos os modelos como ferramentasIntegrações → Servidor MCP
A aplicação webExperimentar modelos, gerar imagens e vídeo, sem códigoCreate

E os detentores de DIEM podem ganhar vendendo a quota de inferência da Venice que não utilizam: ver Tornar-se fornecedor.

O nosso lugar no ecossistema Venice

O Carpe Diem não é um concorrente da Venice — é uma extensão dela. Fazer staking de DIEM na Venice dá direito a uma quota diária de inferência de cerca de 1 $ por DIEM; a maioria dos detentores nunca a esgota, e o que não for gasto até à reposição diária perde-se. O Carpe Diem transforma essa quota inativa num mercado: um detentor de DIEM disponibiliza uma chave e ganha com procura que de outro modo teria desperdiçado, um programador obtém os modelos da Venice a um preço mais baixo, definido pelo mercado, e uma maior parte da capacidade da rede é efetivamente utilizada.

Início rápido

Do zero a uma primeira resposta em poucos minutos. Tudo acontece no espaço API do site.

1. Iniciar sessão

Abra API → Start e inicie sessão com uma carteira EVM (MetaMask, Rabby, WalletConnect…) — uma assinatura gratuita, sem gas — ou com o seu endereço de e-mail. Sem KYC, em ambos os casos.

2. Adicionar fundos

Em API → Balance, com uma carteira na Base:

  • Créditos — deposite USDC (ou outro token, convertido em USDC na mesma transação) para obter um saldo que é consumido a cada pedido. 1 crédito = 0,01 $.
  • Conta pré-paga — deposite USDC numa conta criada para si e da qual é titular; o Carpe retira apenas o custo exato de cada pedido, e pode levantar o resto a qualquer momento.

O pagamento por cartão, para contas sem carteira, está a ser aberto. As diferenças entre os meios de pagamento estão em Formas de pagamento.

3. Criar uma chave de API

Em API → Keys, crie uma chave. Tem o formato cdm_… e é mostrada apenas uma vez: copie-a para um local seguro. Crie uma chave por aplicação ou agente, para que os gastos de cada um fiquem visíveis separadamente, e revogue qualquer uma delas a qualquer momento.

4. A sua primeira chamada

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

Qualquer id de modelo de /v1/models funciona em model; a página Models mostra-os com os preços em tempo real.

5. A seguir

  • Ligue o Carpe às suas ferramentas — Claude Code, OpenCode, Cursor, o SDK da OpenAI ou da Anthropic, LangChain, Open WebUI…: Integrações.
  • Dê ao seu assistente de IA ferramentas de imagem, vídeo, voz e web: Servidor MCP.
  • Receitas completas com código e custos — imagens, vídeo, voz, RAG, pesquisa web, extração: Casos de utilização.
  • Todos os endpoints: Referência da API.

Como funciona

A visão geral

Um pedido faz uma ida e volta através do operator, um proxy privado que corre num TEE à frente dos fornecedores 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

Em /v1, o operator encaminha o seu pedido para a Venice com a chave de um fornecedor, retransmite a resposta e debita o seu saldo. Em /router, começa por cotar o pedido em todos os mercados — o próprio Carpe e mercados externos — e envia-o para o mais barato que o consiga servir (ver Duas superfícies). Em qualquer dos casos, só detém a sua chave cdm_.

Os componentes

O escrow — pagamentos e saldos, on-chain. O escrow é um único smart contract na Base. Quando compra créditos, os seus USDC são pagos ao contrato e um registo on-chain guarda o seu saldo de créditos — a quantidade de inferência que tem direito a gastar. Os créditos são um direito de utilização, não um depósito: não há levantamento, e os USDC recebidos tornam-se fundos do protocolo que pagam os fornecedores e fazem funcionar a rede. (Os outros meios — a conta pré-paga e os pagamentos por carteira (x402), ver Formas de pagamento — funcionam de outra forma: aí os fundos ficam numa conta da qual o utilizador é titular e da qual pode levantar; o escrow retira apenas o custo exato de cada pedido.) Como o contrato é público, qualquer pessoa pode verificar a qualquer momento os saldos totais e a liquidação on-chain.

O operator — o cérebro privado. O operator autentica a sua chave de API, escolhe um fornecedor disponível, encaminha o seu pedido para a Venice e devolve-lhe a resposta. Corre dentro de um TEE (Trusted Execution Environment) — hardware selado onde nem a máquina anfitriã nem a equipa do Carpe Diem conseguem ler o que está lá dentro. É isto que mantém confidenciais os seus prompts e as chaves Venice dos fornecedores.

Venice — a inferência. A Venice.ai executa efetivamente os modelos. O operator detém as chaves Venice dos fornecedores e usa-as para servir o seu pedido; nunca vê nem manipula uma chave Venice.

Saldo on-chain vs. saldo de créditos em tempo real

O seu saldo de créditos é acompanhado em dois sítios, e vale a pena perceber porquê:

On-chain (registo do escrow)Operator (registo em tempo real)
Responde a"o que está registado na blockchain""o que posso gastar agora"
Atualiza-sena compra + na liquidação periódicaa cada pedido
Onde estána Base (público, verificável)dentro do TEE

Quando faz um pedido, o seu saldo em tempo real é debitado instantaneamente dentro do operator. O registo on-chain só muda quando compra mais créditos, ou quando o operator liquida periodicamente um lote de utilização on-chain. Entre liquidações, os dois podem diferir: o valor on-chain reflete as compras, enquanto o valor em tempo real reflete as compras menos tudo o que já gastou.

Pense num cartão pré-pago: comprar créditos carrega o cartão (registado on-chain); cada pedido é um pagamento por aproximação que reduz instantaneamente o saldo em tempo real. O operator reconcilia periodicamente as suas contas com a cadeia — é a liquidação.

A vida de um pedido

Desde o momento em que chama a API até ao momento em que os fornecedores são pagos:

  1. Envia um pedido com a sua chave de API (cdm_…) para um endpoint padrão como /v1/chat/completions (ou /router/chat/completions, que compara primeiro os mercados — ver Duas superfícies).
  2. O operator autentica a chave e associa-a à sua carteira.
  3. Faz uma verificação prévia — tem créditos suficientes em tempo real, e há um fornecedor com capacidade Venice suficiente para servir este pedido? Se não, o pedido é recusado de forma limpa, antes de qualquer inferência.
  4. Escolhe um fornecedor com base no estado em tempo real, na capacidade disponível e no preço dinâmico atual.
  5. Encaminha o pedido para a Venice, que executa o modelo e devolve a resposta ao operator.
  6. Calcula o preço e debita — o operator calcula o custo (custo bruto da Venice × o multiplicador de preço atual), debita instantaneamente o seu saldo de créditos em tempo real e regista a utilização.
  7. Devolve-lhe a resposta, incluindo cabeçalhos que indicam os créditos restantes.

Até aqui, nada tocou na blockchain — tudo é instantâneo, dentro do TEE. O pagamento aos fornecedores acontece à parte:

  1. Liquidação. À medida que a utilização se acumula, o operator liquida periodicamente um lote on-chain numa única transação: converte os USDC devidos em DIEM, distribui-os pelos fornecedores que serviram os pedidos e retém a comissão do protocolo. É a única escrita on-chain no fluxo normal — agrupá-la em lotes mantém o custo de gas por pedido negligenciável.

Duas superfícies: /v1 e /router

A mesma chave, os mesmos corpos de pedido, dois URLs base:

https://carpe-diem.xyz/api/operator/v1https://carpe-diem.xyz/api/operator/router
Servido porApenas o Carpe, através do seu TEE, com a VeniceO mercado mais barato para cada pedido: Carpe, Surplus, AntSeed, OpenRouter, Chutes, Venice ou Engy
ConfidencialidadeSempre através do TEEPode sair dele — envie "privacy": true para ficar em mercados TEE, "privacy": "private" para ficar em mercados que não guardam nada
PreçoO preço dinâmico do CarpeO preço do mercado vencedor, mais uma comissão de encaminhamento nos mercados externos
Indica-lheX-Carpe-Cost-Usdc-MicroX-Carpe-Route-Market, X-Carpe-Route-Cost-Usdc, X-Carpe-Route-Saved-Usdc

Cote um pedido em todos os mercados antes de o enviar, gratuitamente: POST /router/quote. A secção do router na referência da API tem o mapeamento de caminhos, a lista de mercados e como fixar um deles.

Formas de pagamento

Pagamento por utilização: sem subscrição, sem mínimo. Todos os meios pagam o mesmo preço por pedido; diferem na forma como o dinheiro é detido.

CustódiaLevantávelRequer uma chave cdm_Ideal para
Conta pré-pagaUma conta da qual é titular (ERC-4337, controlada pela sua carteira)SimSimUtilizadores de carteira que querem que os fundos continuem a ser seus
CréditosUm saldo de utilização detido pelo protocoloNãoSimCarregar e ir consumindo; o único meio para contas de e-mail
Carteira (x402)A sua carteira, nada pré-financiado—NãoAgentes autónomos sem conta

Conta pré-paga. Deposite USDC a partir de API → Balance: a conta é criada e autorizada no mesmo passo, sem gas. O Carpe retira apenas o custo exato de cada pedido, e pode levantar o resto para a sua carteira, ou revogar, a qualquer momento.

Créditos. Deposite USDC (ou converta outro token na mesma transação) para obter um saldo de utilização não reembolsável: os USDC tornam-se fundos do protocolo que pagam os fornecedores. 1 crédito = 0,01 $. Os créditos nunca são convertidos nem levantados.

Carteira (x402). Um agente com uma chave privada e USDC na Base paga cada pedido a partir da sua carteira, sem registo e sem chave: recebe um desafio 402, assina uma vez (um permit limitado ao seu orçamento) e reenvia. Ver Pagar por pedido.

Que meio paga. A sua conta tem um modo de pagamento — créditos, pré-pago ou automático (primeiro os créditos, depois a conta pré-paga) — definido em API → Balance; uma chave pode receber um modo próprio quando a cria. Se o meio não conseguir cobrir um pedido, a resposta é 402 PAYMENT_REQUIRED, antes de qualquer execução. As contas de e-mail pagam com créditos.

Cada resposta indica quanto custou e quanto resta (X-Carpe-Available-Credits), para que uma aplicação ou um agente possa gerir o próprio orçamento; GET /v1/credits devolve o saldo a pedido.

Preço dinâmico

O preço do Carpe Diem varia consoante a parte da capacidade de inferência partilhada do dia que ainda está disponível — quanto mais sobrar do pool diário de DIEM, menos paga. A garantia essencial: o seu preço total, comissão do protocolo incluída, nunca excede a tarifa direta da Venice.

  • Um mínimo e um teto rígido. O seu preço final vai de um mínimo de cerca de 15% da tarifa da Venice até um máximo de 100% da tarifa da Venice — nunca mais.
  • A comissão de 5% está dentro desse teto, não acima dele. A parte que depende da procura é limitada para que, mesmo no pico, procura + comissão fiquem exatamente na tarifa da Venice. A comissão nunca o faz ultrapassá-la.
  • Determinado pela utilização diária do pool. Todos os dias, o DIEM em staking dos fornecedores renova um pool partilhado. Quando pouco foi utilizado, os preços ficam perto do mínimo; à medida que é consumido, sobem em direção ao teto.
  • O tamanho do seu pedido também conta. O preço é o maior de dois valores: o grau de esgotamento do pool diário, e o tamanho do seu pedido face à capacidade que o pode servir. Um pedido pequeno (uma mensagem de chat, uma imagem) fica perto do preço do pool; um grande (um vídeo que consome uma parte importante da capacidade restante) paga um prémio pela sua pegada — paga pela sua própria procura, não apenas pela hora do dia.
  • Reposição diária às 00:00 UTC.

Exemplo. Suponha que um pedido custa 0,10 $ à tarifa direta da Venice.

  • No início do dia, com o pool quase livre → paga cerca de 0,015 $ (~15%).
  • No fim do dia, com o pool quase esgotado → o mesmo pedido sobe em direção a 0,10 $ — a tarifa da Venice, comissão incluída, e nunca acima.

O mesmo pedido, o mesmo modelo — o preço apenas reflete quanta capacidade partilhada resta.

Veja o estado em tempo real na página Models, ou com GET /v1/capacity e /pricing. O router de melhor preço pode encontrar um preço ainda mais baixo noutro mercado — ver Duas superfícies.

Autenticação

Chaves de API (cdm_…) — para chamar a API. Envie Authorization: Bearer cdm_… em cada pedido. As chaves não expiram; pode ter várias e revogar qualquer uma instantaneamente em API → Keys — ou deixar uma chave comprometida revogar-se a si própria com POST /v1/keys/self/revoke. Os endpoints Anthropic (/v1/messages) também aceitam a chave como x-api-key.

Sessões — para gerir a sua conta. Iniciar sessão no site, com uma assinatura de carteira ou um código por e-mail, abre uma sessão (um token válido durante 30 minutos, renovado enquanto estiver ativo, até um máximo de 8 horas). Criar ou revogar chaves e alterar as definições de pagamento requer uma sessão: uma chave de API não pode gerir chaves, pelo que uma chave comprometida não pode criar outras.

x402 — sem qualquer conta. O permit USDC assinado de um agente é ao mesmo tempo o seu pagamento e a sua identidade. Ver Formas de pagamento.

Modelos

O Carpe serve todo o catálogo da Venice, sincronizado automaticamente — cerca de 400 modelos atualmente:

Tipo (carpe_diem_type)O que fazEndpoint
textChat, raciocínio, código, visão/v1/chat/completions, /v1/messages
embeddingEmbeddings vetoriais/v1/embeddings
image, imageEdit, upscaleGerar, editar, aumentar a resolução/v1/image/generate, /v1/image/edit, /v1/image/upscale
video, imageToVideo, referenceToVideoVídeo a partir de texto, imagem ou referência (assíncrono)/v1/video/queue
tts, asr, musicVoz, transcrição, música e som (assíncrono)/v1/audio/speech, /v1/audio/transcriptions, /v1/audio/music/queue

GET /v1/models é a lista compatível com OpenAI (funciona com client.models.list()); cada entrada inclui também:

  • privacy — private (a Venice executa o modelo sem guardar prompts nem respostas) ou anonymized (servido através de um terceiro, como os modelos Claude e GPT, sem a sua identidade).
  • capabilities — visão, chamada de ferramentas, raciocínio, JSON schema, pesquisa web, atestação TEE…
  • constraints — os parâmetros que o modelo aceita: durações e tamanhos para vídeo, vozes para fala, durações para música. Leia-os antes de construir um formulário.
  • tier — standard, premium ou frontier: a tarifa base antes do preço dinâmico.

GET /models devolve o mesmo catálogo agrupado por tipo, e GET /router/models acrescenta, para cada modelo de texto, os mercados que o podem servir.

Privacidade e segurança

Sem KYC. Uma carteira ou um endereço de e-mail é tudo o que uma conta é. Com x402, nem isso: a carteira é a identidade.

Execução selada. O operator corre num Trusted Execution Environment (Intel TDX na Phala Cloud): o anfitrião e a equipa do Carpe Diem não conseguem ver o seu interior. Os seus prompts e respostas, as chaves Venice dos fornecedores e o registo em tempo real ficam lá dentro. Em /v1, todos os pedidos passam por ele; em /router, um pedido pode ser servido por um mercado externo, a menos que envie "privacy": true (apenas mercados TEE) ou "privacy": "private" (mercados que não guardam nada).

Modelos privados. Para além do TEE, escolha um modelo listado como privacy: "private": a Venice serve-o sem reter nada.

Verificável, não "confie em nós". O TEE produz uma atestação de hardware do código exato que executa: GET /attestation, ou a página Privacy.

Dinheiro transparente. Depósitos, liquidações, comissões e saldos totais estão na Base, públicos e auditáveis.

Privado (dentro do TEE)Público (na Base)
Os seus prompts e respostasDepósitos e liquidações
As chaves Venice dos fornecedoresSaldos totais e comissões
Registo de créditos em tempo realCódigo e papéis do contrato

Limites e erros

  • Limites de taxa. Por conta: 600 pedidos por minuto atualmente, aumentando com as suas vias paralelas (uma por cada 10 $ de crédito), mais um orçamento separado para leituras gratuitas, como o seu saldo. Consulte os seus com GET /v1/rate_limits. Cada modelo tem também os limites próprios da Venice: GET /v1/limits/:model e GET /v1/capacity.
  • Os erros são JSON com um code estável; os endpoints de chat usam o formato de erro da OpenAI, /v1/messages o da Anthropic. Os que deve tratar: 402 PAYMENT_REQUIRED (carregue saldo), 429 (aguarde Retry-After), 503 (sem capacidade neste momento — tente mais tarde), 400 INVALID_TOOLS (uma definição de ferramenta está mal formada). A tabela completa, com o que repetir: Errors & retries.
  • Regiões. Os países sob sanções são recusados (451). Comprar inferência a partir dos Estados Unidos é permitido; fornecer e fazer staking não.
  • O que não existe. O Carpe serve Chat Completions, não a Responses API da OpenAI (/v1/responses), e não tem /v1/messages/count_tokens. As ferramentas que precisam de uma delas estão listadas em Integrações.

Tornar-se fornecedor

A ideia

Há duas formas de se tornar fornecedor, e diferem apenas na origem da chave Venice.

Traga a sua própria chave. Se faz staking de DIEM na Venice, tem uma quota diária de inferência que provavelmente não utiliza na totalidade. Empresta essa quota ao mercado: o Carpe Diem encaminha pedidos pagos para a sua chave Venice, e ganha DIEM em cada pedido que serve — transformando capacidade inativa em receita. Ver Disponibilizar a sua chave Venice.

Ou faça staking de DIEM aqui e deixe-nos criar uma. Se tem DIEM mas não tem conta Venice, o operator pode criar uma chave para si dentro do seu enclave, onde fica selada — nem o utilizador a vê, nem nós. Ver Fazer staking de DIEM.

Em ambos os casos, o dinheiro funciona da mesma forma:

Recebe 65% do valor de cada pedido servido pela sua chave, após uma sobretaxa do protocolo (5% do custo base da Venice, retirados primeiro; o protocolo fica com a sobretaxa mais 35% do resto). Face ao que o comprador efetivamente pagou, a sua parte fica em cerca de 43–62% consoante o preço dinâmico — o painel Where every dollar goes do separador Revenue mostra os valores reais do seu período. Os ganhos acumulam-se em DIEM, que pode levantar on-chain a qualquer momento.

Disponibilizar a sua chave Venice

  1. Crie uma chave de API Venice só de inferência na sua conta Venice, idealmente com um limite de consumo e uma data de expiração. Uma chave de inferência é tudo o que o Carpe Diem precisa — não há razão para disponibilizar uma chave de administração.
  2. Abra a página Earn e ligue a carteira com que faz staking do seu DIEM.
  3. Assine uma mensagem (gratuita, sem gas) para provar que é titular da carteira, e submeta a sua chave Venice.
  4. Escolha a persistência: persistida (cifrada em repouso, sobrevive a reinícios) ou só em RAM (voltar a disponibilizar após cada reinício — sigilo máximo).

A sua chave Venice é cifrada dentro do TEE no momento em que chega — nunca visível para o anfitrião nem para a equipa do Carpe Diem. Pode registar até 5 chaves por carteira para multiplicar a sua capacidade.

Higiene das chaves. O TEE protege a sua chave em utilização — nunca é escrita em disco, registada em logs ou exposta, e não pode ser extraída do enclave (nem uma chave de administração poderia ser lida). Restringir a chave a só inferência, com limite e expiração é simplesmente uma defesa em profundidade que fica inteiramente sob o seu controlo, e pode revogá-la a qualquer momento — na Venice, ou na página de fornecedor, o que a remove imediatamente do TEE.

Fazer staking de DIEM e deixar-nos criar a chave

Se não tem conta Venice, a porta stake da página Earn faz toda a configuração apenas a partir de DIEM. Assina cada transação pessoalmente; nenhuma chave sua é alguma vez partilhada, porque não existe nenhuma chave sua — o operator cria uma dentro do seu enclave e sela-a lá.

  1. Credencial. A Venice só cria uma chave para uma carteira que tenha algum VVV em staking. Se não tiver nenhum, a página cota uma troca de alguns cêntimos a partir do seu ETH, mostra-lhe os valores e não envia nada até confirmar.
  2. Staking de DIEM. É o combustível: o DIEM em staking é a capacidade de inferência com que a sua chave serve. Fica em staking em seu nome e pode retirá-lo do staking pessoalmente, sujeito ao período de espera da Venice de cerca de um dia.
  3. Criação. Assina um desafio da Venice; o operator retransmite-o e sela a chave resultante no seu TEE.
  4. Escolha os seus mercados. O lado comprador do próprio Carpe está sempre ativo. O Carpe Reach é opcional — a sua chave serve também mais compradores, através do nosso parceiro Surplus Intelligence, que detém uma chave Venice dedicada enquanto vende: assinale-o quando criar a chave e aceite os termos, mostrados logo abaixo da caixa, e a venda começa assim que a sua chave estiver pronta — mais uma assinatura gratuita. O seu splitter de recompensas é criado no momento da criação da chave em qualquer caso, pelo que também pode ativar a venda mais tarde no separador Markets.

A forma como é pago difere consoante o mercado, e esta é a parte que vale a pena ler duas vezes. O tráfego do próprio Carpe paga em DIEM diretamente para o saldo de escrow da sua carteira, sem comissão — o protocolo já retira a sua margem no próprio pedido, por isso cobrar outra parte aqui seria cobrar-lhe duas vezes. O Carpe Reach paga em USDC através de um RewardSplitter implementado em seu nome: 90% para si, 10% para a tesouraria, imutável. Esse splitter é o único meio que tem comissão. É implementado quando a sua primeira chave é criada, quer assinale o Carpe Reach quer não — tem de ficar registado na chave nesse momento, e uma chave criada sem ele nunca poderia aderir ao Carpe Reach mais tarde. Reforçar uma chave existente nunca implementa um.

Tudo funciona por levantamento (pull). Ambos os saldos se acumulam on-chain até os reclamar; nada é alguma vez enviado para a sua carteira sem o pedir.

Uma chave criada desta forma é detida pelo operator em seu nome, pelo que não aparece na tabela Keys do painel de fornecedor — essa tabela lista as chaves que disponibilizou pessoalmente (o separador conta as suas chaves em staking numa linha). A sua capacidade está no separador Stake, os seus mercados no separador Markets, e ambas as reclamações — o DIEM do escrow e os USDC e DIEM do splitter — no separador Revenue.

Ganhos e levantamentos

À medida que a sua chave serve pedidos, os seus ganhos em DIEM acumulam-se on-chain, creditados a cada liquidação. Levante-os a qualquer momento com o withdrawDiem do escrow — vão diretamente para a sua carteira. Acompanhe os ganhos pendentes e acumulados através de GET /provider/stats e da consola Earn, onde está a reclamação.

Monitorização e controlo

  • Registo por pedido — GET /provider/usage devolve todos os pedidos servidos pela sua chave, do mais recente para o mais antigo, cada um com data e hora, modelo e custo. É o registo definitivo de exatamente o que o Carpe Diem encaminhou pela sua chave e quando — incluindo pedidos muito recentes ainda não liquidados on-chain.
  • Estatísticas e rendimento — GET /provider/stats para o número de pedidos e os ganhos; GET /providers/:wallet/yield para a sua APR sobre o DIEM vendido (aprOnSold7d): todas as receitas — vendas no Carpe, vendas no Carpe Reach e o reembolso do router pela capacidade inativa — divididas pelo DIEM que vendeu no Carpe e no Carpe Reach nos últimos 7 dias, anualizadas. sold7d indica quantos DIEM foram; o Carpe Reach é medido através da conta de vendedor do Carpe Diem junto do parceiro. Na API, o Carpe Reach é o mercado surplus e os seus campos.
  • Revogar a qualquer momento — remova uma chave ou todo o seu registo de fornecedor com DELETE /tee/providers/:address (ou por chave com …/keys/:keyId). A chave deixa imediatamente de receber tráfego.

Perguntas frequentes

Preciso de uma conta? Para usar uma chave de API, sim — uma carteira ou um endereço de e-mail, sem KYC. Um agente que paga com x402 não precisa de conta nenhuma.

Como pago? Em USDC na Base: créditos, ou uma conta pré-paga da qual é titular; os agentes podem pagar por pedido a partir de uma carteira. O pagamento por cartão está a ser aberto. Ver Formas de pagamento.

É mais barato do que ir diretamente? Em /v1, o preço dinâmico começa em cerca de 15% da tarifa da Venice e nunca a excede, comissão incluída. Em /router, obtém o mercado mais barato para cada pedido.

Que modelos? Todo o catálogo da Venice — texto (incluindo modelos Claude e GPT), código, imagem, vídeo, voz, música, embeddings. GET /v1/models ou a página Models.

Posso usá-lo com Claude Code, Cursor, ChatGPT…? Claude Code, OpenCode, Aider, Cline, Continue, Zed e VS Code podem funcionar com modelos do Carpe; Claude Desktop, Claude Code, Cursor, Codex, VS Code e outros podem usar o servidor MCP. O ChatGPT e o claude.ai na web precisam de um servidor MCP alojado, que está planeado. Detalhes: Integrações.

Alguém pode ver os meus prompts? Em /v1, não: os pedidos são processados dentro do TEE e, com um modelo private, o fornecedor não guarda nada. Em /router, um mercado externo pode servir o pedido, a menos que peça privacy.

E se não houver capacidade suficiente? Uma verificação prévia recusa de forma limpa antes de qualquer execução ou cobrança; o router pode também recorrer a outro mercado.

Que rede? Base (L2 da Ethereum): escrow, liquidação e USDC.

Suporte

Atualizado 2026-11-06