apimart-zoe Video Generation

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "apimart-zoe",
    "prompt": "An orange kitten looks toward the camera from a windowsill, with sunlight from the side and a slow camera push-in",
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 8,
    "audio": true,
    "nsfw_check": true,
    "return_last_frame": true
  }'

import requests

response = requests.post(
    "https://api.apimart.ai/v1/videos/generations",
    headers={"Authorization": "Bearer <token>"},
    json={
        "model": "apimart-zoe",
        "prompt": "An orange kitten looks toward the camera from a windowsill, with sunlight from the side and a slow camera push-in",
        "resolution": "1080p",
        "aspect_ratio": "16:9",
        "duration": 8,
        "audio": True,
        "nsfw_check": True,
        "return_last_frame": True
    }
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "model": "apimart-zoe",
    "prompt": "An orange kitten looks toward the camera from a windowsill, with sunlight from the side and a slow camera push-in",
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 8,
    "audio": true,
    "nsfw_check": true,
    "return_last_frame": true
  })
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KZOEEXAMPLE"
    }
  ]
}

​

Choose a mode

​

Headers

​

Request parameters

​

Media addresses and combination limits

​

Reference video validation

​

Media combination rules

• Do not send image_urls and image_with_roles together. Doing so returns HTTP 400 (invalid_request_error) at submission, with no charge. The aliases image, images and image_url count as image_urls and cannot bypass this restriction.
• First/last frames cannot appear in the same request as reference images, videos or audio.
• At most one first frame and one last frame. A last frame requires a first frame.
• Up to 30 reference images, 10 reference videos and 10 reference audio clips, with a combined maximum of 50 media items.
• Violating these combination or count limits causes a synchronous HTTP 400 at submission, with no charge.
• omni_reference_task_type: "edit" requires at least one source video (3.8 ≤ t < 30.2 seconds). Omit duration / seconds or set -1; omit aspect_ratio / size or set adaptive. Do not combine with draft: true. Auto/reference modes retain the 2–15-second limit and its tolerance.

​

Request examples

​

First and last frames

{
  "model": "apimart-zoe",
  "prompt": "Transition naturally from the first frame to the last frame, keeping the lighting consistent",
  "image_with_roles": [
    {
      "url": "https://example.com/start.jpg",
      "role": "first_frame"
    },
    {
      "url": "https://example.com/end.jpg",
      "role": "last_frame"
    }
  ],
  "duration": 6
}

​

Image, video and audio references

{
  "model": "apimart-zoe",
  "prompt": "The character in the reference image moves naturally in the reference video scene, with background music matching the visual rhythm",
  "image_urls": [
    "https://example.com/character.jpg"
  ],
  "video_urls": [
    "https://example.com/scene.mp4"
  ],
  "audio_urls": [
    "https://example.com/bgm.mp3"
  ],
  "duration": -1
}

​

Video editing

{
  "model": "apimart-zoe",
  "prompt": "Turn the scene into a black-and-white classic film while preserving the camera movement and composition",
  "video_urls": [
    "https://example.com/source_20s.mp4"
  ],
  "omni_reference_task_type": "edit"
}

​

Last-frame image, MOV output and prompt optimization

{
  "model": "apimart-zoe",
  "prompt": "An orange kitten looks toward the camera from a windowsill, with sunlight from the side and a slow camera push-in",
  "duration": 5,
  "return_last_frame": true,
  "output_format": "mov",
  "enhance_prompt": true
}

​

Draft → final video

1. Submit a draft with draft: true. Omit resolution to use 480p, or explicitly set it to 480p; other values are not supported.

{
  "model": "apimart-zoe",
  "prompt": "An orange kitten looks toward the camera from a windowsill, with sunlight from the side and a slow camera push-in",
  "draft": true
}

2. Wait for the draft to succeed, then submit its task_id for final generation. Only model and draft_task_id are needed. If you specify resolution, it must be 1080p.

{
  "model": "apimart-zoe",
  "draft_task_id": "task_01KZOEEXAMPLE"
}

​

Query tasks and results

curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task_01KZOEEXAMPLE \
  --header 'Authorization: Bearer <token>'

{
  "code": 200,
  "data": {
    "id": "task_01KZOEEXAMPLE",
    "status": "completed",
    "result": {
      "videos": [
        {
          "url": [
            "https://example.com/generated-video.mp4"
          ],
          "expires_at": 1794475442
        }
      ],
      "last_frame_url": "https://example.com/generated-last-frame.png"
    },
    "progress": 100,
    "completed": 1794389042
  }
}

​

Billing rules

• Total reference video duration R: probe each clip at submission, sum the durations, then round the sum down to whole seconds. It is not adjusted later.
• Without reference videos: billable seconds = D. With reference videos: billable seconds = D + max(R, ceil(D × 2/3)). ceil rounds up to a whole second. Use the rate for generation with reference videos.
• For example, requesting 8 seconds keeps D = 8 even if the video lasts 8.2 seconds. An automatic duration of 8.5 seconds gives D = 9. Reference clips of 2.8 and 3.8 seconds are summed to 6.6 and then rounded down, giving R = 6.
• Drafts use the 480p rate and final videos the 1080p rate, billed separately. If a draft used reference videos, their original duration is also billed for the final video; no re-upload is needed.
• Failed submissions are not charged. Failed tasks are automatically refunded.

​

Common errors