Submit a Video Task

Endpoint

POST https://api.apimart.cc/v1/videos

Request Headers

Header	Required	Description
Authorization	Yes	Bearer sk-your-api-key
Content-Type	Yes	application/json

Request Body

Top-Level Fields

Field	Type	Required	Description
model	string	Yes	Model ID (see Available Models)
prompt	string	Yes	Text description of the video to generate
seconds	integer	Model-specific	Requested output duration; provide it explicitly within the selected model’s supported range
metadata	object	No	Additional generation parameters

Metadata Fields

Field	Type	Values	Default	Description
resolution	string	480P, 720P, 1080P	720P	Output resolution
ratio	string	1:1, 16:9, 9:16, 4:3, 3:4, adaptive	1:1	Aspect ratio
media	array	—	—	Reference media (see below)

Reference Media

Reference support varies by exact model ID. The following example uses image references exposed by the checked Wan 3.0 reference-to-video-global schema:

{
  "model": "tk-wan3.0-video-prime",
  "prompt": "The person in image 1 is walking through the garden in image 2",
  "seconds": 5,
  "metadata": {
    "resolution": "720P",
    "ratio": "16:9",
    "media": [
      { "type": "reference_image", "url": "https://example.com/person.jpg" },
      { "type": "reference_image", "url": "https://example.com/garden.jpg" }
    ]
  }
}

Media types:

Type	Description	Limits
reference_image	Reference image	Up to 10 per request
first_frame	First frame image	1 only

Check the selected model’s input limits

Reference video and audio support is model-specific. The checked Wan 3.0 reference-to-video-global schema exposes images only. Retrieve the model details and use only supported inputs.

Duration Limits

Duration ranges vary by model:

Model	Range	Notes
Wan 3.0 reference-to-video-global	4–30 seconds	Integer duration; checked November 5, 2026

For other models, retrieve their exact schemas. The metadata options above are examples, not universal defaults or supported values for every model.

Response

{
  "id": "vt-abc123def",
  "object": "video",
  "status": "queued",
  "created_at": 1760000000
}

Field	Type	Description
id	string	Task ID — use this to poll for results
status	string	Task state; a pending task normally starts as queued
created_at	integer	Unix timestamp

Examples

Text-to-Video

curl -X POST https://api.apimart.cc/v1/videos \
  -H "Authorization: Bearer $HIPIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tk-wan3.0-video",
    "prompt": "A slow pan across a cyberpunk city at night, neon signs reflecting in puddles",
    "seconds": 5,
    "metadata": { "resolution": "720P", "ratio": "16:9" }
  }'

Image-to-Video (Single Reference)

curl -X POST https://api.apimart.cc/v1/videos \
  -H "Authorization: Bearer $HIPIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tk-wan3.0-video",
    "prompt": "The character starts walking forward, camera follows",
    "seconds": 5,
    "metadata": {
      "resolution": "720P",
      "media": [{ "type": "first_frame", "url": "https://example.com/frame.jpg" }]
    }
  }'

Reference-to-Video (Multiple Inputs)

curl -X POST https://api.apimart.cc/v1/videos \
  -H "Authorization: Bearer $HIPIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tk-wan3.0-video-prime",
    "prompt": "Person from image 1 walks through the garden in image 2",
    "seconds": 10,
    "metadata": {
      "resolution": "1080P",
      "ratio": "16:9",
      "media": [
        { "type": "reference_image", "url": "https://example.com/person.jpg" },
        { "type": "reference_image", "url": "https://example.com/garden.jpg" }
      ]
    }
  }'