generation

Start a video generation

Submits a video generation and returns immediately with status generating. Poll GET /v1/videos/{id} (every ~5 seconds) until status is completed (video_url populated) or failed. Credits are deducted only on success. This endpoint shares its implementation with the website, so safety checks, model fallback, and credit accounting are identical; its error shape is {"error": "<message>"}.

Async contract: returns 202 with a Location header pointing at the poll URL; poll every ~5 seconds until status is completed or failed. Idempotency: send Idempotency-Key so a retry cannot double-charge. Sandbox: send X-Sandbox: true to rehearse without spending credits.

post/v1/generate/video

Request

  • Base URL: https://aicontentdrop.com
  • URL: https://aicontentdrop.com/v1/generate/video
  • Auth: HTTP bearer

Query parameters

sandbox'true'

Query-parameter form of the X-Sandbox header, for clients that cannot set headers.

Headers

Idempotency-Keystring

Client-generated unique key (max 200 chars). Retrying with the same key returns the FIRST response instead of starting a second generation, so a dropped connection cannot double-charge. Reusing a key with a different body returns 409.

X-Sandbox'true'

Set to true to validate the request and receive a synthetic completed generation. No provider call, no credits spent, no record created. Use it to rehearse an integration before it costs money.

X-Sandbox'true' | '1'

Send true to rehearse this call. Returns a synthetic completed generation: no provider call, no credits, no history row. Validation still runs. Works without an API key, so the response shape is observable before a credential exists. Documented at https://aicontentdrop.com/docs/sandbox.

Idempotency-Keystring

Client-generated key (max 200 characters). A retry with the same key returns the FIRST response instead of starting a second generation. The same key with a different body is a 409. Keys are retained 24 hours.

Request body

promptstring required

What to generate, in natural language

aiModelstring

Model ID from /v1/models (e.g. kling_3_0). Omit to let the platform choose.

durationnumber

Clip length in seconds (model-dependent caps apply)

aspectRatiostring

16:9, 9:16, or 1:1

stylestring
negativePromptstring
imageUrlstring uri

Optional image-to-video conditioning; must be a public https:// URL

endFrameUrlstring uri

Convenience for a last_frame reference

qualitystring
resolutionstring
modestring

Example request

{
  "aiModel": "kling_3_0"
}

Response

Accepted. Poll GET /v1/videos/{id} until status is completed or failed.

sandboxboolean

true when X-Sandbox: true was sent. Nothing was generated and no credits were spent.

Changes

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