> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Pembuatan Video Seedance 2.5 Flash

> Buat video 480p / 720p hingga 30 detik melalui teks, referensi multimodal, pengeditan, perpanjangan, atau frame awal dan akhir.

```bash cURL theme={null}
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "seedance-2-5-flash",
  "prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
  "resolution": "720p",
  "size": "16:9",
  "duration": 8,
  "generate_audio": true,
  "nsfw_check": true,
  "return_last_frame": true
}'
```

```python Python theme={null}
import requests

payload = {
  "model": "seedance-2-5-flash",
  "prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
  "resolution": "720p",
  "size": "16:9",
  "duration": 8,
  "generate_audio": True,
  "nsfw_check": True,
  "return_last_frame": True
}
response = requests.post(
    "https://api.apimart.ai/v1/videos/generations",
    headers={"Authorization": "Bearer <token>"},
    json=payload,
    timeout=60,
)
response.raise_for_status()
print(response.json())
```

```javascript JavaScript theme={null}
const payload = {
  "model": "seedance-2-5-flash",
  "prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
  "resolution": "720p",
  "size": "16:9",
  "duration": 8,
  "generate_audio": true,
  "nsfw_check": true,
  "return_last_frame": true
};
const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify(payload)
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
```

```json 200 theme={null}
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_example_seedance25flash"
    }
  ]
}
```

Kirim melalui `POST /v1/videos/generations`, baca `data[0].task_id`, lalu periksa `GET /v1/tasks/{task_id}`.

**Authorization** `string` *required*

Gunakan `Authorization: Bearer <token>`, dengan `<token>` sebagai API key APIMart Anda.

## Parameter permintaan

**model** `string` *required*

Gunakan `seedance-2-5-flash`. Alias `doubao-seedance-2-5-flash` juga diterima. Nama bertitik `seedance-2.5-flash` tidak didukung.

**nsfw\_check** `boolean` (default: false)

Menentukan apakah moderasi konten dijalankan sebelum tugas video dikirim.

* `true`: periksa prompt dan gambar input dengan `omni-moderation-latest`
* `false` atau dihilangkan: tidak mengirim permintaan moderasi, tanpa biaya atau latensi moderasi tambahan (default)

Konten terdeteksi menghasilkan HTTP 400 (`nsfw_content_detected`) tanpa membuat tugas atau biaya generasi. Video dan audio referensi tidak diperiksa. Permintaan dapat berlanjut jika layanan moderasi gagal.

**prompt** `string` *required*

Prompt wajib. Rujuk media menggunakan `@图片1` / `@视频1` / `@音频1`; indeks mulai dari 1 sesuai urutan masing-masing array media.

**resolution** `string` (default: 720p)

Hanya `480p` / `720p`, default `720p`. `1080p`, `2k`, `4k`, atau nilai lain menghasilkan HTTP 400 saat pengiriman.

**size** `string` (default: adaptive)

Mendukung `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `adaptive` (default). Alias: `aspect_ratio`. Tugas frame awal/akhir, edit, dan extend wajib memakai `adaptive`.

**duration** `integer`

Detik bulat `4`–`30`; permintaan biasa memakai `5` jika dihilangkan. `-1` berarti otomatis. `edit` eksplisit hanya menerima `-1` atau dihilangkan, yang diperlakukan sebagai `-1`; durasi mengikuti video sumber. Durasi otomatis mencadangkan 30 detik lalu dihitung berdasarkan token aktual.

**generate\_audio** `boolean` (default: true)

Buat suara, default `true`. Alias: `audio`. Mengatur suara keluaran, terpisah dari input referensi `audio_urls`.

**watermark** `boolean` (default: false)

Tambahkan watermark buatan AI, default `false`.

**seed** `integer`

Seed acak opsional. Seed yang sama tidak menjamin hasil identik.

**output\_format** `string` (default: mp4)

Kontainer keluaran: `mp4` (default) atau `mov`.

**omni\_reference\_task\_type** `string` (default: auto)

`auto` (default), `reference`, `edit`, atau `extend`, hanya untuk tugas dengan media referensi. Jenis eksplisit memicu validasi saat pengiriman sesuai tabel di bawah.

**image\_urls** `string[]`

Array gambar referensi, semuanya sebagai `reference_image`. Maksimal 10 gambar digabung dengan `image_with_roles`. Gunakan `image_with_roles` untuk frame awal/akhir.

**image\_with\_roles** `object[]`

Setiap item memuat `url` dan `role`. Peran: `reference_image`, `first_frame` (maksimal 1), `last_frame` (maksimal 1, bersama frame awal). Total maksimal 10 bersama `image_urls`; hindari peran yang bertentangan. Jika ada `video_urls` / `audio_urls`, frame awal/akhir menjadi gambar referensi multimodal.

**video\_urls** `string[]`

Maksimal 5 video, masing-masing 2–30 detik, total maksimal 30 detik. Video sumber untuk edit harus berdurasi 4–30 detik.

**audio\_urls** `string[]`

Maksimal 5 audio, masing-masing 2–30 detik, total maksimal 30 detik. Referensi hanya audio didukung, tanpa harus menyertakan gambar atau video.

**return\_last\_frame** `boolean` (default: false)

Jika `true`, gambar frame terakhir dikembalikan setelah berhasil di `data.result.videos[].last_frame_url`.

**web\_search** `boolean` (default: false)

Izinkan model mencari di web jika diperlukan, default `false`.

**tools** `object[]`

Daftar alat opsional, misalnya `[{"type":"web_search"}]` untuk pencarian web.

> [!WARNING]
>
> `draft` / `draft_task_id` tidak didukung; hapus dari permintaan agar tidak mendapat HTTP 400. Gunakan [Seedance 2.5](https://docs.apimart.ai/id/api-reference/videos/seedance-2-5/generation.md) untuk mode draf.

## Persyaratan media

Gunakan URL `http(s)` yang dapat diakses publik atau ID `asset://` yang sudah disetujui. Resolusi keluaran dan batas piksel video input diperiksa secara terpisah.

| Media | Batas |
| - | - |
| Gambar | Total ≤10 pada kedua field gambar; JPEG / PNG / WebP / BMP / TIFF / GIF / HEIC / HEIF; lebar dan tinggi masing-masing 300–6000 px; rasio 0.4–2.5; masing-masing `<30 MB`. |
| Video | ≤5; MP4 / MOV, video H.264 / H.265 dan audio AAC / MP3; masing-masing 2–30 detik, total ≤30 detik; masing-masing ≤200 MB; lebar dan tinggi 300–6000 px, rasio 0.4–2.5, lebar × tinggi 409,600–8,295,044 piksel, 24–60 FPS. |
| Audio | ≤5; WAV / MP3; masing-masing 2–30 detik, total ≤30 detik; masing-masing ≤15 MB. |

## Jenis tugas dan batasan

| Mode | Penggunaan dan batasan |
| - | - |
| Teks ke video | Isi `prompt` tanpa media referensi; hilangkan `omni_reference_task_type`. |
| Referensi ke video | Sertakan media referensi; `reference` opsional. Batas durasi dan rasio normal tetap berlaku. |
| Frame awal/akhir | Gunakan `image_with_roles`; `size` / `aspect_ratio` harus `adaptive`. |
| Edit video | `edit`; minimal 1 video sumber berdurasi 4–30 detik; rasio `adaptive`, `duration` hanya `-1` atau dihilangkan. |
| Perpanjang video | `extend`; minimal 1 video referensi; rasio `adaptive`. |

Pelanggaran batas jenis eksplisit menghasilkan HTTP 400 sebelum tugas dibuat atau biaya dikenakan. Dengan `auto`, model menentukan jenis dari media dan prompt sehingga dapat gagal saat generasi. Jenis eksplisit pun dapat mengalami `InvalidParameter.TaskTypeMismatch` jika bertentangan dengan prompt.

## Contoh permintaan

### Referensi multimodal

```json theme={null}
{
  "model": "seedance-2-5-flash",
  "prompt": "Use the composition of @视频1, the subject in @图片1, and @音频1 as background music",
  "image_urls": [
    "https://example.com/reference.jpg"
  ],
  "video_urls": [
    "https://example.com/reference_8s.mp4"
  ],
  "audio_urls": [
    "https://example.com/music_5s.mp3"
  ],
  "omni_reference_task_type": "reference",
  "duration": 8,
  "size": "16:9"
}
```

### Frame awal dan akhir

```json theme={null}
{
  "model": "seedance-2-5-flash",
  "prompt": "Smoothly transition from the first frame to the last frame",
  "image_with_roles": [
    {
      "url": "https://example.com/first.jpg",
      "role": "first_frame"
    },
    {
      "url": "https://example.com/last.jpg",
      "role": "last_frame"
    }
  ],
  "size": "adaptive",
  "duration": 5
}
```

### Edit video

```json theme={null}
{
  "model": "seedance-2-5-flash",
  "prompt": "Edit @视频1: replace the cloudy sky with a clear sunset while preserving the camera movement",
  "video_urls": [
    "https://example.com/source_10s.mp4"
  ],
  "omni_reference_task_type": "edit",
  "size": "adaptive",
  "duration": -1,
  "output_format": "mov"
}
```

### Perpanjang video

```json theme={null}
{
  "model": "seedance-2-5-flash",
  "prompt": "Extend @视频1 forward: continue the camera movement as the subject walks into the forest",
  "video_urls": [
    "https://example.com/source_10s.mp4"
  ],
  "omni_reference_task_type": "extend",
  "size": "adaptive",
  "duration": 5
}
```

## Aset privat

Gambar atau video yang berisi wajah orang nyata harus disetujui di pustaka aset sebelum memakai `asset://`. Saat mengunggah, isi juga `model` dengan `seedance-2-5-flash`. Lihat [API pustaka aset](https://docs.apimart.ai/id/api-reference/videos/seedance-2-0/private-avatar.md) dan gunakan nama Flash pada contoh berikut.

```bash theme={null}
curl --request POST \
  --url https://api.apimart.ai/v1/seedance2/private-avatar/assets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "seedance-2-5-flash",
  "group": {
    "name": "flash-assets"
  },
  "asset_type": "Image",
  "assets": [
    {
      "url": "https://example.com/reference.jpg",
      "name": "reference"
    }
  ]
}'
```

Periksa tugas peninjauan aset melalui API tugas terpadu. Setelah disetujui, ambil ID `asset://` dari daftar aset lalu pakai pada `image_urls`, `image_with_roles[].url`, `video_urls`, atau `audio_urls`.

## Status dan hasil tugas

Lakukan polling [API status tugas](https://docs.apimart.ai/id/api-reference/tasks/status.md). `pending` / `processing` berarti berjalan, `completed` berhasil, `failed` gagal. Baca `data.result.videos[0].url[0]`; `url` berupa array.

```bash theme={null}
curl --request GET \
  --url 'https://api.apimart.ai/v1/tasks/task_example_seedance25flash' \
  --header 'Authorization: Bearer <token>'
```

```json theme={null}
{
  "code": 200,
  "data": {
    "id": "task_example_seedance25flash",
    "status": "completed",
    "progress": 100,
    "cost": 0.3104,
    "credits_cost": 3.104,
    "usage": {
      "completion_tokens": 38800
    },
    "result": {
      "videos": [
        {
          "url": [
            "https://example.com/generated-video.mp4"
          ],
          "last_frame_url": "https://example.com/generated-last-frame.png"
        }
      ]
    }
  }
}
```

| Field | Arti |
| - | - |
| `data.usage.completion_tokens` | Token untuk perhitungan akhir. Mungkin belum muncul beberapa detik setelah selesai; periksa lagi. |
| `data.cost` | Biaya aktual dalam USD setelah diskon akun. Gunakan nilai yang dikembalikan. |
| `data.credits_cost` | Kredit yang benar-benar dipotong. |
| `data.result.videos[].url` | Array URL video; segera unduh dan simpan. |
| `data.result.videos[].last_frame_url` | URL frame terakhir, hanya setelah berhasil dengan permintaan `return_last_frame: true`. |
| `data.error.message` | Alasan gagal. Tugas gagal memiliki `data.cost: 0` dan dana cadangan dikembalikan. |

## Penagihan

* Saat dikirim, dana dicadangkan berdasarkan tarif per detik sesuai resolusi. Referensi video memakai tingkat dengan input: durasi keluaran ditambah total durasi video referensi.
* Permintaan biasa tanpa `duration` mencadangkan 5 detik keluaran. `duration: -1`, atau `edit` tanpa durasi, mencadangkan 30 detik keluaran.
* Setelah berhasil: `data.usage.completion_tokens` ÷ 1,000,000 × tarif per juta token yang sesuai, dengan diskon akun. Selisih dikembalikan atau ditagihkan. Ada tidaknya referensi video menentukan `token` atau `token-input`; biaya akhir ada pada `data.cost`.
* Pengiriman yang ditolak tidak dikenai biaya generasi. Jika generasi gagal, dana cadangan dikembalikan. Tarif dan diskon tersedia di [halaman harga](https://apimart.ai/pricing).

## Kesalahan umum

| Situasi | Tindakan |
| - | - |
| HTTP 400: resolusi tidak didukung | Gunakan `480p` / `720p`, bukan `1080p`. |
| HTTP 400: terlalu banyak referensi | Maksimal 10 gambar total, 5 video, 5 audio; periksa juga durasinya. |
| HTTP 400: draf tidak didukung | Hapus `draft` / `draft_task_id`. |
| HTTP 400: jenis, durasi, atau rasio | Periksa kombinasi `omni_reference_task_type`, `duration`, `size` / `aspect_ratio`. |
| HTTP 400: `nsfw_content_detected` | Perlakukan sebagai penolakan moderasi, baca `error.message`, lalu ubah konten. |
| Model tidak ditemukan | Gunakan `seedance-2-5-flash`, bukan `seedance-2.5-flash`. |
| Tugas `failed` | Baca `data.error.message` dan sesuaikan media serta prompt dengan jenis tugas. Dana cadangan dikembalikan. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.