Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Token-based authentication with required prefix "Token"

Body

Serializer for creating image-to-video jobs.

prompt
string
required

Prompt text to generate from.

Maximum string length: 80000
model_name
enum<string>
required
  • atlas_ultra_i2v - atlas_ultra_i2v
  • atlas_ultra_nsfw_i2v - atlas_ultra_nsfw_i2v
  • gemini_omni_flash_i2v - gemini_omni_flash_i2v
  • grok_imagine_video_1_5_i2v - grok_imagine_video_1_5_i2v
  • grok_imagine_video_i2v - grok_imagine_video_i2v
  • happy_horse_1_0_i2v - happy_horse_1_0_i2v
  • hexal_standard_i2v - hexal_standard_i2v
  • hexal_standard_nsfw_i2v - hexal_standard_nsfw_i2v
  • hexal_ultra_i2v - hexal_ultra_i2v
  • hexal_ultra_nsfw_i2v - hexal_ultra_nsfw_i2v
  • hexal_fast_i2v - hexal_fast_i2v
  • kling_2_6_pro_i2v - kling_2_6_pro_i2v
  • kling_3_0_turbo_standard_i2v - kling_3_0_turbo_standard_i2v
  • kling_3_0_turbo_pro_i2v - kling_3_0_turbo_pro_i2v
  • kling_3_0_i2v - kling_3_0_i2v
  • kling_3_0_pro_i2v - kling_3_0_pro_i2v
  • seedance_2_0_i2v - seedance_2_0_i2v
  • seedance_2_0_fast_i2v - seedance_2_0_fast_i2v
  • sora_2_i2v - sora_2_i2v
  • sora_2_pro_i2v - sora_2_pro_i2v
  • veo_3_1_fal_i2v - veo_3_1_fal_i2v
  • veo_3_1_fal_first_last_frame_i2v - veo_3_1_fal_first_last_frame_i2v
  • veo_3_1_fast_generate_preview_v2 - veo_3_1_fast_generate_preview_v2
  • veo_3_1_fast_fal_first_last_frame_i2v - veo_3_1_fast_fal_first_last_frame_i2v
  • veo_3_1_generate_preview - veo_3_1_generate_preview
  • veo_3_1_fast_generate_preview - veo_3_1_fast_generate_preview
  • wan_2_7_i2v - wan_2_7_i2v
Available options:
atlas_ultra_i2v,
atlas_ultra_nsfw_i2v,
gemini_omni_flash_i2v,
grok_imagine_video_1_5_i2v,
grok_imagine_video_i2v,
happy_horse_1_0_i2v,
hexal_standard_i2v,
hexal_standard_nsfw_i2v,
hexal_ultra_i2v,
hexal_ultra_nsfw_i2v,
hexal_fast_i2v,
kling_2_6_pro_i2v,
kling_3_0_turbo_standard_i2v,
kling_3_0_turbo_pro_i2v,
kling_3_0_i2v,
kling_3_0_pro_i2v,
seedance_2_0_i2v,
seedance_2_0_fast_i2v,
sora_2_i2v,
sora_2_pro_i2v,
veo_3_1_fal_i2v,
veo_3_1_fal_first_last_frame_i2v,
veo_3_1_fast_generate_preview_v2,
veo_3_1_fast_fal_first_last_frame_i2v,
veo_3_1_generate_preview,
veo_3_1_fast_generate_preview,
wan_2_7_i2v
requested_resolution
string
required

Requested video resolution (e.g. 480p).

Maximum string length: 20
requested_video_duration
number<double>
required

Requested video duration in seconds.

Required range: x >= 1
model_config
any

Model-specific configuration parameters (temperature, style, quality, etc.).

style_settings
string<uuid>[]

Style presets applied to this job (camera, lighting, generation, etc.)

start_frame
string<uuid> | null

Optional image to use as the starting frame of the video.

last_frame
string<uuid> | null

Optional image to use as the ending frame of the video.

Response

Serializer for creating image-to-video jobs.

id
string<uuid>
required
read-only
created_at
string<date-time>
required
read-only

Datetime when the record was created.

error_message
string
required
read-only

Error details if job failed.

status
enum<string>
required

Current job status.

  • queued - Queued
  • processing - Processing
  • expired - Expired
  • cancelled - Cancelled
  • completed - Completed
  • failed - Failed
Available options:
queued,
processing,
expired,
cancelled,
completed,
failed
description
string
required
read-only

Human-readable job description.

started_at
string<date-time>
required
read-only

When job processing started.

finished_at
string<date-time> | null
required
read-only

When the job processing successfully finished.

processing_time_seconds
number<double>
required
read-only

Calculate job processing time in seconds. If the job is still processing, calculate time since started. If the job was cancelled, deleted, calculate time until that point. if the job is completed, calculate time until finished.

cost_credits
string<decimal>
required
read-only

Job cost in 🪙 Credits.

Pattern: ^-?\d{0,8}(?:\.\d{0,2})?$
prompt
string
required

Prompt text to generate from.

Maximum string length: 80000
model_name
enum<string>
required
  • atlas_ultra_i2v - atlas_ultra_i2v
  • atlas_ultra_nsfw_i2v - atlas_ultra_nsfw_i2v
  • gemini_omni_flash_i2v - gemini_omni_flash_i2v
  • grok_imagine_video_1_5_i2v - grok_imagine_video_1_5_i2v
  • grok_imagine_video_i2v - grok_imagine_video_i2v
  • happy_horse_1_0_i2v - happy_horse_1_0_i2v
  • hexal_standard_i2v - hexal_standard_i2v
  • hexal_standard_nsfw_i2v - hexal_standard_nsfw_i2v
  • hexal_ultra_i2v - hexal_ultra_i2v
  • hexal_ultra_nsfw_i2v - hexal_ultra_nsfw_i2v
  • hexal_fast_i2v - hexal_fast_i2v
  • kling_2_6_pro_i2v - kling_2_6_pro_i2v
  • kling_3_0_turbo_standard_i2v - kling_3_0_turbo_standard_i2v
  • kling_3_0_turbo_pro_i2v - kling_3_0_turbo_pro_i2v
  • kling_3_0_i2v - kling_3_0_i2v
  • kling_3_0_pro_i2v - kling_3_0_pro_i2v
  • seedance_2_0_i2v - seedance_2_0_i2v
  • seedance_2_0_fast_i2v - seedance_2_0_fast_i2v
  • sora_2_i2v - sora_2_i2v
  • sora_2_pro_i2v - sora_2_pro_i2v
  • veo_3_1_fal_i2v - veo_3_1_fal_i2v
  • veo_3_1_fal_first_last_frame_i2v - veo_3_1_fal_first_last_frame_i2v
  • veo_3_1_fast_generate_preview_v2 - veo_3_1_fast_generate_preview_v2
  • veo_3_1_fast_fal_first_last_frame_i2v - veo_3_1_fast_fal_first_last_frame_i2v
  • veo_3_1_generate_preview - veo_3_1_generate_preview
  • veo_3_1_fast_generate_preview - veo_3_1_fast_generate_preview
  • wan_2_7_i2v - wan_2_7_i2v
Available options:
atlas_ultra_i2v,
atlas_ultra_nsfw_i2v,
gemini_omni_flash_i2v,
grok_imagine_video_1_5_i2v,
grok_imagine_video_i2v,
happy_horse_1_0_i2v,
hexal_standard_i2v,
hexal_standard_nsfw_i2v,
hexal_ultra_i2v,
hexal_ultra_nsfw_i2v,
hexal_fast_i2v,
kling_2_6_pro_i2v,
kling_3_0_turbo_standard_i2v,
kling_3_0_turbo_pro_i2v,
kling_3_0_i2v,
kling_3_0_pro_i2v,
seedance_2_0_i2v,
seedance_2_0_fast_i2v,
sora_2_i2v,
sora_2_pro_i2v,
veo_3_1_fal_i2v,
veo_3_1_fal_first_last_frame_i2v,
veo_3_1_fast_generate_preview_v2,
veo_3_1_fast_fal_first_last_frame_i2v,
veo_3_1_generate_preview,
veo_3_1_fast_generate_preview,
wan_2_7_i2v
requested_resolution
string
required

Requested video resolution (e.g. 480p).

Maximum string length: 20
requested_video_duration
number<double>
required

Requested video duration in seconds.

Required range: x >= 1
model_config
any

Model-specific configuration parameters (temperature, style, quality, etc.).

style_settings
string<uuid>[]

Style presets applied to this job (camera, lighting, generation, etc.)

start_frame
string<uuid> | null

Optional image to use as the starting frame of the video.

last_frame
string<uuid> | null

Optional image to use as the ending frame of the video.