Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only.

x402

API x402 pour modèles d'IA : payez à la requête en USDC

RunAPI accepte les paiements x402 sur ses endpoints facturés à l'appel. Un agent envoie une requête normale, reçoit un devis 402, le signe avec son wallet et obtient le résultat. Pas de compte, pas de clé API, pas de crédits prépayés.

Parcourir les modèles Qu'est-ce que HTTP 402 ? Lire la documentation

Base · USDC · Coinbase CDP · x402 v2

402

curl -i -X POST "https://runapi.ai/api/v1/z_image/text_to_image" \  -H 'Content-Type: application/json' \  --data @request.json # HTTP/2 402# PAYMENT-REQUIRED: <base64 JSON with accepts: scheme, network, asset, amount, payTo>

155 ressources payables avec x402
Base réseau de règlement
USDC actif de paiement
0 clés API requises

Comment ça marche

Quatre étapes, de la requête au résultat

Envoyez la requête sans clé

Envoyez en POST le même corps JSON que celui utilisé avec une clé API, mais sans l'en-tête Authorization.
Lisez le devis 402

RunAPI répond 402 avec un en-tête PAYMENT-REQUIRED qui indique le montant exact, l'actif, le réseau et le destinataire. Le devis est valable 300 secondes.
Signez et réessayez

Votre client x402 v2 signe une autorisation EIP-3009 avec le wallet de l'agent et renvoie la requête avec un en-tête PAYMENT-SIGNATURE.
Interrogez la tâche

RunAPI règle le paiement, démarre la tâche et renvoie 200 avec un reçu PAYMENT-RESPONSE et une URL de suivi pour le résultat.

Détails

Ce qu'il faut savoir avant de payer

Sans inscription ni clé API

Le wallet qui paie est la seule identité. Aucun compte à créer, aucune clé à stocker, aucun solde à recharger.

Paiements USDC sans gas

Le payeur signe une autorisation EIP-3009 et le facilitateur Coinbase CDP soumet le transfert : le wallet a besoin d'USDC, pas d'ETH.

Récupérer le résultat

La plupart des tâches médias se terminent de façon asynchrone. La réponse 200 inclut une URL de suivi avec un jeton d'accès à la tâche en lecture seule. Ce jeton n'ouvre que cette tâche et rien d'autre, et reste valable 30 jours après la fin de la tâche.

Si une tâche échoue

x402 ne prévoit aucun remboursement intégré. Quand une tâche payée se termine en échec, RunAPI enregistre une obligation de remboursement pour le montant total reçu. Un opérateur renvoie ensuite ce montant au wallet payeur par un virement USDC distinct ; le remboursement n'est pas automatique.

Quels endpoints sont éligibles

x402 fonctionne sur les endpoints REST avec un prix fixe à l'appel. Les modèles facturés au token, à la seconde ou au caractère, y compris les endpoints LLM, nécessitent toujours une clé API et des crédits. Le serveur MCP n'accepte pas les paiements x402.

Les clés API fonctionnent toujours

x402 est un moyen de paiement supplémentaire. Les requêtes envoyées avec une clé API valide continuent d'utiliser les crédits du compte comme avant, et une requête avec une clé invalide reçoit un 401 au lieu d'un devis de paiement.

x402 v2

À quoi ressemble l'échange

Transmettez la réponse à n'importe quel client x402 v2 connecté au wallet de l'agent. Le client se charge de la signature et de la nouvelle tentative :

x402 client

request  = {method: "POST", url: task_url, json: payload}response = x402_client.send(request, wallet: agent_wallet)# The x402 v2 client reads PAYMENT-REQUIRED, signs an EIP-3009# authorization, and replays the request with PAYMENT-SIGNATURE.response.status                       # => 200response.headers["PAYMENT-RESPONSE"]  # settlement receiptresponse.json["poll_url"]             # read-only task result URL

Exemples de prix

Le prix minimal à l'appel pour quelques modèles qui acceptent x402 aujourd'hui. Les prix proviennent du catalogue en direct, et chaque devis 402 indique le montant exact de la requête.

Exemples de prix
Modèle	Endpoint	Prix par appel
Z Image Text to image z-image	POST /api/v1/z_image/text_to_image	$0.01
Flux Text to image flux-2-klein	POST /api/v1/flux/text_to_image	$0.03
Suno Stitch audio suno-v4	POST /api/v1/suno/stitch_audio	$0.01
Suno Stitch audio suno-v4.5	POST /api/v1/suno/stitch_audio	$0.01
Recraft Upscale image recraft-crisp-upscale	POST /api/v1/recraft/upscale_image	$0.01
Recraft Remove background recraft-remove-background	POST /api/v1/recraft/remove_background	$0.01

Détails du paiement

RunAPI suit le schéma exact de x402 v2 et n'accepte que les valeurs ci-dessous. Tout le reste est rejeté avant que RunAPI ne demande au facilitateur de régler le paiement.

Détails du paiement
Réseau	Base mainnet (eip155:8453)
Actif	USDC, contrat 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, 6 décimales
Facilitateur	Coinbase CDP
Autorisation	EIP-3009, donc le payeur a besoin d'USDC mais pas d'ETH pour le gas
Limite	jusqu'à 10 USDC par requête ; les devis expirent après 300 secondes

FAQ x402

Qu'est-ce que x402 ?

x402 est un protocole de paiement ouvert construit sur le code de statut HTTP 402 Payment Required. Un serveur répond 402 avec les conditions de paiement, le client paie avec une autorisation de stablecoin signée, et la requête est rejouée. Il est maintenu par la x402 Foundation.

Ai-je besoin d'un compte RunAPI pour payer avec x402 ?

Non. Le wallet qui paie fait office d'identité. RunAPI ne crée un profil de wallet interne qu'après le premier règlement réussi, et ne demande jamais d'e-mail ni de clé API.

Que fait le facilitateur x402 ?

Le facilitateur vérifie le paiement signé et soumet le virement USDC sur Base. RunAPI utilise le facilitateur Coinbase CDP, donc le payeur n'a pas besoin de payer de gas.

Combien coûte une requête ?

Chaque endpoint a un prix fixe à l'appel. Le devis 402 indique le montant exact en USDC avant que vous ne signiez, et le catalogue de modèles liste les prix actuels.

Les agents peuvent-ils découvrir RunAPI via le x402 Bazaar ?

Chaque devis 402 inclut une déclaration de découverte Bazaar avec le schéma d'entrée et un exemple, afin que les clients et annuaires x402 puissent référencer l'endpoint.

Que se passe-t-il si je paie et que la requête échoue avant le démarrage d'une tâche ?

Une requête qui échoue à la validation est rejetée avant que le paiement ne soit réglé, donc rien n'est débité. Une fois le paiement réglé, une tâche qui échoue ensuite ouvre droit à un remboursement intégral.