Pembuatan Video Seedance 2.0 | Dokumentasi 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.

Buat tugas Seedance 2.0 asinkron. Untuk Seedance 2.5, gunakan referensi parameter terpisahnya.

Autentikasi

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Isi

modelstringwajib

seedance-2.0 atau aliasnya seedance-2-0.

promptstring

Prompt video. Wajib untuk pembuatan hanya dari teks; dapat dihilangkan atau dikosongkan jika referensi gambar atau video disediakan. Audio saja bukan masukan yang valid. Item teks dalam metadata.content dibuang; hanya prompt tingkat atas ini yang digunakan.

secondsstringBawaan: 5

String bilangan bulat dari "4" hingga "15". Alias numerik duration juga diterima. Jika keduanya disediakan, nilainya harus sama. Durasi otomatis (-1) tidak didukung.

sizestringBawaan: 720p

Resolusi keluaran: 480p, 720p, 1080p, atau 4k. Bukan rasio aspek. Urutan prioritas resolusi: metadata.resolution, size, lalu resolution.

aspectRatiostringBawaan: 16:9

16:9, 9:16, 1:1, 4:3, 3:4, 21:9, atau adaptive. aspect_ratio dan ratio adalah alias; metadata.ratio diprioritaskan. Gunakan satu alias untuk setiap pengaturan.

metadataobject

Menerima resolution, ratio, content, dan generate_audio. Atur generate_audio ke boolean untuk mengontrol audio yang dihasilkan. generateAudio / generate_audio tingkat atas adalah alias; berikan hanya satu kontrol audio.

imagesstring[]

Bentuk singkat gambar: gambar pertama menjadi bingkai pertama dan gambar kedua menjadi bingkai terakhir. Untuk peran yang tepat, gunakan metadata.content. Alias imageUrls, imageUrl, image_urls, dan image_url yang ada tetap diterima dengan semantik bingkai yang sama.

imageWithRolesobject[]

Gambar dengan url dan role: first_frame, last_frame, atau reference_image. image_with_roles adalah alias. Kedua versi juga menerima metadata.content bertipe.

videoUrlsstring[]

Video referensi. videoUrl, video_urls, dan video_url adalah alias.

audioUrlsstring[]

Audio referensi. audioUrl, audio_urls, dan audio_url adalah alias. Memerlukan referensi gambar atau video dalam permintaan yang sama.

callback_urlstring

URL callback native opsional. Ketersediaan bergantung pada kanal yang dipilih; gunakan GET https://api.apihop.ai/v1/jobs/{jobId} sebagai hasil otoritatif.

Konten Multimodal

Setiap item media metadata.content berisi objek URL bertingkat yang sesuai. URL media dapat menggunakan URL HTTP(S) publik atau pengenal asset:// yang sudah ada.

Jenis	Kolom URL	Peran
`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`

Hingga 9 gambar, 3 video, dan 3 file audio diterima, termasuk bentuk singkat dan konten bertipe. Audio memerlukan gambar atau video. draft_task tidak didukung. Gunakan prompt tingkat atas, bukan item konten type: "text". first_frame_url, last_frame_url, reference_image_urls, reference_video_urls, dan reference_audio_urls tingkat atas adalah bentuk singkat khusus peran. Kolom yang tidak tercantum dalam item konten tidak diteruskan.

Kontrol yang tidak didukung seperti negativePrompt, seed, returnLastFrame, nsfwCheck, tools, webhook, watermark, outputFormat, dan alias snake-case-nya ditolak. width, height, fps, cfgScale, steps, dan style tidak didukung.

Contoh Permintaan

Teks ke 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}
}

Bingkai Pertama dan Terakhir

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"}
    ]
  }
}

Referensi Gambar dan Audio

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"}
    ]
  }
}

Pengiriman dan Hasil

data respons berisi jobId, status, model, dan message. Keberhasilan pengiriman berarti tugas diterima, bukan selesai. Lakukan polling GET https://api.apihop.ai/v1/jobs/{jobId} dengan API Key akun yang sama. Lihat Ambil Tugas Asinkron.

Saat status COMPLETED, baca data.outputResult. Terima url string maupun larik URL dalam setiap objek hasil. Biaya bergantung pada token penyelesaian aktual dan resolusi keluaran; referensi video memilih tarif masukan video, sedangkan referensi gambar/audio saja tidak.