Seedream
On this page
Endpoint: POST https://vod.intl.tencentcloudapi.com
Action: CreateAigcImageTask
기본 정보
| 항목 | 값 |
|---|---|
| ModelName | Seedream |
| ModelVersion | 5.0-lite / 4.5 / 4.0 |
| 기본값 | ModelVersion=4.0 / AspectRatio=1:1 |
| 가드레일 해제 지원 | 미지원 |
버전별 지원 규격
| 버전 | 출력 규격 | 입력 및 조건 |
|---|---|---|
| 공통 | 비율: 1:1 / 16:9 / 9:16 / 4:3 / 3:4해상도 지정: 프리셋 또는 size로 픽셀 지정; MPS 5.0-pro/lite는 AdditionalParameters.size 사용 |
— |
요청 파라미터
| 파라미터 | 필수 | 타입 | 설명 |
|---|---|---|---|
ModelName |
필수 | String | 고정값 Seedream |
ModelVersion |
선택 | String | 5.0-lite / 4.5 / 4.0 |
Prompt |
필수 | String | 생성 프롬프트 |
FileInfos.N |
선택 | Array | 참조 이미지(image-to-image). Category는 Image |
OutputConfig.AspectRatio |
선택 | String | 1:1 / 16:9 / 9:16 / 4:3 / 3:4 등 |
OutputConfig.OutputImageCount |
선택 | Integer | 생성 장수 (모델별 상한 상이) |
요청 예시
LANGUAGE
{
"SubAppId": 123456789,
"ModelName": "Seedream",
"ModelVersion": "4.0",
"Prompt": "a serene japanese garden, soft morning light",
"OutputConfig": {
"AspectRatio": "1:1",
"OutputImageCount": 1,
"StorageMode": "Temporary"
},
"SessionContext": "job-001"
}참조 이미지 요청
LANGUAGE
{
"SubAppId": 123456789,
"ModelName": "Seedream",
"ModelVersion": "4.0",
"Prompt": "Change the background to a quiet garden; preserve the subject.",
"OutputConfig": {
"AspectRatio": "1:1",
"OutputImageCount": 1,
"StorageMode": "Temporary"
},
"SessionContext": "job-001",
"FileInfos": [
{
"Type": "Url",
"Category": "Image",
"Url": "https://<host>/reference.jpg"
}
]
}응답 예시
LANGUAGE
{
"AigcImageTask": {
"Status": "FINISH",
"ErrCode": 0,
"Progress": 100,
"Output": {
"FileInfos": [
{
"FileUrl": "http://<host>.vod2.myqcloud.com/.../aigcImageGenFile.png",
"ExpireTime": "2026-08-01T10:29:48Z",
"MetaData": {
"Width": 1024,
"Height": 1024,
"Container": "png"
}
}
]
}
}
}특수 설정
추가 옵션
지원 버전은 5.0-lite / 4.5 / 4.0입니다.