L’API, avec les tarifs écrits
Tous les concurrents de cette catégorie cachent le prix de leur API derrière un appel commercial. Voici le nôtre, y compris l’endpoint par lot qu’aucun d’eux ne propose.
Les clés d’API sont émises sur les formules Pro, Studio et Agency.
Authentification
Un jeton bearer par clé. Les clés sont affichées une seule fois à la création, stockées uniquement sous forme de hachage, et révocables depuis votre compte.
POST https://api.miradora.ai/v1/generate
Authorization: Bearer mk_live_…
Content-Type: application/json
{
"kind": "redesign",
"image_url": "https://…",
"style": "japandi",
"room_type": "living-room",
"structure_lock": true,
"creativity": 40,
"variations": 4,
"resolution": "2k",
"idempotency_key": "5f0c1c0e-2c1a-4f5e-9c3a-0d1b2e3f4a5b",
"webhook_url": "https://…"
}
202 Accepted
{ "job_id": "…", "credits_charged": 4, "eta_seconds": 18 }Endpoints
| HTTP | Endpoints | Ce que cela veut dire |
|---|---|---|
| POST | /v1/generate | Enqueue a generation. Returns 202 with a job id, the credits charged and an ETA. |
| POST | /v1/batch | Enqueue many generations in one call. One idempotency key per item. |
| GET | /v1/jobs/{id} | Poll a job: status, progress, honest queue position and ETA. |
| POST | /v1/jobs/{id}/cancel | Cancel a job. Always a full credit refund. |
| GET | /v1/generations/{id} | The finished render, with the model, seed and prompt that produced it. |
| GET | /v1/generations/{id}/items | Detected objects in a render, for Shop the Look. |
| POST | /v1/segment | Point, box or text prompt to a mask. Costs 0 credits. |
| GET | /v1/catalog | Styles, room types and materials. Heavily cached. |
| GET | /v1/credits | Current balance, and the ledger behind it. |
Limites de débit
Par clé, sur une minute glissante. Les dépasser renvoie un 429 avec un retry-after.
| Formule | Requêtes / minute | Éléments par lot |
|---|---|---|
| Pro | 60 | 25 |
| Studio | 150 | 100 |
| Agency | 600 | 250 |
Ce que coûte un appel
Les appels API consomment les mêmes crédits que l’application, sur le même solde, aux mêmes coûts publiés. Il n’y a pas de grille séparée pour l’API.
Ne coûte jamais rien
- Chat avec le conseiller déco0
- Critique de design0
- Navigation et Découvrir0
- Aperçu de style0
- Recherche de produits0
- Re-télécharger ce que vous avez déjà fait0
- Envoyer et étiqueter une photo0
- Toucher un objet pour le sélectionner0
- Parcourir le catalogue de styles et de pièces0
La navigation, le chat design, la critique écrite, les aperçus de style, la recherche de produits et le re-téléchargement de ce que vous avez déjà fait sont gratuits pour toujours. Ils sont listés ici pour que la promesse soit vérifiable.
Opérations facturées
| Opération | Crédits | Par variation ? |
|---|---|---|
| Agrandissement / amélioration | 1 | Non — un seul résultat quoi qu’il arrive |
| Changement de sol et de matériaux | 1 | Oui — 4 variations coûtent 4× |
| Ciel et météo | 1 | Oui — 4 variations coûtent 4× |
| Compositeur de pièce | 1 | Oui — 4 variations coûtent 4× |
| Couleurs et textures | 1 | Oui — 4 variations coûtent 4× |
| Créateur de meuble | 1 | Oui — 4 variations coûtent 4× |
| Croquis vers rendu | 1 | Oui — 4 variations coûtent 4× |
| Design extérieur | 1 | Oui — 4 variations coûtent 4× |
| Home staging virtuel | 1 | Oui — 4 variations coûtent 4× |
| Modifier au toucher — un objet | 1 | Non — un seul résultat quoi qu’il arrive |
| Nettoyage — retirer un objet | 1 | Non — un seul résultat quoi qu’il arrive |
| Paysage et jardin | 1 | Oui — 4 variations coûtent 4× |
| Redesign | 1 | Oui — 4 variations coûtent 4× |
| Rendu multi-angle — par angle supplémentaire | 1 | Oui — 4 variations coûtent 4× |
| Texte vers design | 1 | Oui — 4 variations coûtent 4× |
| Transfert de style | 1 | Oui — 4 variations coûtent 4× |
| Vider la pièce | 1 | Non — un seul résultat quoi qu’il arrive |
| Visualiseur de peinture | 1 | Oui — 4 variations coûtent 4× |
| Compositeur intelligent — disposez vos propres meubles | 2 | Oui — 4 variations coûtent 4× |
| Plan 2D → 3D | 2 | Non — un seul résultat quoi qu’il arrive |
| Redesign magique — langage naturel et photos de référence | 2 | Oui — 4 variations coûtent 4× |
| Image → objet 3D pour la RA | 3 | Non — un seul résultat quoi qu’il arrive |
| Vidéo de visite | 3 | Non — un seul résultat quoi qu’il arrive |
| Supplément sortie 4K | +1 | Non — un seul résultat quoi qu’il arrive |
Les variations multiplient le coût des modes marqués « par variation ». Quatre variations d’un Redesign coûtent quatre crédits, et le total exact s’affiche avant que vous n’appuyiez sur Générer.
Un rendu 4K ajoute un crédit. Nous générons les variations en 1K et n’agrandissons que celle que vous choisissez : rendre quatre variations nativement en 4K nous coûte 2,2× plus cher pour trois images que vous alliez jeter.
Erreurs
| Code | HTTP | Ce que cela veut dire |
|---|---|---|
| insufficient_credits | 402 | You need {required} credits. You have {available}. |
| image_too_small | 400 | This photo is {width}×{height}. We need at least {min}px on the short side — try retaking it, or pick the full-size original rather than a screenshot. |
| unsupported_format | 400 | We can’t read {format} images. JPEG, PNG, HEIC and WebP all work. |
| room_not_found | 404 | That room no longer exists. |
| idempotency_key_required | 400 | Something went wrong on our side. Please try again. |
| content_policy | 422 | We couldn’t render this one: {policy}. If that looks wrong to you, appeal and a human will look. |
| rate_limited | 429 | Slow down a moment — try again in {retry_after}s. |
| vendor_unavailable | 503 | Our image service is having a moment. Your credits are safe — we’ve refunded this render. |
| job_timeout | 504 | This render took too long, so we stopped it and refunded your credits. |
Webhooks
La génération est asynchrone. Fournissez un webhook_url et nous y envoyons l’état final en POST, signé. Interrogez l’endpoint des jobs si vous préférez ne pas héberger d’écouteur.
À qui appartient le résultat
À vous. Ce qui est généré avec votre clé vous est cédé, pour un usage commercial, à partir de Pro. Nous n’entraînons rien sur ce qui est envoyé à l’API.