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 GenerationтАФтАФтАФFixed 20 credits
AI 3D Rendering1310тАФ
Floor PlanтАФ1020тАФ
House PlanтАФ2040тАФ
Image to VideoтЬЕтЬЕтАФBy modelType ├Ч resolution ├Ч duration (8тАУ128); Base supports generateAudio
Magic Editor1310тАФ
Object RemoverтАФтАФтАФFixed 1 credit
Photo EnhancerтАФтАФтАФFixed 1 credit
Smart ReplaceтАФтАФтАФFixed 1 credit
Texture ReplacerтАФтАФтАФFixed 3 credits
Virtual StagingтАФтАФтАФFixed 1 credit
Furniture Try-OnтАФ310тАФ
Image Editing ProтАФтАФтАФFixed 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.

AI 3D Rendering APIError Codes