Create video task (Ark-compatible)
Create an asynchronous video generation task through the Volcano Ark-compatible endpoint. One model name covers text-to-video, image-to-video, and omni reference generation.
ark.cn-beijing.volces.com works as-is: point the base URL at https://api.apipod.ai/api/v3, swap in an APIPod API key, and keep the request body unchanged. Authentication uses the same Authorization: Bearer <key> header as Ark.
One model name, every scenario
Unlike the Ark console, you do not pick separate endpoint IDs per capability. All-in-one model IDs such asseedance-2.5 and seedance-2.0-fast cover every scenario: the task type is inferred from the content array — text only is text-to-video, 1–2 frame images are image-to-video, and reference images, videos, or audios are omni reference generation. The three scenarios are mutually exclusive; mixing frame images with reference media is rejected with a 400 error. Un-roled images are frames, so more than two un-roled images are treated as reference images.
Model names
Themodel field accepts all of the following, case-insensitively:
Parameters
Resolution, ratio, duration, seed, generate_audio, camera_fixed, watermark, return_last_frame, andtools: [{"type": "web_search"}] are passed through to the model. Supported values depend on the model; unsupported combinations fail validation exactly like the native /v1/videos/generations endpoint.
A few Ark parameters are accepted but ignored because the platform does not map them: service_tier, priority, execution_expires_after, safety_identifier, output_format, draft, and omni_reference_task_type. The frames parameter is rejected with a 400 error — use duration instead.
Callbacks
Setcallback_url to receive a POST when the task reaches a terminal state. The callback body is a task object identical in shape to the query endpoint response, so the same parsing code handles both. See Webhooks for delivery and retry behavior of the native callback format used by other endpoints.
After creating a task, poll Query video task (Ark-compatible) with the returned id.Authorizations
Use your APIPod API key as a Bearer token in the Authorization header.
Body
Model name. Accepts APIPod public names (seedance-2.5, seedance-2.0, seedance-2.0-fast, seedance-2.0-mini, and lite variants), Volcano native names with a trailing version (doubao-seedance-2-5-260128), and names that already carry a scenario suffix (seedance-2.5-i2v).
"seedance-2.5"
Input content list. Text is the prompt. Images without a role, or with role first_frame/last_frame (max 2), drive image-to-video. Images with role reference_image, videos, and audios drive omni reference generation. Scenarios are mutually exclusive and cannot be mixed.
Video resolution. Supported values depend on the model.
480p, 720p, 1080p, 4k Aspect ratio of the output video.
16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive Video duration in seconds. Use -1 for smart selection where the model supports it.
Random seed. Supported by a subset of models.
Whether to generate synchronized audio. Supported by a subset of models.
Whether to fix the camera. Supported by a subset of models.
Whether to render an AI-generated watermark. Supported by a subset of models.
Whether to also return the last frame as an image.
Webhook URL. On terminal states APIPod POSTs a task object identical in shape to the query endpoint response.
Tool configuration. Only web_search is recognized, for models that support it.