API 가이드
매개변수
각 모델은 고유한 매개변수 이름을 사용하며, 각 모델 페이지에 해당 이름이 나와 있습니다. 이와 함께 API는 모든 모델에서 동일한 의미를 갖는 매개변수에 대해 표준 이름도 허용하므로, 한 모델용으로 작성한 코드를 다음 모델에서도 더 적은 변경으로 사용할 수 있습니다.
표준 이름
| 표준 이름 | 의미 | 일반적인 고유 이름 |
|---|---|---|
image |
입력 이미지 또는 첫 프레임 이미지 | image_url, start_image_url, first_frame_url, first_image_url, source_image_url |
end_image |
마지막 프레임 이미지 | end_image_url, last_frame_url, tail_image_url |
images |
참조 이미지 목록 | image_urls, reference_image_urls |
video |
입력 동영상 | video_url |
videos |
참조 동영상 목록 | video_urls |
audio |
입력 오디오 | audio_url |
audios |
참조 오디오 클립 목록 | audio_urls |
mask |
마스크 이미지 | mask_url |
num_outputs |
생성할 결과 수 | num_images |
generate_audio |
동영상과 함께 사운드 생성 | generate_audio_switch, enable_audio |
현재 각 모델에서 표준 이름이 매핑되는 고유 필드:
| 표준 이름 | 네이티브 필드(사용하는 모델) |
|---|---|
audio |
audio_url (모델: 126개) |
audios |
audio_urls (모델: 7개), reference_audio_urls (모델: 1개) |
end_image |
end_image_url (모델: 76개), last_frame_url (모델: 12개), tail_image_url (모델: 1개) |
generate_audio |
generate_audio_switch (모델: 16개), audio (모델: 3개) |
image |
image_url (모델: 529개), start_image_url (모델: 20개), first_frame_url (모델: 12개), first_image_url (모델: 7개), source_image_url (모델: 2개) |
images |
image_urls (모델: 148개), reference_image_urls (모델: 31개) |
mask |
mask_url (모델: 46개) |
num_outputs |
num_images (모델: 337개) |
video |
video_url (모델: 197개) |
videos |
video_urls (모델: 13개), reference_video_urls (모델: 1개) |
규칙:
- 표준 이름 또는 고유 이름 중 하나를 전송합니다. 서로 다른 값으로 둘 다 전송하면 표준 이름에서
422 invalid_input오류와 함께 요청이 실패합니다. - 모델의 고유 이름도 표준 이름도 아닌 매개변수는 가장 가까운 유효한 이름을 제안하며
422 invalid_input("Unknown parameter")으로 거부됩니다. 오타가 조용히 통과되는 일은 없습니다. - 각 모델 페이지에는 두 이름이 나란히 표시됩니다.
형 변환
값은 모델이 기대하는 형으로 변환되므로 다음 예시는 모두 작동합니다.
| 전송하는 값 | 모델이 기대하는 값 | 변환 결과 |
|---|---|---|
5, "5", "5s" |
"5"와 같은 문자열로서의 duration |
"5" |
"8" |
정수 | 8 |
"1080P", "4K" |
"1080p", "4k"와 같은 resolution |
정확히 허용되는 표기 |
"true", "false", 1, 0 |
불리언 | true, false |
"https://…/a.jpg" |
URL 목록 | ["https://…/a.jpg"] |
42 |
문자열 | "42" |
허용되는 값은 먼저 정확히 일치하는지 확인하고, 그다음 대소문자를 무시한 상태로 확인하며, 마지막으로 숫자로 확인합니다(5는 "5", "5s", "5 s" 형식의 값과 일치합니다).
기본값
생략한 매개변수에는 모델의 기본값이 사용되며, 이 값은 모델의 매개변수 표에 나와 있습니다. 가격도 동일한 기본값으로 계산됩니다(예를 들어 generate_audio의 기본값이 true인 동영상 모델은 "generate_audio": false를 전송하지 않는 한 사운드가 포함된 가격으로 계산됩니다).
파일 매개변수
이미지, 동영상 및 오디오 매개변수에는 공개 URL, 최대 10MB의 data: URI 또는 업로드한 파일의 file_url을 사용할 수 있습니다. 파일을 참조하세요.