API BigImg
Appelez les outils de BigImg depuis votre propre code. Obtenez une clé depuis votre tableau de bord — l'usage est décompté des images gratuites mensuelles, crédits ou forfait de ce compte. Il n'y a pas de niveau gratuit séparé pour l'API.
Authentification
Envoyez votre clé comme jeton bearer à chaque requête :
Authorization: Bearer bigimg_live_...
Agrandir une image
POST https://bigimg.ai/api/v1/upscale
| Champ | Type | Description |
|---|---|---|
imageUrl | string (requis) | URL publiquement accessible de l'image source |
scale | number | 2, 4, 8 ou 16. Par défaut 2. 8/16 nécessitent un forfait payant ou des crédits. |
imageType | string | "photo" ou "anime". Par défaut "photo". |
denoise | string | "none" | "low" | "mid" | "high" | "max". Par défaut "max". |
Exemple
curl https://bigimg.ai/api/v1/upscale \
-H "Authorization: Bearer bigimg_live_..." \
-H "Content-Type: application/json" \
-d '{
"imageUrl": "https://example.com/photo.jpg",
"scale": 4
}'Réponse
{
"url": "https://replicate.delivery/.../output.png",
"resizedTo": null,
"via": "credit"
}url est un lien temporaire (expire au bout d'environ une heure) — téléchargez-le ou réhébergez-le si vous devez le conserver. via indique quel quota a été utilisé : free_pool, credit, unlimited ou share_bonus.
Erreurs
| Statut | Signification |
|---|---|
| 401 | Clé manquante, invalide ou révoquée |
| 400 | Requête invalide (imageUrl manquant, scale invalide, fichier trop volumineux pour votre forfait) |
| 403 | Fonctionnalité nécessitant un forfait payant (échelle/taille de fichier au-delà du niveau gratuit) |
| 429 | Quota épuisé — achetez des crédits ou abonnez-vous à Unlimited |
| 502 / 504 | Erreur du modèle en amont ou délai dépassé — nouvelle tentative possible sans risque |
Plus d'outils
Seul /api/v1/upscale est disponible pour l'instant. Suppression d'arrière-plan, de filigrane, réduction du bruit et amélioration arrivent ensuite — dites-nous lequel vous voulez en premier.