Base URL: https://api.ideal.house
Updated: 2026-04-10
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.
| Condition | Credits Deducted |
|---|
| Per generation | 20 credits |
Model (modelType) | Credits Deducted |
|---|
Flash | 1 credit |
Base | 3 credits |
Pro | 10 credits |
Model (modelType) | Credits Deducted |
|---|
Base | 10 credits |
Pro | 20 credits |
Model (modelType) | Credits Deducted |
|---|
Base | 20 credits |
Pro | 40 credits |
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 |
Model (modelType) | Credits Deducted |
|---|
Flash | 1 credit |
Base | 3 credits |
Pro | 10 credits |
| Condition | Credits Deducted |
|---|
| Per generation | 1 credit |
| Condition | Credits Deducted |
|---|
| Per generation | 1 credit |
| Condition | Credits Deducted |
|---|
| Per generation | 1 credit |
π Texture Replacer
| Condition | Credits Deducted |
|---|
| Per generation | 3 credits |
| Condition | Credits Deducted |
|---|
| Per generation | 1 credit |
| Condition | Credits Deducted |
|---|
| Per generation | 1 credit |
| Condition | Credits Deducted |
|---|
| Per generation | 1 credit |
Model (modelType) | Credits Deducted |
|---|
Base | 3 credits |
Pro | 10 credits |
| Condition | Credits Deducted |
|---|
| Per generation | 1 credits |
Model (modelType) | Credits Deducted |
|---|
Flash | 1 credit |
Base | 3 credits |
Pro | 10 credits |
Model (modelType) | Credits Deducted |
|---|
Base | 3 credits |
Pro | 10 credits |
Model (modelType) | Credits Deducted |
|---|
Base | 3 credits |
Pro | 10 credits |
| Condition | Credits Deducted |
|---|
| Per generation | 10 credit |
| 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 |
- 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.