Skip to main content

Introduction

Nebula Lab V4 API uses a points-based billing model.

Billing Notes

  • Points are deducted when a task is submitted successfully (some video APIs use pre-deduction; points are finalized only after the task succeeds).
  • Duration-based APIs support formats such as 3s5s8s10s12s; points are calculated from the duration converted to seconds.
  • Points are rounded to 1 decimal place.

Video Generation

Text to Video

InterfaceCharging Rule
Text to Video - Submit Task0.6 points per second, calculated from request parameter duration converted to seconds
Text to Video - Query TaskNo charge

Image to Video - Traditional Mode

InterfaceCharging Rule
Image to Video (Traditional) - Submit Task0.1 points per second, calculated from duration converted to seconds
Image to Video (Traditional) - Query TaskNo charge

Image to Video - First/Last Frame Mode

InterfaceCharging Rule
Image to Video (First/Last Frame) - Submit Task0.4 points per second (equivalent to 2 points per 5 seconds), calculated from duration in seconds
Image to Video (First/Last Frame) - Query TaskNo charge

Image to Video - Face Swap

InterfaceCharging Rule
Image to Video (Face Swap) - Submit Task0.4 points per second, calculated from video duration (seconds) parsed from the input video URL
Image to Video (Face Swap) - Query TaskNo charge

Image Generation (AI Image)

All listed interfaces are charged per image at 0.2 points per image. If the interface supports a count parameter n, total points = 0.2 × n.
InterfaceCharging Rule
AI Image - Text to Image0.2 points per image (1 image per call)
AI Image - Image to Image0.2 points per image (1 image per call)
AI Image - Batch Generation0.2 points per image, total = 0.2 × parameter n
AI Image - Variation0.2 points per image, total = 0.2 × parameter n
AI Image - Fashion Try-on0.2 points per image, default 1, optional n
AI Image - Smart Watermark Removal0.2 points per image, default 1, optional n
AI Image - Product Extraction0.2 points per image, default 1, optional n
AI Image - Clothing Details0.2 points per image, default 1, optional n
AI Image - HD Retouching0.2 points per image, default 1, optional n

Object Transfer (Any Shoot)

InterfaceCharging Rule
Object Transfer - Standard Mode - Submit Task1 point per call (fixed)
Object Transfer - Creative Mode0.2 points per call (fixed)
Object Transfer - Dressing Mode - Submit Task0.9 points per call (fixed)
Object Transfer - Dressing Mode - Query TaskNo charge
Object Transfer - Query TaskNo charge

Billing Summary

CapabilityBilling BasisRate
Text to VideoBy video duration0.6 points/sec
Image to Video - TraditionalBy video duration0.1 points/sec
Image to Video - First/Last FrameBy video duration0.4 points/sec
Image to Video - Face SwapBy video duration0.4 points/sec
AI Image (text-to-image, image-to-image, batch, variation, fashion try-on, watermark removal, product extraction, clothing details, HD retouching)Per image0.2 points/image
Object Transfer - Standard ModePer call1 point/call
Object Transfer - Creative ModePer call0.2 points/call
Object Transfer - Dressing ModePer call0.9 points/call

Deduction and Pre-deduction

  • Immediate deduction: Most image generation, image-to-video (traditional / first-last frame), and object transfer creative/dressing mode—points are deducted from the account when the submit request succeeds.
  • Pre-deduction: Text to video, image-to-video face swap, object transfer standard mode, and object transfer dressing mode—a “unpaid” points record is created on submit; it is marked as paid only after the task succeeds (e.g., query shows success or callback succeeds). If the task fails, points may not be charged or may be refunded per business logic.
Ensure your account has sufficient points before calling; otherwise you will receive an insufficient balance error.