Skip to main content
POST
Generate video with P-Video 2 Pro

Authorizations

Authorization
string
header
required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Body

application/json
prompt
string
required

Text description of the video, including any sound you want to hear.

aspect_ratio
enum<string>
default:16:9

Aspect ratio for text-to-video. With a frame image the image sets the shape and this is ignored.

Available options:
16:9,
9:16,
4:3,
3:4,
3:2,
2:3,
1:1
end_image
string

Optional last frame. With image the video moves between the two frames; on its own the video ends on it. Same input forms as image.

image
string

Optional first frame for image-to-video; the video starts from it and follows its framing. Provide a public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads.

length_seconds
integer
default:5

Video length in seconds, any whole number from 5 to 15.

Required range: 5 <= x <= 15
mode
enum<string>
default:speed

Generation mode, which sets the price together with resolution: cost is the cheapest and also the fastest (about 20 s for 5 s of video), speed is the default (about 70 s), quality is the most detailed and the slowest (about 85 s). Credits per second: see mode_pricing in GET /v1/models.

Available options:
cost,
speed,
quality
resolution
enum<string>
default:768p

Output resolution: 480p (832x480 at 16:9) or 768p (1344x768 at 16:9). Sets the price together with mode.

Available options:
480p,
768p
seed
integer

Seed for reproducible generation. Omit for random.

Response

Job accepted.

id
string

Opaque job id — use it to poll status.

message
string
model
string
status
enum<string>

Lifecycle state. succeeded/failed/timeout are terminal.

Available options:
pending,
starting,
processing,
completing,
succeeded,
failed,
timeout