Seedance 2.5 Flash API 작업 공간
- 480p 또는 720p, 4~30초 또는 Auto
- 이미지 10장, 영상 5개, 오디오 5개까지
- 작업 유형, 오디오, MP4/MOV, 마지막 프레임
Input
지정하지 않거나 auto를 선택하면 모델이 판단합니다. reference는 참조 소재를 사용하며, edit와 extend에는 참조 영상이 1개 이상 필요합니다.
5s
요청당 이미지 10장, 영상 5개, 오디오 5개까지. 공개 http(s) URL 또는 asset:// ID를 입력하세요.
참조 비디오 (0/5)
참조 오디오 (0/5)
Output
생성된 영상이 여기에 표시됩니다
Seedance 2.5 Flash API: 더 빠른 480p·720p 영상 생성
Seedance 2.5 Flash 모델은 속도에 초점을 맞췄습니다. 480p 또는 720p 출력을 위한 요청을 준비하세요. 장면을 설명하고 작업 유형을 고른 뒤 이미지, 참조 영상 또는 오디오를 추가합니다. API를 호출하기 전에 양식이나 JSON으로 검토할 수 있습니다.
Seedance 2.5 Flash API 예제: 텍스트-영상과 이미지-영상
Seedance 2.5 Flash API 예제는 APIMart 공통 비동기 작업 형식을 사용합니다. 작업을 제출한 뒤 반환된 작업 ID로 조회하세요.
- 1
Seedance 2.5 Flash API 요청 인증
APIMart API 키를 APIMART_API_KEY로 저장하세요. Seedance 2.5 Flash API 예제는 작업 제출과 조회 시 Authorization: Bearer <key>를 보냅니다.
- 2
seedance-2.5-flash 작업 제출
POST /v1/videos/generations에 model(seedance-2.5-flash), 프롬프트, size, resolution, duration을 보냅니다. 참조가 필요하면 image_urls, video_urls 또는 audio_urls를 추가하세요. 작업 ID는 data[0].task_id에서 읽습니다.
- 3
Seedance 2.5 Flash 결과 조회
GET /v1/tasks/{task_id}를 사용하세요. 완료된 작업은 data.result.videos[0].url[0], 실패한 작업은 data.error.message를 읽습니다.
APIMart 인증 방법과 일반적인 API 사용법은 APIMart 문서에서 확인하세요.
POST /v1/videos/generations
curl -X POST https://api.apimart.ai/v1/videos/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-flash",
"prompt": "해 뜰 무렵 해안 도로를 달리는 자전거 라이더, 카메라가 옆에서 나란히 따라가고 파도가 따뜻한 빛을 받아 반짝인다",
"size": "16:9",
"resolution": "720p",
"duration": 10
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "seedance-2.5-flash",
"prompt": "해 뜰 무렵 해안 도로를 달리는 자전거 라이더, 카메라가 옆에서 나란히 따라가고 파도가 따뜻한 빛을 받아 반짝인다",
"size": "16:9",
"resolution": "720p",
"duration": 10
}
resp = requests.post(f"{API_BASE}/v1/videos/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
# 2. Poll the task until it finishes
for _ in range(200):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()["data"]
if task["status"] == "completed":
print(task["result"]["videos"][0]["url"][0])
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
time.sleep(10)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")curl -X POST https://api.apimart.ai/v1/videos/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-flash",
"prompt": "참조 이미지 속 제품이 부드러운 조명 아래 흰색 스튜디오 턴테이블 위에서 천천히 회전하고, 카메라가 라벨 쪽으로 다가간다",
"image_urls": [
"https://example.com/product.jpg"
],
"size": "16:9",
"resolution": "720p",
"duration": 10
}'TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"Seedance 2.5 Flash API 파라미터
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | 필수 | 기본값: seedance-2.5-flash | 이 Seedance 2.5 Flash 작업 공간과 예제에서 사용하는 모델 값: seedance-2.5-flash. |
prompt | string | 필수 | 기본값: — | 영상 설명. @图片1, @视频1, @音频1처럼 배열 순서의 번호로 소재를 참조합니다. |
resolution | string | 선택 | 기본값: 720p | 480p 또는 720p. Seedance 2.5 Flash는 1080p를 제공하지 않습니다. |
size | string | 선택 | 기본값: adaptive | 화면비(aspect_ratio로도 지정 가능): 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 또는 adaptive. 편집, 연장, 첫·마지막 프레임만 있는 작업은 adaptive가 필요합니다. |
duration | integer | 선택 | 기본값: 5 | 영상 길이: 4~30초, 또는 -1로 모델이 선택. 편집 작업은 원본 영상을 따르며 -1을 사용합니다. |
generate_audio | boolean | 선택 | 기본값: true | 영상과 함께 오디오를 생성합니다(audio로도 지정 가능). false로 설정하면 무음 영상입니다. |
image_urls | array | 선택 | 기본값: — | 참조 이미지(http(s) URL 또는 asset:// ID). 요청당 이미지 10장 한도에 포함됩니다. image_with_roles와 함께 사용할 수 없습니다. |
image_with_roles | array | 선택 | 기본값: — | 역할이 지정된 이미지: first_frame, last_frame 또는 reference_image. 마지막 프레임에는 첫 프레임이 필요하며, 모든 역할 이미지가 10장 한도에 포함됩니다. |
video_urls | array | 선택 | 기본값: — | 참조 영상 최대 5개(http(s) URL 또는 asset:// ID). 편집과 연장 작업에는 1개 이상 필요합니다. |
audio_urls | array | 선택 | 기본값: — | 참조 오디오 최대 5개(http(s) URL 또는 asset:// ID). |
omni_reference_task_type | string | 선택 | 기본값: — | auto, reference, edit 또는 extend. 지정하지 않거나 auto를 쓰면 모델이 판단합니다. |
output_format | string | 선택 | 기본값: mp4 | mp4 또는 mov. |
return_last_frame | boolean | 선택 | 기본값: false | 영상의 마지막 프레임을 이미지로도 반환합니다. |
seed | integer | 선택 | 기본값: — | 랜덤 시드. 같은 seed는 비슷하지만 완전히 같지는 않은 결과를 냅니다. |
watermark | boolean | 선택 | 기본값: false | 'AI 생성' 워터마크를 추가합니다. |
tools | array | 선택 | 기본값: — | 선택 도구. 예: [{"type": "web_search"}]로 웹 정보를 참고합니다. |
nsfw_check | boolean | 선택 | 기본값: false | APIMart 필드: 작업 제출 전에 프롬프트와 입력 이미지를 검수합니다. |
