> ## Documentation Index > Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt > Use this file to discover all available pages before exploring further. # Ein Seedance-Video erstellen > Erstellen Sie eine Seedance-Videoaufgabe auf CometAPI. Seedance 2.0 unterstützt exakte WxH-Werte bis zu 4K für Text-zu-Video- und Referenzbild-Generierung. Wählen Sie aus der folgenden Tabelle einen dokumentierten `WxH`-Wert für das Feld `size` aus. ## Referenzbilder verwenden Nur die Seedance-2.0-Modelle akzeptieren `input_reference`. Fügen Sie eine `input_reference`-Datei für bildgestützte Generierung hinzu. Wiederholen Sie für erweiterte Prompts mit mehreren Referenzen dasselbe Multipart-Feld in der Upload-Reihenfolge. Seedance 2.0 reagiert empfindlich darauf, wie der Prompt jedes Referenzbild mit der Szene verknüpft. Verweisen Sie in der Reihenfolge auf die hochgeladenen Dateien, etwa `[Image 1]`, `[Image 2]` und `[Image 3]`, und weisen Sie jedem Bild eine klare Rolle zu: * Verwenden Sie `[Image 1]` für das Hauptmotiv, die Hauptfigur oder das Hauptprodukt. * Verwenden Sie `[Image 2]` für ein sekundäres Motiv, eine Requisite oder einen Begleiter. * Verwenden Sie `[Image 3]` für den Hintergrund, die Umgebung, die Beleuchtung oder den Stil. Beschreiben Sie, was erkennbar bleiben soll, was sich ändern kann, die Handlung, die Kamerabewegung, den visuellen Stil und die Szene. Ein vager Prompt kann dazu führen, dass das generierte Video so aussieht, als wäre das Referenzbild nicht verwendet worden, selbst wenn der Upload akzeptiert wurde. Diese Prompt-Struktur ist zuverlässiger, als nur Bilder aufzulisten: ```text theme={null} Use the uploaded images in order: keep the boy wearing glasses and a blue T-shirt from [Image 1], add the corgi puppy from [Image 2], and use the lawn from [Image 3] as the setting. Create a 4-second 3D cartoon video with the boy and puppy sitting together, a slow camera push-in, soft daylight, and no extra characters. ``` ## Dauer nach Modell Wenn Sie `seconds` weglassen, fordert CometAPI einen 5-sekündigen Clip an. Senden Sie `seconds` als String, wenn Sie eine bestimmte Dauer benötigen. | Modellfamilie | Unterstützt `seconds` | Standard | Grenzverhalten | | ---------------------------------- | --------------------- | -------- | ------------------------------------------------------------- | | Seedance 2.0 und Seedance 2.0 Fast | `4`-`15` | `5` | Verwenden Sie ganzzahlige Sekunden innerhalb dieses Bereichs. | | Seedance 1.5 Pro | `4`-`12` | `5` | Verwenden Sie ganzzahlige Sekunden innerhalb dieses Bereichs. | | Seedance 1.0 Pro | `2`-`10` | `5` | Verwenden Sie ganzzahlige Sekunden innerhalb dieses Bereichs。 | ## Größenunterstützung nach Modell Die folgende Tabelle folgt der offiziellen Seedance-Auflösungszuordnung und fasst die veröffentlichten Größenwerte an einer Stelle zusammen. Für `1080p` enthält die Spalte ganz rechts die dokumentierten Werte für `Seedance 1.5 Pro` und `Seedance 2.0`. `Seedance 2.0 Fast` ist in dieser offiziellen Tabelle für `1080p` nicht aufgeführt. Die Einträge für `4K` gelten nur für `doubao-seedance-2-0`. Sie können sie für Text-zu-Video- oder Bild-zu-Video-Anfragen verwenden, die `input_reference` enthalten. Sie gelten nicht für `doubao-seedance-2-0-fast`. Übergeben Sie den genau in der Tabelle angegebenen Wert für `WxH`. | Auflösungsklasse | Seitenverhältnis | Pixelwerte für die Seedance-1.0-Serie | Pixelwerte für Seedance 1.5 Pro / Seedance 2.0 / Seedance 2.0 Fast | | ---------------- | ---------------- | ------------------------------------- | ------------------------------------------------------------------ | | `480p` | `16:9` | `864x480` | `864x496` | | | `4:3` | `736x544` | `752x560` | | | `1:1` | `640x640` | `640x640` | | | `3:4` | `544x736` | `560x752` | | | `9:16` | `480x864` | `496x864` | | | `21:9` | `960x416` | `992x432` | | `720p` | `16:9` | `1248x704` | `1280x720` | | | `4:3` | `1120x832` | `1112x834` | | | `1:1` | `960x960` | `960x960` | | | `3:4` | `832x1120` | `834x1112` | | | `9:16` | `704x1248` | `720x1280` | | | `21:9` | `1504x640` | `1470x630` | | `1080p` | `16:9` | `1920x1088` | `1920x1080` | | | `4:3` | `1664x1248` | `1664x1248` | | | `1:1` | `1440x1440` | `1440x1440` | | | `3:4` | `1248x1664` | `1248x1664` | | | `9:16` | `1088x1920` | `1080x1920` | | | `21:9` | `2176x928` | `2206x946` | | `4K` | `16:9` | — | `3840x2160` (Nur Seedance 2.0) | | | `4:3` | — | `3326x2494` (Nur Seedance 2.0) | | | `1:1` | — | `2880x2880` (Nur Seedance 2.0) | | | `3:4` | — | `2494x3326` (Nur Seedance 2.0) | | | `9:16` | — | `2160x3840` (Nur Seedance 2.0) | | | `21:9` | — | `4398x1886` (Nur Seedance 2.0) | Wählen Sie für das Zielmodell den dokumentierten Wert `WxH`. Die Unterstützung exakter `WxH`-Werte bleibt modellabhängig. Prüfen Sie daher die fertiggestellten Medien, bevor Sie sich auf eine nicht dokumentierte Größe verlassen. ## OpenAPI ````yaml api/openapi/video/seedance/post-seedance-create.openapi.json POST /v1/videos openapi: 3.1.0 info: title: Seedance Video Generation API version: 1.0.0 description: >- Create an asynchronous ByteDance Seedance video task through CometAPI. Seedance 2.0 models also accept one or more input_reference image files; for multiple files, repeat the same multipart field and bind each image in the prompt as [Image 1], [Image 2], and so on. Set size to an exact WxH value such as 1280x720. The standard doubao-seedance-2-0 model accepts these exact 4K sizes for text-to-video and reference-image generation: 3840x2160, 3326x2494, 2880x2880, 2494x3326, 2160x3840, and 4398x1886. These 4K sizes do not apply to doubao-seedance-2-0-fast. Save the returned id and poll GET /v1/videos/{id} until the status reaches completed. servers: - url: https://api.cometapi.com security: - bearerAuth: [] paths: /v1/videos: post: summary: Create a Seedance video task description: >- Submit a text-to-video or image-to-video job for any Seedance model family. The request body is multipart/form-data so that optional input_reference images can be uploaded in the same call. Set size to an exact WxH value. The standard doubao-seedance-2-0 model accepts these six exact 4K sizes for text-to-video and reference-image generation: 3840x2160, 3326x2494, 2880x2880, 2494x3326, 2160x3840, and 4398x1886. These 4K sizes do not apply to doubao-seedance-2-0-fast. Image-to-video is supported only by the Seedance 2.0 models (doubao-seedance-2-0, doubao-seedance-2-0-fast); the 1.0 Pro and 1.5 Pro models accept text prompts only. For multiple reference images, repeat input_reference in upload order and describe each image's role in the prompt with labels such as [Image 1], [Image 2], and [Image 3]. The endpoint returns immediately with a task id; use GET /v1/videos/{id} to read the final result. operationId: seedance_create_video requestBody: required: true content: multipart/form-data: schema: type: object required: - prompt - model properties: prompt: type: string description: >- Text prompt that describes the video. Required. When using reference images, describe what each uploaded image should control, such as the subject from [Image 1], the secondary object from [Image 2], and the background or style from [Image 3]. Also state the action, camera motion, visual style, and scene. example: >- A slow cinematic camera push across a coastal landscape at sunrise. model: type: string description: >- Seedance model id. Only the two 2.0 models accept input_reference. enum: - doubao-seedance-2-0 - doubao-seedance-2-0-fast - doubao-seedance-1-5-pro - doubao-seedance-1-0-pro example: doubao-seedance-2-0 seconds: type: integer description: >- Video duration in seconds. The accepted range depends on the model: doubao-seedance-2-0 and doubao-seedance-2-0-fast accept 4 to 15, doubao-seedance-1-5-pro accepts 4 to 12, and doubao-seedance-1-0-pro accepts 2 to 10. The default is 5 for every model. minimum: 2 maximum: 15 default: 5 example: 5 size: type: string description: >- Output size as an exact WxH value, such as 1280x720. For doubao-seedance-2-0 4K output, use 3840x2160, 3326x2494, 2880x2880, 2494x3326, 2160x3840, or 4398x1886. These 4K values work for text-to-video and requests with input_reference, but they do not apply to doubao-seedance-2-0-fast. Exact WxH support remains model-dependent, and an undocumented value can normalize to another size or fail. pattern: ^[1-9]\d{2,3}x[1-9]\d{2,3}$ examples: - 1280x720 - 1920x1080 - 3840x2160 - 3326x2494 - 2880x2880 - 2494x3326 - 2160x3840 - 4398x1886 - 1112x834 - 960x960 - 834x1112 - 720x1280 - 1080x1920 - 1470x630 example: 1280x720 input_reference: type: string format: binary description: >- Optional reference image uploaded as a multipart file. Repeat this field to send multiple reference images; the order of repeated fields is the order you should reference in the prompt as [Image 1], [Image 2], and so on. Use JPEG or PNG files for best compatibility. Only doubao-seedance-2-0 and doubao-seedance-2-0-fast accept this field; sending it with a 1.0 Pro or 1.5 Pro model returns HTTP 400. encoding: input_reference: contentType: image/jpeg, image/png, image/webp examples: seedance_2_0_4k_text_to_video: summary: Seedance 2.0 4K text-to-video value: prompt: >- A slow cinematic camera push across a coastal landscape at sunrise. model: doubao-seedance-2-0 seconds: 4 size: 3840x2160 responses: '200': description: Task created. Save the returned id and poll GET /v1/videos/{id}. content: application/json: schema: $ref: '#/components/schemas/CreateVideoResponse' example: id: task_abc123 task_id: task_abc123 object: video model: doubao-seedance-2-0 status: queued progress: 0 created_at: 1776681149 '400': description: >- The request is missing a required field or contains an out-of-range value. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missing_prompt: summary: prompt field missing value: code: invalid_request message: prompt is required missing_model: summary: model field missing value: error: code: '' message: model name is required type: comet_api_error invalid_duration: summary: seconds outside the per-model range value: code: InvalidParameter message: >- the parameter duration specified in the request is not valid i2v_not_supported: summary: input_reference sent with a 1.0 Pro or 1.5 Pro model value: code: InvalidParameter message: >- The parameter task_type specified in the request is not valid: the specified task_type r2v does not support model seedance-1-5-pro '401': description: The API key is missing or invalid. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalid_token: summary: Bearer token rejected value: error: code: '' message: invalid token type: comet_api_error x-codeSamples: - lang: Shell label: Text-to-video 4K (Seedance 2.0, exact 3840x2160) source: |- curl https://api.cometapi.com/v1/videos \ -H "Authorization: Bearer $COMETAPI_KEY" \ -F 'prompt="A slow cinematic camera push across a coastal landscape at sunrise"' \ -F 'model="doubao-seedance-2-0"' \ -F 'seconds="4"' \ -F 'size="3840x2160"' - lang: Python label: Text-to-video 4K (Seedance 2.0, exact 3840x2160) source: | import os import requests response = requests.post( "https://api.cometapi.com/v1/videos", headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}, data={ "prompt": "A slow cinematic camera push across a coastal landscape at sunrise", "model": "doubao-seedance-2-0", "seconds": "4", "size": "3840x2160", }, timeout=30, ) response.raise_for_status() print(response.json()) - lang: JavaScript label: Text-to-video 4K (Seedance 2.0, exact 3840x2160) source: > const form = new FormData(); form.append("prompt", "A slow cinematic camera push across a coastal landscape at sunrise"); form.append("model", "doubao-seedance-2-0"); form.append("seconds", "4"); form.append("size", "3840x2160"); const response = await fetch("https://api.cometapi.com/v1/videos", { method: "POST", headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` }, body: form, }); const result = await response.json(); console.log(result); - lang: Shell label: Single reference image (Seedance 2.0) source: |- curl https://api.cometapi.com/v1/videos \ -H "Authorization: Bearer $COMETAPI_KEY" \ -F 'prompt="Use [Image 1] as the main visual reference. Preserve the subject identity, clothing colors, and overall composition from [Image 1]. Create a 4-second video with a gentle camera push-in, subtle natural motion, warm daylight, and a realistic cinematic style."' \ -F 'model="doubao-seedance-2-0"' \ -F 'seconds="4"' \ -F 'size="720x1280"' \ -F 'input_reference=@"/path/to/reference.png"' - lang: Python label: Single reference image (Seedance 2.0) source: > import os import requests prompt = "Use [Image 1] as the main visual reference. Preserve the subject identity, clothing colors, and overall composition from [Image 1]. Create a 4-second video with a gentle camera push-in, subtle natural motion, warm daylight, and a realistic cinematic style." with open("/path/to/reference.png", "rb") as image: response = requests.post( "https://api.cometapi.com/v1/videos", headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}, data={ "prompt": prompt, "model": "doubao-seedance-2-0", "seconds": "4", "size": "720x1280", }, files=[("input_reference", ("reference.png", image, "image/png"))], timeout=30, ) response.raise_for_status() print(response.json()) - lang: JavaScript label: Single reference image (Seedance 2.0) source: > import { readFile } from "node:fs/promises"; const prompt = "Use [Image 1] as the main visual reference. Preserve the subject identity, clothing colors, and overall composition from [Image 1]. Create a 4-second video with a gentle camera push-in, subtle natural motion, warm daylight, and a realistic cinematic style."; const image = await readFile("/path/to/reference.png"); const form = new FormData(); form.append("prompt", prompt); form.append("model", "doubao-seedance-2-0"); form.append("seconds", "4"); form.append("size", "720x1280"); form.append("input_reference", new Blob([image], { type: "image/png" }), "reference.png"); const response = await fetch("https://api.cometapi.com/v1/videos", { method: "POST", headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` }, body: form, }); const result = await response.json(); console.log(result); - lang: Shell label: Multiple reference images (Seedance 2.0) source: |- curl https://api.cometapi.com/v1/videos \ -H "Authorization: Bearer $COMETAPI_KEY" \ -F 'prompt="Use the uploaded images in order: keep the boy wearing glasses and a blue T-shirt from [Image 1], add the corgi puppy from [Image 2], and use the lawn from [Image 3] as the setting. Create a 4-second 3D cartoon video with the boy and puppy sitting together, a slow camera push-in, soft daylight, and no extra characters."' \ -F 'model="doubao-seedance-2-0"' \ -F 'seconds="4"' \ -F 'size="720x1280"' \ -F 'input_reference=@"/path/to/seelite_ref_1.png"' \ -F 'input_reference=@"/path/to/seelite_ref_2.png"' \ -F 'input_reference=@"/path/to/seelite_ref_3.png"' - lang: Python label: Multiple reference images (Seedance 2.0) source: > import os import requests prompt = "Use the uploaded images in order: keep the boy wearing glasses and a blue T-shirt from [Image 1], add the corgi puppy from [Image 2], and use the lawn from [Image 3] as the setting. Create a 4-second 3D cartoon video with the boy and puppy sitting together, a slow camera push-in, soft daylight, and no extra characters." with open("/path/to/seelite_ref_1.png", "rb") as image_1, open("/path/to/seelite_ref_2.png", "rb") as image_2, open("/path/to/seelite_ref_3.png", "rb") as image_3: response = requests.post( "https://api.cometapi.com/v1/videos", headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}, data={ "prompt": prompt, "model": "doubao-seedance-2-0", "seconds": "4", "size": "720x1280", }, files=[ ("input_reference", ("seelite_ref_1.png", image_1, "image/png")), ("input_reference", ("seelite_ref_2.png", image_2, "image/png")), ("input_reference", ("seelite_ref_3.png", image_3, "image/png")), ], timeout=30, ) response.raise_for_status() print(response.json()) - lang: JavaScript label: Multiple reference images (Seedance 2.0) source: > import { readFile } from "node:fs/promises"; const prompt = "Use the uploaded images in order: keep the boy wearing glasses and a blue T-shirt from [Image 1], add the corgi puppy from [Image 2], and use the lawn from [Image 3] as the setting. Create a 4-second 3D cartoon video with the boy and puppy sitting together, a slow camera push-in, soft daylight, and no extra characters."; const image1 = await readFile("/path/to/seelite_ref_1.png"); const image2 = await readFile("/path/to/seelite_ref_2.png"); const image3 = await readFile("/path/to/seelite_ref_3.png"); const form = new FormData(); form.append("prompt", prompt); form.append("model", "doubao-seedance-2-0"); form.append("seconds", "4"); form.append("size", "720x1280"); form.append("input_reference", new Blob([image1], { type: "image/png" }), "seelite_ref_1.png"); form.append("input_reference", new Blob([image2], { type: "image/png" }), "seelite_ref_2.png"); form.append("input_reference", new Blob([image3], { type: "image/png" }), "seelite_ref_3.png"); const response = await fetch("https://api.cometapi.com/v1/videos", { method: "POST", headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` }, body: form, }); const result = await response.json(); console.log(result); - lang: Shell label: Text-to-video (exact 1920x1080) source: |- curl https://api.cometapi.com/v1/videos \ -H "Authorization: Bearer $COMETAPI_KEY" \ -F 'prompt="A slow cinematic camera push across a coastal landscape at sunrise"' \ -F 'model="doubao-seedance-1-5-pro"' \ -F 'seconds="4"' \ -F 'size="1920x1080"' - lang: Python label: Text-to-video (exact 1920x1080) source: | import os import requests response = requests.post( "https://api.cometapi.com/v1/videos", headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}, data={ "prompt": "A slow cinematic camera push across a coastal landscape at sunrise", "model": "doubao-seedance-2-0", "seconds": "4", "size": "1920x1080", }, timeout=30, ) response.raise_for_status() print(response.json()) - lang: JavaScript label: Text-to-video (exact 1920x1080) source: > const form = new FormData(); form.append("prompt", "A slow cinematic camera push across a coastal landscape at sunrise"); form.append("model", "doubao-seedance-1-5-pro"); form.append("seconds", "4"); form.append("size", "1920x1080"); const response = await fetch("https://api.cometapi.com/v1/videos", { method: "POST", headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` }, body: form, }); const result = await response.json(); console.log(result); components: schemas: CreateVideoResponse: type: object required: - id - object - model - status - progress - created_at properties: id: type: string description: Task id. Use it as the path parameter for GET /v1/videos/{id}. task_id: type: string description: Alias of id returned for compatibility. The value matches id. object: type: string description: Object type, always video. model: type: string description: Echo of the requested model id. status: type: string description: Initial task status. Newly created tasks are returned as queued. enum: - queued - in_progress - completed - failed - error progress: type: integer minimum: 0 maximum: 100 description: Completion percentage. 0 at creation. created_at: type: integer description: Task creation time as a Unix timestamp in seconds. additionalProperties: true ErrorResponse: description: >- Error body. The endpoint returns one of two shapes depending on where the validation fails. oneOf: - type: object properties: code: type: - string - 'null' description: Short error code such as invalid_request or InvalidParameter. message: type: string description: Human-readable error message. required: - message additionalProperties: true - type: object properties: error: type: object properties: code: type: - string - 'null' message: type: string type: type: string description: Error category, for example comet_api_error. required: - message - type additionalProperties: true required: - error additionalProperties: true securitySchemes: bearerAuth: type: http scheme: bearer description: Bearer token authentication. Use your CometAPI key. ````