1. Preparation
PixVerse Platform Docs
  • Get Started
    • What Is PixVerse AI?
    • Model Capability Map
    • Billing and Usage
    • Quick Start
    • Contact Us
    • Privacy and Data Protection
  • API
    • Preparation
      • Start Here
      • Concurrency Rules
      • Query Task Status
      • Error Codes
      • FAQ
      • Webhook Callbacks
      • Upload Image
        POST
      • Upload Media (Video and Audio)
        POST
      • Verify Uploaded Audio
        POST
      • Get Effect Template List
        GET
      • Get TTS Speaker List
        GET
      • Get Restyle Effect List
        GET
      • Query Task Status
        GET
      • Get Account Balance
        GET
      • Usage Deduction Query
        POST
      • Create Custom Voice
        POST
      • Delete Custom Voice
        DELETE
    • Core Capabilities
      • Text-to-Video
      • Image-to-Video and Video Templates
      • First and Last Frame Video
      • Reference-to-Video (Fusion)
      • Multi-Transition Video
      • Video Extend
      • Image Template Generation
      • Get Image Generation Result
    • Solutions
      • Video Upscale
      • Video Restyle
      • Lipsync
      • Video Edit (Modify)
      • Image Avatar
      • Select Video Mask
      • Sound Effect
      • Subject Replacement (Swap)
      • Motion Control (Mimic)
      • One-click Real Estate Video
      • One-click VibeMV
  • Pricing
    • PixVerse API Pricing
  • Changelog
    • Changelog
  1. Preparation

Usage Deduction Query

POST
/openapi/v2/account/billing/usage-detail

First page: provide both start_time and end_time, with a range no longer than 30 days and start_time <= end_time. An empty body is invalid. Next page: pass the previous next_cursor unchanged; the server reuses the original filters. Stop when has_more is false. No generation task is created.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
Successful response.
Bodyapplication/json

🟠400
🟠401
Request Request Example
Shell
curl --location 'https://app-api.pixverse.ai/openapi/v2/account/billing/usage-detail' \
--header 'API-KEY: your-api-key' \
--header 'Ai-trace-id: 550e8400-e29b-41d4-a716-446655440000' \
--header 'Content-Type: application/json' \
--data '{
    "start_time": "2026-08-26 00:00:00",
    "end_time": "2026-08-26 23:59:59",
    "limit": 20
}'
Response Response Example
200 - Successful query with no matching records
{
    "ErrCode": 0,
    "ErrMsg": "Success",
    "Resp": {
        "items": [],
        "next_cursor": "",
        "has_more": false
    }
}
Previous
Get Account Balance
Next
Create Custom Voice