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

선택적 기본 콜백 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 배열을 모두 허용하세요. 요금은 실제 완료 토큰과 출력 해상도에 따라 달라집니다. 동영상 참조는 동영상 입력 요율을 선택하지만 이미지/오디오 참조만 있으면 그렇지 않습니다.