OpenAI Compatible

Create a video generation task in the OpenAI Videos shape

Projection of createTask onto the OpenAI Videos API. model must be a video endpoint identifier from /v1/models. prompt maps to the model's prompt; input_reference (an HTTPS URL or a committed spicy:// upload) maps to image_url / image_urls; seconds maps to duration_seconds; size (WIDTHxHEIGHT) maps to resolution and/or aspect_ratio, or to width / height when the model declares pixel dimensions. A parameter the selected model does not declare is rejected with 400. The same hold and idempotency rules as createTask apply; the returned object never contains prices.

post/v1/videos

Request

  • Base URL: https://api.spicyapi.ai
  • URL: https://api.spicyapi.ai/v1/videos
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Stable key for one logical task submission; retained for 24 hours per account and bound to both the submitting API key and normalized request fingerprint. A sibling key receives 409 without the original task ID.

Request body

modelstring required

Video endpoint identifier from /v1/models.

promptstring required
input_referencestring

Reference image URL; mapped to the model's image_url / image_urls.

sizestring

WIDTHxHEIGHT, mapped to resolution / aspect_ratio (or width / height).

Response

The accepted task as a video object in queued state (an idempotent replay reports the current state).

idstring required

Task identifier; also accepted by /api/v1/jobs/recordInfo.

object'video' required
modelstring required
status'queued' | 'in_progress' | 'completed' | 'failed' required
progressinteger required

100 when completed

created_atinteger required
completed_atinteger
secondsstring
sizestring

Changes

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