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#
| Condition | Credits Deducted |
|---|---|
| Per generation | 20 credits |
🎨 AI 3D Rendering#
Model (modelType) | Credits Deducted |
|---|---|
Flash | 1 credit |
Base | 3 credits |
Pro | 10 credits |
📐 Floor Plan Generation#
Model (modelType) | Credits Deducted |
|---|---|
Base | 10 credits |
Pro | 20 credits |
🏡 House Plan Generation#
Model (modelType) | Credits Deducted |
|---|---|
Base | 20 credits |
Pro | 40 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):
| Resolution | Duration | Credits Deducted |
|---|---|---|
480p | 5s | 10 credits |
480p | 10s | 20 credits |
720p | 5s | 20 credits |
720p | 10s | 40 credits |
1080p | 5s | 40 credits |
1080p | 10s | 80 credits |
Base model (modelType: "Base", generateAudio: false):
| Resolution | Duration | Credits Deducted |
|---|---|---|
480p | 5s | 8 credits |
480p | 10s | 16 credits |
720p | 5s | 16 credits |
720p | 10s | 32 credits |
1080p | 5s | 32 credits |
1080p | 10s | 64 credits |
Base model with audio (modelType: "Base", generateAudio: true):
| Resolution | Duration | Credits Deducted |
|---|---|---|
480p | 5s | 16 credits |
480p | 10s | 32 credits |
720p | 5s | 32 credits |
720p | 10s | 64 credits |
1080p | 5s | 64 credits |
1080p | 10s | 128 credits |
✨ Magic Editor#
Model (modelType) | Credits Deducted |
|---|---|
Flash | 1 credit |
Base | 3 credits |
Pro | 10 credits |
🗑️ Object Remover#
| Condition | Credits Deducted |
|---|---|
| Per generation | 1 credit |
🖼️ Photo Enhancer#
| Condition | Credits Deducted |
|---|---|
| Per generation | 1 credit |
🔄 Smart Replace#
| Condition | Credits Deducted |
|---|---|
| Per generation | 1 credit |
🎭 Texture Replacer#
| Condition | Credits Deducted |
|---|---|
| Per generation | 3 credits |
🏡 Virtual Staging#
| Condition | Credits Deducted |
|---|---|
| Per generation | 1 credit |
🏠 Exterior Renovator#
| Condition | Credits Deducted |
|---|---|
| Per generation | 1 credit |
🛋️ Change Furniture#
| Condition | Credits Deducted |
|---|---|
| Per generation | 1 credit |
🏡 Home Decor#
Model (modelType) | Credits Deducted |
|---|---|
Base | 3 credits |
Pro | 10 credits |
🏠 Interior Remodel#
| Condition | Credits Deducted |
|---|---|
| Per generation | 1 credits |
🌿 Landscaping#
Model (modelType) | Credits Deducted |
|---|---|
Flash | 1 credit |
Base | 3 credits |
Pro | 10 credits |
📐 Plan Visualizer#
Model (modelType) | Credits Deducted |
|---|---|
Base | 3 credits |
Pro | 10 credits |
🛋️ Furniture Try-On#
Model (modelType) | Credits Deducted |
|---|---|
Base | 3 credits |
Pro | 10 credits |
🖼️ Image Editing Pro#
| Condition | Credits Deducted |
|---|---|
| Per generation | 10 credit |
📊 Quick Reference Summary#
| API | Flash | Base | Pro | Notes |
|---|---|---|---|---|
| AI 3D Generation | — | — | — | Fixed 20 credits |
| AI 3D Rendering | 1 | 3 | 10 | — |
| Floor Plan | — | 10 | 20 | — |
| House Plan | — | 20 | 40 | — |
| Image to Video | ✅ | ✅ | — | By modelType × resolution × duration (8–128); Base supports generateAudio |
| Magic Editor | 1 | 3 | 10 | — |
| 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 |
| Exterior Renovator | — | — | — | Fixed 1 credit |
| Change Furniture | — | — | — | Fixed 1 credit |
| Home Decor | — | 3 | 10 | Default Base |
| Interior Remodel | — | — | — | Fixed 3 credits |
| Landscaping | 1 | 3 | 10 | Default Base |
| Plan Visualizer | — | 3 | 10 | Default Base |
| Furniture Try-On | — | 3 | 10 | — |
| Image Editing Pro | — | — | — | Fixed 10 credits |
⚠️ Important Notes#
- Credits are deducted at task creation, not at task completion.
- If a task fails, credits are automatically refunded.
- Insufficient credits will result in error code
9051(COINS_NOT_ENOUGH). Top up your account before retrying. - Credits deduction amounts are subject to change. Always refer to this document for the latest values.
© Ideal House AI — All rights reserved.