Développeurs · API v1

Une API.
Tous les modèles.

Images, vidéo, audio et 3D derrière une seule API, avec le même solde que le studio. Créez une clé dans Réglages et installez la CLI avec npm.

Obtenir une clé APIDémarrage rapide
Installer la CLI
$ npm i -g pufy-io
Modèles
721
Endpoints
9
Recharge minimale
3 €
Exemples

Le même appel, n'importe quel résultat

Changez l'ID du modèle pour passer de l'image à la vidéo ou à la voix. Les champs suivent le modèle.

1# 1. Generate an image2curl -X POST https://pufy.io/api/v1/api/catalog/generations \3  -H "Authorization: Bearer $PUFY_API_KEY" \4  -H 'Content-Type: application/json' \5  -H "Idempotency-Key: $(uuidgen)" \6  -d '{7  "modelId": "luma/uni-v1/text-to-image",8  "inputs": {9    "prompt": "Neon city street after rain, cinematic night",10    "size": "16:9"11  }12}'13 14# 2. Poll with the generation id from step 1 until its status is succeeded15curl https://pufy.io/api/v1/api/catalog/generations/$ID \16  -H "Authorization: Bearer $PUFY_API_KEY"17 18# 3. Download the file19curl https://pufy.io/api/v1/api/catalog/generations/$ID/content \20  -H "Authorization: Bearer $PUFY_API_KEY" \21  -o result.jpeg
Exemple de renduluma/uni-v1/text-to-image
Démarrage rapide

Premier rendu en trois étapes

  1. 1Créez une clé APIDans Réglages > Clés API, nommez une clé et copiez-la une fois. Rechargez dès 3 € dans Facturation.export PUFY_API_KEY="YOUR_API_KEY"
  2. 2Installez la CLIL'outil en ligne de commande pufy s'installe avec npm, pnpm ou bun.npm i -g pufy-io
  3. 3Lancez votre premier renduChoisissez un ID de modèle dans le catalogue et envoyez un prompt. Ajoutez --dry-run pour voir le prix sans rien dépenser.pufy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
CLI

Rendez depuis le terminal

Lancez n'importe quel modèle depuis un shell, un job CI ou un agent de code. Chaque rendu est chiffré avant de démarrer et débité du même solde.

Scripts et CIChaque champ d'un modèle est une option ; un fichier local est envoyé pour vous.
JSON sur stdoutUn document JSON par exécution, progression et erreurs sur stderr, un code de sortie non nul en cas d'échec.
Agents de codeUn fichier de skill apprend à votre agent à vérifier d'abord le prix et à le plafonner.
Guide complet de la CLI →
CommandeCe qu'elle fait
pufy loginCollez votre clé API une fois ; elle est vérifiée et enregistrée
pufy whoamiLe nom de la clé et votre solde
pufy models --type videoTous les modèles vidéo avec leur prix de départ
pufy run <model> -hLes champs d'un modèle, en direct : type, valeur par défaut, valeurs autorisées
pufy run <model> -p "<prompt>" -o ./out/Rendre et enregistrer le résultat dans un dossier
pufy run <model> -p "..." --dry-runLe prix exact, sans rien dépenser
pufy run <model> -p "..." --max-price 0.50Refuser de lancer si le prix est plus élevé
pufy run <model> -p "..." --json -o ./out/Un résultat JSON, prêt pour l'étape suivante
pufy skill installApprendre à votre agent de code à utiliser la CLI
L'essentiel de l'API

Prête pour la production

Authentification

Un jeton Bearer dans l'en-tête Authorization. Créez les clés dans Réglages.

Authorization: Bearer YOUR_API_KEY

Rendus en arrière-plan

Lancer un rendu répond aussitôt avec le statut queued. Interrogez le rendu jusqu'à ce qu'il réussisse, échoue ou soit remboursé.

{ "status": "queued" }

Le prix d'abord

Demandez le prix exact de vos paramètres sans rien lancer. Tous les montants sont en centimes d'euro.

POST /api/v1/api/catalog/quote

Relances sans risque

Envoyez un en-tête Idempotency-Key et une requête relancée n'est jamais facturée deux fois.

Idempotency-Key: render-042

Limites

Chaque clé a une limite par minute et un plafond quotidien facultatif. Au-delà, l'API répond 429.

429 Too Many Requests

Erreurs et remboursements

Des erreurs JSON avec un code et un message. Un rendu qui échoue est remboursé automatiquement sur votre solde.

{ "status": "refunded" }
Référence

Endpoints

URL de base https://pufy.io/api/v1

Référence complète de l'API →
GET/api/catalog/meVotre clé et votre solde
GET/api/catalog/modelsTous les modèles
GET/api/catalog/models/detail?id=MODEL_IDUn modèle et ses champs
POST/api/catalog/quotePrix pour des entrées exactes
POST/api/catalog/generationsLancer un rendu
GET/api/catalog/generationsVos rendus récents
GET/api/catalog/generations/IDStatut d'un rendu
GET/api/catalog/generations/ID/contentLe fichier résultat
DELETE/api/catalog/generations/IDSupprimer un rendu

Rechargez 3 € et commencez dans le studio

Créez une clé API dans Réglages et appelez n'importe quel modèle. Installez la CLI avec npm. Les rendus échoués sont remboursés.

Obtenir une clé APIVoir les prix