Generate an image or video (x402 or API-key paid)

post/v1/agent/generate

Request

  • Base URL: https://livepairai.com (the document declares no server; this is the origin it was published from)
  • URL: https://livepairai.com/v1/agent/generate
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer
    • none

Request body

promptstring required
modelIdstring

model id from /v1/agent/models

imagestring

Source image for i2i/i2v models — public http(s) URL or data:image URI (<=8MB). Use AI-generated or owned images only, never real-person photos without consent. Screened by the same policy check as the studio.

image2string

Face/subject reference image for swap models — same rules as image.

videostring

Source clip for motion-control / video-input models — https URL or data:video URI (<=40MB).

useReferencesboolean

Embed the prompt and attach top matches from your reference library (POST /v1/agent/references) to the model's empty media inputs — lp_ key or SIWX wallet required.

referenceIdsstring[]

Pin exact reference ids to the model's empty media inputs (image→image/image2, video→video).

imageSizestring
aspectRatiostring
durationnumber

Video length in seconds — billed per second at the model's per-resolution rate

resolutionstring
audioboolean

Audio track on audio-capable video models (default on)

payerstring

Your payer wallet — applies your volume-tier discount to the 402 quote (5% at $100+, 10% at $500+, 15% at $2000+ lifetime paid). Must equal the wallet that signs the payment.

Response

{status:'done',url} or {status:'running',jobId,poll} — payment settles on submit

status'done' | 'running' required
urlstring
jobIdstring
pollstring

Changes

No recorded changes to this operation across all 1 revision of this API.