Seedance 1.5 Pro generates video from text or an image and can generate sound together with the picture. The exact selector is doubao-seedance-1-5-pro-251215. Its audio control distinguishes it from the silent Seedance 1.0 profiles: generate_audio=true requests synchronized audio, while false requests a silent video. Use a written scene for a new concept or an image to establish the opening subject and composition.
Describe the visual action and sound as parts of the same scene. Identify the subject, setting, movement and camera, then explain the intended voices, sound effects or background music. A portrait scene might show a person opening their eyes as the camera slowly pulls back, with wind in the environment. For a product scene, connect the sound to the visible event, such as a lid opening or an object touching a surface, instead of adding an unrelated list of effects.
The model can generate voices, effects and background music from the prompt and visual content. The guide recommends putting spoken dialogue inside double quotation marks. Keep speech short enough for the requested action and pauses, and distinguish who speaks when more than one character is involved. Review the actual wording, voice attribution and synchronization with the picture. A sound instruction guides the generated performance; it is not a separate uploaded voice-reference input in this profile's documented request.
Image-to-video uses an image_url item alongside the text. Supply an accessible image URL or a Base64 data URL in JPEG, PNG, WEBP, BMP, TIFF or GIF format. The documented image limits are below 30 MB, both dimensions strictly between 300 and 6000 pixels and a width-to-height ratio strictly between 0.4 and 2.5. Prepare the intended crop and subject clearly, then describe the movement from that composition. The image example uses adaptive ratio to follow the reference.
The profile-specific duration guide lists whole seconds from four to twelve, or -1 for the model to choose a duration within that range. The default duration is five seconds. Seedance 1.5 Pro defaults to 720p and the retained profile table documents 480p and 720p; the dedicated operation guide does not offer 1080p for 1.5 Pro. Fixed ratio choices include 16:9, 4:3, 1:1, 3:4, 9:16 and 21:9, with adaptive as the documented 1.5 default. Inspect the actual clip's duration and proportions rather than treating the requested values as an already returned artifact.
The request exposes two processing tiers. service_tier=default selects online processing, while flex selects offline processing for work that tolerates more delay. The tier cannot be changed after the task is submitted. Choose it for the workflow's timing needs, and retain that selection in the request record. Audio mode and processing tier are separate choices: a silent clip is not automatically an offline job, and enabling audio does not select a processing tier.
Keep the seed, watermark and camera instructions consistent with the scene. Parameter commands embedded in the text take precedence over separate optional parameters. The fixed-camera control is excluded in the reference-image scenario and is not a guaranteed visual lock where it applies. For an image-led animation, explain the intended movement directly rather than assuming a camera control removes the need to describe the shot.
Usage is measured in video tokens: output width × output height × frame rate × output duration / 1024. The completed task reports this quantity as usage.completion_tokens. Retain the reported usage with the finished clip and its requested settings. Audio enabled or disabled and online or flex processing remain distinct categories in the usage-based charge.
Submission returns an asynchronous task identifier. Follow the task until completion, then save the video supplied in content.video_url. The documented generated-file retention is seven days. The expiry control is measured from creation, defaults to 172800 seconds and accepts values from 3600 to 259200 seconds; an unfinished task becomes expired after its configured interval. Keep the final clip, original image and exact visual-and-audio brief together, then review the full result for action, identity, camera continuity and sound alignment.
", "aboutText": "Seedance 1.5 Pro generates video from text or an image and can generate sound together with the picture. The exact selector is doubao-seedance-1-5-pro-251215. Its audio control distinguishes it from the silent Seedance 1.0 profiles: generate_audio=true requests synchronized audio, while false requests a silent video. Use a written scene for a new concept or an image to establish the opening subject and composition.\n\nDescribe the visual action and sound as parts of the same scene. Identify the subject, setting, movement and camera, then explain the intended voices, sound effects or background music. A portrait scene might show a person opening their eyes as the camera slowly pulls back, with wind in the environment. For a product scene, connect the sound to the visible event, such as a lid opening or an object touching a surface, instead of adding an unrelated list of effects.\n\nThe model can generate voices, effects and background music from the prompt and visual content. The guide recommends putting spoken dialogue inside double quotation marks. Keep speech short enough for the requested action and pauses, and distinguish who speaks when more than one character is involved. Review the actual wording, voice attribution and synchronization with the picture. A sound instruction guides the generated performance; it is not a separate uploaded voice-reference input in this profile's documented request.\n\nImage-to-video uses an image_url item alongside the text. Supply an accessible image URL or a Base64 data URL in JPEG, PNG, WEBP, BMP, TIFF or GIF format. The documented image limits are below 30 MB, both dimensions strictly between 300 and 6000 pixels and a width-to-height ratio strictly between 0.4 and 2.5. Prepare the intended crop and subject clearly, then describe the movement from that composition. The image example uses adaptive ratio to follow the reference.\n\nThe profile-specific duration guide lists whole seconds from four to twelve, or -1 for the model to choose a duration within that range. The default duration is five seconds. Seedance 1.5 Pro defaults to 720p and the retained profile table documents 480p and 720p; the dedicated operation guide does not offer 1080p for 1.5 Pro. Fixed ratio choices include 16:9, 4:3, 1:1, 3:4, 9:16 and 21:9, with adaptive as the documented 1.5 default. Inspect the actual clip's duration and proportions rather than treating the requested values as an already returned artifact.\n\nThe request exposes two processing tiers. service_tier=default selects online processing, while flex selects offline processing for work that tolerates more delay. The tier cannot be changed after the task is submitted. Choose it for the workflow's timing needs, and retain that selection in the request record. Audio mode and processing tier are separate choices: a silent clip is not automatically an offline job, and enabling audio does not select a processing tier.\n\nKeep the seed, watermark and camera instructions consistent with the scene. Parameter commands embedded in the text take precedence over separate optional parameters. The fixed-camera control is excluded in the reference-image scenario and is not a guaranteed visual lock where it applies. For an image-led animation, explain the intended movement directly rather than assuming a camera control removes the need to describe the shot.\n\nUsage is measured in video tokens: output width × output height × frame rate × output duration / 1024. The completed task reports this quantity as usage.completion_tokens. Retain the reported usage with the finished clip and its requested settings. Audio enabled or disabled and online or flex processing remain distinct categories in the usage-based charge.\n\nSubmission returns an asynchronous task identifier. Follow the task until completion, then save the video supplied in content.video_url. The documented generated-file retention is seven days. The expiry control is measured from creation, defaults to 172800 seconds and accepts values from 3600 to 259200 seconds; an unfinished task becomes expired after its configured interval. Keep the final clip, original image and exact visual-and-audio brief together, then review the full result for action, identity, camera continuity and sound alignment.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "562d44c992f6ab32e5aaddc8fd673b33b823ebb2518dd55f441e04a45de1e1d0", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "en", "methods": [ { "html": "doubao-seedance-1-5-pro-251215Seedance 1.5 Pro generates video from text or an image and can create synchronized voices, effects and background music. Audio can be enabled or disabled; the documented profile offers 4–12-second scenes, adaptive framing and online or flex processing.
This description covers the model’s capabilities. Available in Ailoot inputs, outputs and options are listed for the selected method below.
Seedance 1.5 Pro generates video from text or an image and can generate sound together with the picture. The exact selector is doubao-seedance-1-5-pro-251215. Its audio control distinguishes it from the silent Seedance 1.0 profiles: generate_audio=true requests synchronized audio, while false requests a silent video. Use a written scene for a new concept or an image to establish the opening subject and composition.
Describe the visual action and sound as parts of the same scene. Identify the subject, setting, movement and camera, then explain the intended voices, sound effects or background music. A portrait scene might show a person opening their eyes as the camera slowly pulls back, with wind in the environment. For a product scene, connect the sound to the visible event, such as a lid opening or an object touching a surface, instead of adding an unrelated list of effects.
The model can generate voices, effects and background music from the prompt and visual content. The guide recommends putting spoken dialogue inside double quotation marks. Keep speech short enough for the requested action and pauses, and distinguish who speaks when more than one character is involved. Review the actual wording, voice attribution and synchronization with the picture. A sound instruction guides the generated performance; it is not a separate uploaded voice-reference input in this profile's documented request.
Image-to-video uses an image_url item alongside the text. Supply an accessible image URL or a Base64 data URL in JPEG, PNG, WEBP, BMP, TIFF or GIF format. The documented image limits are below 30 MB, both dimensions strictly between 300 and 6000 pixels and a width-to-height ratio strictly between 0.4 and 2.5. Prepare the intended crop and subject clearly, then describe the movement from that composition. The image example uses adaptive ratio to follow the reference.
The profile-specific duration guide lists whole seconds from four to twelve, or -1 for the model to choose a duration within that range. The default duration is five seconds. Seedance 1.5 Pro defaults to 720p and the retained profile table documents 480p and 720p; the dedicated operation guide does not offer 1080p for 1.5 Pro. Fixed ratio choices include 16:9, 4:3, 1:1, 3:4, 9:16 and 21:9, with adaptive as the documented 1.5 default. Inspect the actual clip's duration and proportions rather than treating the requested values as an already returned artifact.
The request exposes two processing tiers. service_tier=default selects online processing, while flex selects offline processing for work that tolerates more delay. The tier cannot be changed after the task is submitted. Choose it for the workflow's timing needs, and retain that selection in the request record. Audio mode and processing tier are separate choices: a silent clip is not automatically an offline job, and enabling audio does not select a processing tier.
Keep the seed, watermark and camera instructions consistent with the scene. Parameter commands embedded in the text take precedence over separate optional parameters. The fixed-camera control is excluded in the reference-image scenario and is not a guaranteed visual lock where it applies. For an image-led animation, explain the intended movement directly rather than assuming a camera control removes the need to describe the shot.
Usage is measured in video tokens: output width × output height × frame rate × output duration / 1024. The completed task reports this quantity as usage.completion_tokens. Retain the reported usage with the finished clip and its requested settings. Audio enabled or disabled and online or flex processing remain distinct categories in the usage-based charge.
Submission returns an asynchronous task identifier. Follow the task until completion, then save the video supplied in content.video_url. The documented generated-file retention is seven days. The expiry control is measured from creation, defaults to 172800 seconds and accepts values from 3600 to 259200 seconds; an unfinished task becomes expired after its configured interval. Keep the final clip, original image and exact visual-and-audio brief together, then review the full result for action, identity, camera continuity and sound alignment.
POST /v1/videostext, imagevideo| Field | Type | Requirement | Values & limits | Default |
|---|---|---|---|---|
Fieldmodel | Typestring | RequirementRequired | Values & limits doubao-seedance-1-5-pro-251215 | Default— |
Fieldcontent | Typearray | RequirementRequired | Values & limits Conditions: Native text/media objects; outer array must be non-empty. Nested node types are not validated by this Ailoot generic constructor. | Default— |
Fieldduration | Typeinteger | RequirementOptional | Values & limits Conditions: Primary 1.x schema 2–12; later shared description names 1.5 as 4–12 or -1. Example uses mutually documented 5. | Default5 |
Fieldresolution | Typestring | RequirementOptional | Values & limits 480p, 720p Conditions: Seedance 1.5 Pro supports 480p and 720p; 1080p is excluded. The documented resolution default is 720p. | Default720p |
Fieldratio | Typestring | RequirementOptional | Values & limits 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive Conditions: The documented Seedance 1.5 Pro ratio default is adaptive. Fixed ratio choices remain unchanged. | Defaultadaptive |
Fieldservice_tier | Typestring | RequirementOptional | Values & limits default, flex Conditions: default=online, flex=offline; choose before creation. | Defaultdefault |
Fieldseed | Typeinteger | RequirementRequired | Values & limits Minimum: -1 Maximum: 4,294,967,295 | Default-1 |
Fieldcamerafixed | Typeboolean | RequirementRequired | Values & limits Conditions: Required by Ailoot; reference-image camera control is documented as unsupported and effect is not guaranteed. | Defaultfalse |
Fieldwatermark | Typeboolean | RequirementRequired | Values & limits | Defaultfalse |
Fieldexecution_expires_after | Typeinteger | RequirementRequired | Values & limits Minimum: 3,600 Maximum: 259,200 Unit: seconds | Default172,800 |
Fieldgenerate_audio | Typeboolean | RequirementOptional | Values & limits Conditions: 1.5-only synchronized sound embedded in the generated video. | Defaulttrue |
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractcamerafixed, content, execution_expires_after, model, seed, watermark |
Parameteroptional | Contractduration, resolution, ratio, service_tier, generate_audio |
Parametermaterial_types | Contracttext, image |
Parameteradditional_properties | Contracttrue |
Parametervalidation_scope | ContractAiloot checks the required field types and a non-empty model/content array. Other request fields are preserved for the selected model. |
Parameterimage_constraints | Contract{"formats":["jpeg","png","webp","bmp","tiff","gif"],"aspect_ratio_exclusive":[0.4,2.5],"dimensions_px_exclusive":[300,6000],"file_size_mb_exclusive":30,"mb_bytes_definition":null} |
Method aliases: /v1/videos/generations
Lifecycle: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Create once and retain returned public id/polling_url.
Poll the original job; download actual owned content.video_url after succeeded.
The displayed rates estimate the cost before generation. The final charge is calculated from the cost recorded for the original generation. Measured output duration and forecast quantities are not the final billable quantity.
Tariff references do not add request options. Supported parameters are listed for the selected method.
Match each charge to the conditions shown. Use one rate for each set of alternative configurations.
| Configuration | Rate schedule | Forecast quantity | Generate audio | Service tier | Billing unit | Charge |
|---|---|---|---|---|---|---|
| ConfigurationBase token rates | Rate scheduleBase rate | Forecast quantity— | Generate audio— | Service tier— | Billing unit— | Charge Input · Input tokens · Estimate for comparison only — / 1K tokens Output · Output tokens · Estimate for comparison only — / 1K tokens Input · Cache read · Estimate for comparison only — / 1K tokens Input · Cache write · Estimate for comparison only — / 1K tokens Input · Cache write, 1 hour · Estimate for comparison only — / 1K tokens |
| ConfigurationOffline service tier (flex). Output with synchronized audio. | Rate schedule— | Forecast quantity— | Generate audioWith audio | Service tierflex | Billing unitper 1,000 video tokens | Charge Output · Estimate for comparison only $0.0024 per 1,000 video tokens |
| ConfigurationOffline service tier (flex). Output without synchronized audio. | Rate schedule— | Forecast quantity— | Generate audioWithout audio | Service tierflex | Billing unitper 1,000 video tokens | Charge Output · Estimate for comparison only $0.0012 per 1,000 video tokens |
| ConfigurationOnline service tier (default). Output with synchronized audio. | Rate schedule— | Forecast quantity— | Generate audioWith audio | Service tierdefault | Billing unitper 1,000 video tokens | Charge Output · Estimate for comparison only $0.0048 per 1,000 video tokens |
| ConfigurationOnline service tier (default). Output without synchronized audio. | Rate schedule— | Forecast quantity— | Generate audioWithout audio | Service tierdefault | Billing unitper 1,000 video tokens | Charge Output · Estimate for comparison only $0.0024 per 1,000 video tokens |
| ConfigurationEstimated generation cost | Rate schedule— | Forecast quantityone generation estimate | Generate audio— | Service tier— | Billing unit— | Charge Output · Estimated generation cost · Estimate for comparison only $0.1152 estimate before generation This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot reserves an estimated amount before a request. After the result, it settles the final charge from measured usage. Streaming settlement uses the final usage record. How reservation and settlement work →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncat > request.json <<'JSON_REQUEST'\n{"model":"doubao-seedance-1-5-pro-251215","content":[{"type":"text","text":"女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动"}],"resolution":"480p","ratio":"1:1","duration":5,"service_tier":"default","seed":-1,"camerafixed":false,"watermark":false,"execution_expires_after":172800,"generate_audio":false}\nJSON_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_POLL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote,urljoin,urlsplit\nr=json.loads(Path("result.json").read_text())\ni=r.get("id")\nif not isinstance(i,str) or not i.startswith("native302_"):raise SystemExit("Keep original response/headers/id; do not resubmit creation.")\nu=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))\np=urlsplit(u)\nif p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use actual Ailoot lookup path.")\nPath("poll-url.txt").write_text(u)\nPY_POLL\ncurl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\nset -eu\npython3 - <<'PY_ASSETS'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import urlsplit\nr=json.loads(Path("status.json").read_text())\nif r.get("status")!="succeeded":raise SystemExit("Poll same original job until an owned result is returned.")\nu=r.get("content",{}).get("video_url")\nurls=[u] if isinstance(u,str) else u\nif not isinstance(urls,list) or not urls:raise SystemExit("No completed video URL.")\nfor u in urls:\n if not isinstance(u,str):raise SystemExit("Invalid returned URL.")\n p=urlsplit(u)\n if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/media/assets/") or not p.path.endswith("/content") or not p.query:raise SystemExit("Wait for actual Ailoot-owned signed result.")\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_ASSETS\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" -o "video-${index}.bin"\n index=$((index + 1))\ndone < asset-urls.txt\nNative JSON with public id/polling_url. After publication content.video_url contains Ailoot-owned signed URL(s); before publication selected output URLs are blanked.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentSave every completed video or returned file; retrieve every actual returned asset URL.
Retain every actual URL in content.video_url; index must identify a real returned output.
Preserve original response/headers/id and poll that operation; never resubmit unknown creation.
| Field | Type |
|---|---|
Fieldid | Typestring |
Fieldprovider_task_id | Typestring |
Fieldpolling_url | Typestring |
Fieldstatus | Typestring when supplied |
Fieldcontent.video_url | Typestring|string[] |
Fieldusage | Typeobject when supplied |
| Response | Condition | Next step |
|---|---|---|
Response400 · invalid_request_error | ConditionInvalid JSON/model/required field types or content index. | Next step |
Response401 · authentication_error | ConditionInvalid Ailoot API key. | Next step |
Response404 · not_found_error | ConditionTask/output absent or not owned by same user/API key/group. | Next step |
Response502 · result_pending_check | ConditionOriginal submit/status incomplete; preserve original ID, no resubmit. | Next step |
Response503 · result_pending_check | ConditionOriginal media/route/settlement is being checked; continue original operation. | Next step |
Ailoot Ultra doubao-seedance-1-5-pro-251215
/v1/videos/generations