Création de clé API pour agent autonome

​

Prérequis

• Un portefeuille EVM sur Base contrôlé par l’agent (clé privée dans une variable d’environnement ou un gestionnaire de secrets).
• Une petite quantité d’ETH sur Base pour les frais de gas (le staking est constitué de deux transactions : approve puis stake).
• Une quantité non nulle de VVV à staker. L’endpoint de création requiert seulement que le portefeuille ait un solde sVVV non nul, donc 1 VVV suffit pour générer une clé. Voir Payer pour l’inférence pour ce dont vous avez réellement besoin pour appeler les endpoints payants.

​

Étapes

1

Acquérir du VVV

Envoyez du VVV au portefeuille de l’agent, ou faites en sorte que l’agent le swap sur un DEX comme Aerodrome ou Uniswap.Contrat du token VVV sur Base : 0xacfE6019Ed1A7Dc6f7B508C02d1b04ec88cC21bf

2

Staker du VVV avec Venice

Stakez le VVV dans le Smart Contract de Staking Venice à l’adresse 0x321b7ff75154472B18EDb199033fF4D116F340Ff. Il s’agit de deux transactions :

1. approve(spender, amount) sur le token VVV, où spender est le contrat de staking.
2. stake(amount) sur le contrat de staking.

Lorsque la deuxième transaction est confirmée, le solde VVV du portefeuille diminue et son solde sVVV augmente du même montant. L’endpoint de création lit le solde sVVV pour confirmer que le portefeuille est staké.

3

Demander un challenge pour le portefeuille

Appelez GET /api/v1/api_keys/generate_web3_key?address=<wallet address> pour obtenir un challenge EIP-4361 (Sign-In with Ethereum) à courte durée de vie. L’endpoint n’est pas authentifié, mais le challenge est lié à l’adresse transmise et ne peut être utilisé que par ce portefeuille.

curl --request GET \
  --url 'https://api.venice.ai/api/v1/api_keys/generate_web3_key?address=<wallet address>'

La réponse contient message, nonce et expiresAt :

{
  "data": {
    "message": "api.venice.ai wants you to sign in with your Ethereum account:\n0x...\n\nAuthorize Venice API key creation. Only sign this on venice.ai — anyone holding this signature can create an API key on your Venice account.\n\nURI: https://api.venice.ai/api/v1/api_keys/generate_web3_key\nVersion: 1\nChain ID: 8453\nNonce: 9f2c1d6b4a8e05337c1b9d2e6f4a7c81\nIssued At: 2026-06-30T11:02:41.167Z\nExpiration Time: 2026-06-30T11:17:41.167Z\nResources:\n- urn:venice:api-key:create",
    "nonce": "9f2c1d6b4a8e05337c1b9d2e6f4a7c81",
    "expiresAt": "2026-06-30T11:17:41.167Z"
  },
  "success": true
}

Le challenge expire 15 minutes après son émission et est à usage unique : il est consommé à la première clé créée avec lui. Demandez-en un nouveau pour chaque clé.

4

Signer le challenge avec le portefeuille de staking

Signez la chaîne message telle quelle avec le portefeuille qui détient le VVV staké. Il s’agit d’un personal_sign standard. À la fois ethers.Wallet.signMessage(message) et account.signMessage({ message }) de viem produisent la signature correcte.Ne reformatez pas, ne recoupez pas et ne régénérez pas le message. Venice vérifie la signature sur les octets exacts qu’il a émis et revérifie indépendamment le domain, l’URI, le Chain ID, la déclaration et l’adresse qu’il contient.

5

Créer la clé API

Faites un POST de l’adresse, de la signature et du message au même endpoint, avec le type de clé que vous souhaitez.

curl --request POST \
  --url https://api.venice.ai/api/v1/api_keys/generate_web3_key \
  --header 'Content-Type: application/json' \
  --data '{
    "address": "<wallet address>",
    "signature": "<signature of the challenge message>",
    "message": "<the unmodified challenge message>",
    "apiKeyType": "INFERENCE",
    "description": "Agent key minted on <date>"
  }'

Champs requis : address, signature, message, apiKeyType (INFERENCE ou ADMIN).Champs optionnels : description, expiresAt, consumptionLimit (plafonne la dépense totale sur cette clé, libellée en usd, vcu ou diem).En cas de succès, la réponse contient la chaîne apiKey créée. Stockez-la dans le secret store de l’agent et utilisez-la comme un token Bearer normal (Authorization: Bearer <key>).

​

Exemple de bout en bout

import { ethers } from "ethers"

const wallet = new ethers.Wallet(process.env.WALLET_PRIVATE_KEY!)
const address = wallet.address

const challengeResponse = await fetch(
  `https://api.venice.ai/api/v1/api_keys/generate_web3_key?address=${address}`,
)
const { data: { message } } = await challengeResponse.json()

const signature = await wallet.signMessage(message)

const mintResponse = await fetch("https://api.venice.ai/api/v1/api_keys/generate_web3_key", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    address,
    signature,
    message,
    apiKeyType: "INFERENCE",
    description: "Agent key",
  }),
})

const result = await mintResponse.json()
if (!mintResponse.ok) {
  throw new Error(`Mint failed: ${result.error}`)
}

console.log("Minted key:", result.data.apiKey)

​

Référence des erreurs

​

Pourquoi le challenge est lié au portefeuille et à usage unique

• Liaison à l’adresse. Le challenge nomme le portefeuille pour lequel il a été émis. Un challenge obtenu par une partie ne peut pas être signé ni utilisé par un autre portefeuille.
• Nonce à usage unique. Venice suit le nonce côté serveur et le consomme à la première création réussie. Une signature ne crée qu’une seule clé, une signature interceptée ne peut donc pas être rejouée pour en obtenir d’autres.
• Déclaration lisible. Le message indique clairement que signer autorise la création d’une clé API Venice, si bien qu’une interface de portefeuille comme MetaMask montre au signataire ce qu’il approuve au lieu d’un blob binaire.

​

Payer pour l’inférence

1. Staker plus de VVV pour que l’allocation quotidienne de DIEM couvre la dépense de l’agent. La clé créée le récupère automatiquement.
2. Utiliser le flux portefeuille x402 au lieu de la clé API. Avec x402, l’agent signe un message Sign-In-With-X par requête, recharge directement avec de l’USDC sur Base ou Solana via POST /api/v1/x402/top-up, et paie par requête. Le solde USDC x402 est lié au portefeuille, pas à l’utilisateur, donc il n’apparaît pas comme solde pour la clé Bearer créée, mais cela permet au même portefeuille de payer l’inférence de manière programmatique.

​

Ressources connexes