Docs

API Documentation

Credits Deduction Reference

Base URL: https://api.ideal.house
Updated: 2026-04-10


📖 Overview

Each API call deducts a certain number of credits from your account at the moment the task is successfully created. If a task ultimately fails, the deducted credits will be automatically refunded to your account.

💡 You can check your current credit balance via the Account API or in the Ideal House dashboard.


💰 Credits Deduction by API

🏠 AI 3D Generation

ConditionCredits Deducted
Per generation20 credits

🎨 AI 3D Rendering

Model (modelType)Credits Deducted
Flash1 credit
Base3 credits
Pro10 credits

📐 Floor Plan Generation

Model (modelType)Credits Deducted
Base10 credits
Pro20 credits

🏡 House Plan Generation

Model (modelType)Credits Deducted
Base20 credits
Pro40 credits

🎬 Image to Video

Credits are deducted based on the combination of modelType, resolution, duration, and whether generateAudio is enabled.

Flash model (modelType: "Flash", default):

ResolutionDurationCredits Deducted
480p5s10 credits
480p10s20 credits
720p5s20 credits
720p10s40 credits
1080p5s40 credits
1080p10s80 credits

Base model (modelType: "Base", generateAudio: false):

ResolutionDurationCredits Deducted
480p5s8 credits
480p10s16 credits
720p5s16 credits
720p10s32 credits
1080p5s32 credits
1080p10s64 credits

Base model with audio (modelType: "Base", generateAudio: true):

ResolutionDurationCredits Deducted
480p5s16 credits
480p10s32 credits
720p5s32 credits
720p10s64 credits
1080p5s64 credits
1080p10s128 credits

✨ Magic Editor

Model (modelType)Credits Deducted
Flash1 credit
Base3 credits
Pro10 credits

🗑️ Object Remover

ConditionCredits Deducted
Per generation1 credit

🖼️ Photo Enhancer

ConditionCredits Deducted
Per generation1 credit

🔄 Smart Replace

ConditionCredits Deducted
Per generation1 credit

🎭 Texture Replacer

ConditionCredits Deducted
Per generation3 credits

🏡 Virtual Staging

ConditionCredits Deducted
Per generation1 credit

🛋️ Furniture Try-On

Model (modelType)Credits Deducted
Base3 credits
Pro10 credits

🖼️ Image Editing Pro

ConditionCredits Deducted
Per generation10 credit

📊 Quick Reference Summary

APIFlashBaseProNotes
AI 3D GenerationFixed 20 credits
AI 3D Rendering1310
Floor Plan1020
House Plan2040
Image to VideoBy modelType × resolution × duration (8–128); Base supports generateAudio
Magic Editor1310
Object RemoverFixed 1 credit
Photo EnhancerFixed 1 credit
Smart ReplaceFixed 1 credit
Texture ReplacerFixed 3 credits
Virtual StagingFixed 1 credit
Furniture Try-On310
Image Editing ProFixed 10 credits

⚠️ Important Notes

  1. Credits are deducted at task creation, not at task completion.
  2. If a task fails, credits are automatically refunded.
  3. Insufficient credits will result in error code 9051 (COINS_NOT_ENOUGH). Top up your account before retrying.
  4. Credits deduction amounts are subject to change. Always refer to this document for the latest values.

© Ideal House AI — All rights reserved.