Seedance 2.0 वीडियो जनरेशन | API दस्तावेज़

# Seedance 2.0 Video Generation

Seedance 2.0 text, first/last-frame, multimodal, and audio generation parameters.

POST https://api.apihop.ai/v1/video/seedance

Create an asynchronous Seedance 2.0 job. For Seedance 2.5, use its [separate parameter reference](https://apihop.ai/en/docs/api-reference/BytePlus/seedance-2-5).

## Authentication

```http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## Body

### `model` (string, required)

`seedance-2.0` or its alias `seedance-2-0`.

### `prompt` (string)

Video prompt. Required for text-only generation; may be omitted or blank when image or video references are supplied. Audio alone is not a valid input. Text items inside `metadata.content` are discarded; only this top-level prompt is used.

### `seconds` (string, Default: 5)

Integer string from `"4"` through `"15"`. The numeric `duration` alias is also accepted. If both are supplied, they must agree. Automatic duration (`-1`) is not supported.

### `size` (string, Default: 720p)

Output resolution: `480p`, `720p`, `1080p`, or `4k`. Not an aspect ratio. Resolution precedence: `metadata.resolution`, `size`, then `resolution`.

### `aspectRatio` (string, Default: 16:9)

`16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `21:9`, or `adaptive`. `aspect_ratio` and `ratio` are aliases; `metadata.ratio` takes precedence. Use one alias for each setting.

### `metadata` (object)

Accepts `resolution`, `ratio`, `content`, and `generate_audio`. Set `generate_audio` to a boolean to control generated audio. Top-level `generateAudio` / `generate_audio` are aliases; supply only one audio control.

### `images` (string[])

Image shorthand: the first image is the first frame and the second is the last frame. For precise roles, use `metadata.content`. Existing `imageUrls`, `imageUrl`, `image_urls`, and `image_url` aliases remain accepted with the same frame semantics.

### `imageWithRoles` (object[])

Images with `url` and `role`: `first_frame`, `last_frame`, or `reference_image`. `image_with_roles` is an alias. Both versions also accept typed `metadata.content`.

### `videoUrls` (string[])

Reference videos. `videoUrl`, `video_urls`, and `video_url` are aliases.

### `audioUrls` (string[])

Reference audio. `audioUrl`, `audio_urls`, and `audio_url` are aliases. Requires an image or video reference in the same request.

### `callback_url` (string)

Optional native callback URL. Availability depends on the selected channel; use `GET https://api.apihop.ai/v1/jobs/{jobId}` as the authoritative result.

## Multimodal Content

Each `metadata.content` media item contains its matching nested URL object. Media URLs may use public HTTP(S) URLs or existing `asset://` identifiers.

| Type | URL field | Roles |
| --- | --- | --- |
| `image_url` | `image_url.url` | `first_frame`, `last_frame`, `reference_image` |
| `video_url` | `video_url.url` | `reference_video` |
| `audio_url` | `audio_url.url` | `reference_audio` |

Up to 9 images, 3 videos, and 3 audio files are accepted, including shorthand and typed content. Audio requires an image or video. `draft_task` is not supported. Use top-level `prompt` instead of `type: "text"` content items. Top-level `first_frame_url`, `last_frame_url`, `reference_image_urls`, `reference_video_urls`, and `reference_audio_urls` are role-specific shorthand. Unlisted fields inside content items are not forwarded.

Unsupported controls such as `negativePrompt`, `seed`, `returnLastFrame`, `nsfwCheck`, `tools`, `webhook`, `watermark`, `outputFormat`, and their snake-case aliases are rejected. `width`, `height`, `fps`, `cfgScale`, `steps`, and `style` are not supported.

## Request Examples

### Text-to-Video

```json
{
  "model": "seedance-2.0",
  "prompt": "A quiet city street at dawn, slow forward camera movement",
  "seconds": "5",
  "size": "720p",
  "metadata": {"ratio": "16:9", "generate_audio": true}
}
```

### First and Last Frames

```json
{
  "model": "seedance-2.0",
  "seconds": "5",
  "metadata": {
    "resolution": "720p",
    "ratio": "9:16",
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/first.jpg"}, "role": "first_frame"},
      {"type": "image_url", "image_url": {"url": "https://example.com/last.jpg"}, "role": "last_frame"}
    ]
  }
}
```

### Image and Audio References

```json
{
  "model": "seedance-2.0",
  "prompt": "Animate the scene to match the rhythm",
  "metadata": {
    "resolution": "720p",
    "generate_audio": true,
    "content": [
      {"type": "image_url", "image_url": {"url": "asset://existing-image-id"}, "role": "reference_image"},
      {"type": "audio_url", "audio_url": {"url": "https://example.com/beat.mp3"}, "role": "reference_audio"}
    ]
  }
}
```

## Submission and Result

Response `data` contains `jobId`, `status`, `model`, and `message`. Submission success means the job was accepted, not completed. Poll `GET https://api.apihop.ai/v1/jobs/{jobId}` with the same account's API Key. See [Get Async Job](https://apihop.ai/en/docs/api-reference/jobs).

When status is `COMPLETED`, read `data.outputResult`. Accept both a string `url` and an array of URLs in each result object. Charges depend on actual completion tokens and output resolution; video references select the video-input rate, while image/audio-only references do not.

असिंक्रोनस Seedance 2.0 जॉब बनाएँ। Seedance 2.5 के लिए उसका अलग पैरामीटर संदर्भ लें।

प्रमाणीकरण

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

अनुरोध बॉडी

modelstringआवश्यक

seedance-2.0 या उसका उपनाम seedance-2-0।

promptstring

वीडियो प्रॉम्प्ट। केवल टेक्स्ट जनरेशन में आवश्यक; चित्र या वीडियो संदर्भ हों तो छोड़ा या खाली रखा जा सकता है। केवल ऑडियो वैध इनपुट नहीं है। metadata.content के टेक्स्ट आइटम हटाए जाते हैं; केवल यह शीर्ष-स्तरीय प्रॉम्प्ट इस्तेमाल होता है।

secondsstringडिफ़ॉल्ट: 5

"4" से "15" तक पूर्णांक स्ट्रिंग। संख्यात्मक duration उपनाम भी स्वीकार है। दोनों दिए हों तो समान होने चाहिए। स्वचालित अवधि (-1) समर्थित नहीं है।

sizestringडिफ़ॉल्ट: 720p

आउटपुट रिज़ॉल्यूशन: 480p, 720p, 1080p या 4k। यह पक्षानुपात नहीं है। रिज़ॉल्यूशन प्राथमिकता: metadata.resolution, size, फिर resolution।

aspectRatiostringडिफ़ॉल्ट: 16:9

16:9, 9:16, 1:1, 4:3, 3:4, 21:9 या adaptive। aspect_ratio और ratio उपनाम हैं; metadata.ratio को प्राथमिकता है। हर सेटिंग के लिए एक उपनाम इस्तेमाल करें।

metadataobject

resolution, ratio, content और generate_audio स्वीकार हैं। जनरेट किए ऑडियो को नियंत्रित करने के लिए generate_audio बूलियन दें। शीर्ष-स्तरीय generateAudio / generate_audio उपनाम हैं; केवल एक ऑडियो नियंत्रण दें।

imagesstring[]

चित्र का संक्षिप्त रूप: पहला चित्र पहला फ़्रेम और दूसरा अंतिम फ़्रेम है। सटीक भूमिकाओं के लिए metadata.content लें। मौजूदा imageUrls, imageUrl, image_urls और image_url उपनाम समान फ़्रेम अर्थ के साथ स्वीकार रहते हैं।

imageWithRolesobject[]

url और role वाले चित्र: first_frame, last_frame या reference_image। image_with_roles उपनाम है। दोनों संस्करण प्रकार-निर्धारित metadata.content भी स्वीकार करते हैं।

videoUrlsstring[]

संदर्भ वीडियो। videoUrl, video_urls और video_url उपनाम हैं।

audioUrlsstring[]

संदर्भ ऑडियो। audioUrl, audio_urls और audio_url उपनाम हैं। उसी अनुरोध में चित्र या वीडियो संदर्भ चाहिए।

callback_urlstring

वैकल्पिक मूल callback URL। उपलब्धता चुने चैनल पर निर्भर है; प्रामाणिक परिणाम के लिए GET https://api.apihop.ai/v1/jobs/{jobId} लें।

मल्टीमोडल सामग्री

हर metadata.content मीडिया आइटम में संबंधित नेस्टेड URL ऑब्जेक्ट होता है। मीडिया URL में सार्वजनिक HTTP(S) URL या मौजूदा asset:// पहचान इस्तेमाल कर सकते हैं।

प्रकार	URL फ़ील्ड	भूमिकाएँ
`image_url`	`image_url.url`	`first_frame`, `last_frame`, `reference_image`
`video_url`	`video_url.url`	`reference_video`
`audio_url`	`audio_url.url`	`reference_audio`

संक्षिप्त और प्रकार-निर्धारित सामग्री मिलाकर अधिकतम 9 चित्र, 3 वीडियो और 3 ऑडियो फ़ाइल स्वीकार हैं। ऑडियो के साथ चित्र या वीडियो चाहिए। draft_task समर्थित नहीं। type: "text" सामग्री आइटम के बजाय शीर्ष-स्तरीय prompt लें। शीर्ष-स्तरीय first_frame_url, last_frame_url, reference_image_urls, reference_video_urls और reference_audio_urls भूमिका-विशिष्ट संक्षिप्त रूप हैं। सामग्री आइटम के सूची से बाहर फ़ील्ड आगे नहीं भेजे जाते।

negativePrompt, seed, returnLastFrame, nsfwCheck, tools, webhook, watermark, outputFormat जैसे असमर्थित नियंत्रण और उनके snake-case उपनाम अस्वीकार होते हैं। width, height, fps, cfgScale, steps और style समर्थित नहीं हैं।

अनुरोध उदाहरण

टेक्स्ट से वीडियो

json

{
  "model": "seedance-2.0",
  "prompt": "A quiet city street at dawn, slow forward camera movement",
  "seconds": "5",
  "size": "720p",
  "metadata": {"ratio": "16:9", "generate_audio": true}
}

पहला और अंतिम फ़्रेम

json

{
  "model": "seedance-2.0",
  "seconds": "5",
  "metadata": {
    "resolution": "720p",
    "ratio": "9:16",
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/first.jpg"}, "role": "first_frame"},
      {"type": "image_url", "image_url": {"url": "https://example.com/last.jpg"}, "role": "last_frame"}
    ]
  }
}

चित्र और ऑडियो संदर्भ

json

{
  "model": "seedance-2.0",
  "prompt": "Animate the scene to match the rhythm",
  "metadata": {
    "resolution": "720p",
    "generate_audio": true,
    "content": [
      {"type": "image_url", "image_url": {"url": "asset://existing-image-id"}, "role": "reference_image"},
      {"type": "audio_url", "audio_url": {"url": "https://example.com/beat.mp3"}, "role": "reference_audio"}
    ]
  }
}

सबमिशन और परिणाम

उत्तर के data में jobId, status, model और message हैं। सफल सबमिशन का अर्थ जॉब स्वीकार हुआ, पूरा नहीं। उसी खाते की API कुंजी से GET https://api.apihop.ai/v1/jobs/{jobId} पोल करें। असिंक्रोनस जॉब प्राप्त करें देखें।

स्थिति COMPLETED हो तो data.outputResult पढ़ें। हर परिणाम ऑब्जेक्ट में स्ट्रिंग url और URL ऐरे, दोनों स्वीकार करें। शुल्क वास्तविक completion टोकन और आउटपुट रिज़ॉल्यूशन पर निर्भर हैं; वीडियो संदर्भ वीडियो-इनपुट दर चुनते हैं, जबकि केवल चित्र/ऑडियो संदर्भ ऐसा नहीं करते।