API 퀵스타트 / 인간 + AGENT 지원
키를 만들기 전에 연동부터 완성하세요.
이 퀵스타트로 코드를 준비하고, payload를 검증하고, 과금 모델을 파악하세요. 실제 호출에는 사람이 직접 생성한 provider API 키가 필요합니다.
상태실제 호출 전 확인
Expected Provider-mediated access
Seedance 2.5 API availability should be verified with the provider before production use. Build behind a configurable model parameter.
코드CURL + NODE
curl https://api.evolink.ai/v1/videos/generations \
-H "Authorization: Bearer $EVOLINK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-reference-to-video",
"prompt": "A clean product shot, slow dolly in, soft daylight",
"duration": 5,
"quality": "720p",
"generate_audio": true
}' const resp = await fetch("https://api.evolink.ai/v1/videos/generations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.EVOLINK_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: process.env.SEEDANCE_MODEL || "seedance-2.5-reference-to-video",
prompt,
duration: 5,
quality: "720p",
generate_audio: true,
}),
});
// Returns a job id; poll GET /v1/task-detail?id=<id> until status is completed.
const job = await resp.json(); 파라미터요청 본문
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
| model | string | 필수 | Seedance 2.5 모델 ID(pre-release). 설정 가능하게 유지하세요. |
| prompt | string | 필수 | 주체, 움직임, 스타일, 제약을 담은 샷 설명. |
| duration | integer | 선택 | 4–30초, 기본 5. 먼저 짧은 길이로 테스트. |
| quality | string | 선택 | 480p 또는 720p(기본 720p). 1080p/4K는 미정으로 간주. |
| generate_audio | boolean | 선택 | 기본 true. 네이티브 오디오, 추가 요금 없음. |
| content_filter | boolean | 선택 | 기본 true(무료). false는 1.1배 비용이 적용됩니다. |
| image_urls / video_urls / audio_urls | array | 선택 | 참조 소재: 최대 30 / 10 / 10개 URL. 선택. |
| callback_url | url | 선택 | 비동기 완료용 HTTPS webhook. polling도 가능. |
기계 판독용 schema: /openapi.json / Agent 가이드: /agent.md
핸드오프마지막 단계
코드는 키 없이 준비할 수 있지만, 실제 호출은 불가능합니다.
provider 키를 만들어 EVOLINK_API_KEY로 설정한 뒤, 프로덕션 트래픽 전에 저비용 테스트를 먼저 실행하세요.