메인 콘텐츠로 건너뛰기
POST
https://api.apimart.ai
/
v1
/
images
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedream-5-0-lite",
    "prompt": "정원에서 노는 골든 리트리버, 맑은 날, 고화질 사진 스타일",
    "size": "16:9",
    "resolution": "2K",
    "n": 1
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedream-5-0-lite",
    "prompt": "정원에서 노는 골든 리트리버, 맑은 날, 고화질 사진 스타일",
    "size": "16:9",
    "resolution": "2K",
    "n": 1
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

​
인증

​
Authorization
string
필수
모든 API 엔드포인트는 Bearer Token 인증이 필요합니다API 키 받기:API 키 관리 페이지를 방문하여 API 키를 받으세요요청 헤더에 추가:
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
기본값:"doubao-seedream-5-0-lite"
필수
이미지 생성 모델 이름Example: "doubao-seedream-5-0-lite"
​
prompt
string
필수
이미지 생성을 위한 텍스트 설명
​
size
string
기본값:"1:1"
이미지 종횡비지원되는 종횡비:
  • 1:1 - 정사각형 (기본값)
  • 4:3 - 가로 4:3
  • 3:4 - 세로 3:4
  • 16:9 - 가로 와이드스크린
  • 9:16 - 세로
  • 3:2 - 가로 3:2
  • 2:3 - 세로 2:3
  • 21:9 - 울트라와이드
  • auto - 참조 이미지 종횡비 자동 매칭 (image_urls 필요)
참고: Seedream-5.0-Lite는 9:21 비율을 지원하지 않습니다
​
resolution
string
기본값:"2K"
이미지 해상도지원되는 해상도:
  • 2K - 표준 해상도 (기본값)
  • 3K - 고해상도
참고: Seedream-5.0-Lite는 2K와 3K 해상도만 지원합니다. 1K와 4K는 지원되지 않습니다
해상도 참조 크기:
해상도1:1 크기16:9 크기
2K2048x20482848x1600
3K3072x30724096x2304
​
n
integer
생성할 이미지 수범위: 1-4기본값: 1참고:
  • n > 1일 때 연속 이미지 생성 모드가 자동으로 활성화됩니다
  • 숫자만 입력하세요 (예: 1). 따옴표를 사용하면 오류가 발생합니다
생성 수에 따라 사전 청구됩니다
​
image_urls
array
이미지-이미지 생성을 위한 참조 이미지 URL 목록제한:
  • 이미지 형식: jpeg, png
  • 종횡비 (너비/높이) 범위: [1/3, 3]
  • 너비와 높이 (px) > 14
  • 크기: 이미지당 10MB 이하
  • 총 픽셀: 6000×6000 px 이하
​
output_format
string
기본값:"jpeg"
출력 이미지 형식
  • jpeg: JPEG 형식 (기본값)
  • png: PNG 형식, 투명 배경 등에 적합
참고: output_format 매개변수는 Seedream-5.0-Lite 전용입니다. 다른 이미지 모델에서는 이 매개변수가 무시됩니다.
​
sequential_image_generation
string
기본값:"disabled"
연속 이미지 생성 모드여러 이미지를 생성할지 여부를 제어합니다:
  • disabled: 연속 모드 비활성화 (기본값)
  • auto: 연속 모드 활성화, 여러 이미지 생성 가능
사용 참고:
  • n > 1일 때 자동으로 auto로 설정됩니다
​
sequential_image_generation_options
object
연속 이미지 생성 옵션sequential_image_generation이 auto로 설정된 경우 사용 가능속성:
  • max_images (integer): 생성할 이미지 수 지정
예시:
"sequential_image_generation": "auto",
"sequential_image_generation_options": {
  "max_images": 4
}
​
watermark
boolean
기본값:"false"
생성된 이미지에 워터마크를 추가할지 여부
  • true: 워터마크 추가
  • false: 워터마크 없음 (기본값)

​
응답

​
code
integer
응답 상태 코드
​
data
array
응답 데이터 배열