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 token de validation

Appelez GET /api/v1/api_keys/generate_web3_key pour obtenir un token à courte durée de vie signé par Venice. L’endpoint n’est pas authentifié.

curl --request GET \
  --url https://api.venice.ai/api/v1/api_keys/generate_web3_key

La réponse contient un champ token. Le token expire 15 minutes après son émission, signez-le donc et soumettez-le bien avant.

4

Signer le token avec le portefeuille de staking

Signez la chaîne brute du token avec le portefeuille qui détient le VVV staké. Il s’agit d’un personal_sign standard sur les octets du token. À la fois ethers.Wallet.signMessage(token) et account.signMessage({ message: token }) de viem produisent la signature correcte.

5

Créer la clé API

Faites un POST de l’adresse, de la signature et du token 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": "<signed token>",
    "token": "<unsigned token>",
    "apiKeyType": "INFERENCE",
    "description": "Agent key minted on <date>"
  }'

Champs requis : address, signature, token, 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 tokenResponse = await fetch("https://api.venice.ai/api/v1/api_keys/generate_web3_key")
const { data: { token } } = await tokenResponse.json()

const signature = await wallet.signMessage(token)

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,
    token,
    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

​

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