메인 콘텐츠로 건너뛰기
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-seedance-4-5",
    "prompt": "대나무 숲에서 노는 귀여운 판다",
    "size": "1:1",
    "n": 1,
    "image_urls": [
      "https://cdn.apimart.ai/doc/1761215838466614297_9852.png"
    ]
  }'

{
  "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-seedance-4-5",
    "prompt": "대나무 숲에서 노는 귀여운 판다",
    "size": "1:1",
    "n": 1,
    "image_urls": [
      "https://cdn.apimart.ai/doc/1761215838466614297_9852.png"
    ]
  }'

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

​
인증

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

​
Body

​
model
string
default:"doubao-seedance-4-5"
required
이미지 생성 모델 이름Example: "doubao-seedance-4-5"
​
prompt
string
required
이미지 생성을 위한 텍스트 설명
​
size
string
이미지 생성 크기지원되는 가로세로 비율:
  • 1:1
  • 4:3
  • 3:4
  • 16:9
  • 9:16
  • 3:2
  • 2:3
  • 21:9
지원되는 해상도:
  • 2k
  • 4k
​
n
integer
생성할 이미지 수범위: 1-15 (최소 1장, 최대 15장)기본값: 1참고:
  • 실제로 생성할 수 있는 이미지 수는 이 매개변수와 입력 참조 이미지 수의 영향을 받습니다. 참조 이미지 수 + 생성 이미지 수 ≤ 15장
  • 순수한 숫자를 입력하세요（예：1）。인용부호를 사용하면 오류가 발생합니다
수량에 따라 요금이 사전 차감됩니다
​
image_urls
array
이미지 간 변환 또는 이미지 편집을 위한 참조 이미지 URL 목록
  • 최대 10개 이미지
  • 이미지 형식: jpeg, png
  • 가로세로 비율(너비/높이) 범위: [1/3, 3]
  • 너비 및 높이(px) > 14
  • 크기: 10MB 이하
  • 총 픽셀: 6000×6000 px 이하
​
optimize_prompt_options.mode
string
default:"standard"
프롬프트 최적화 모드
  • standard：표준 모드, 더 높은 품질의 콘텐츠를 생성하지만 처리 시간이 더 깁니다
  • fast：빠른 모드, 처리 시간이 짧고 일반적인 품질의 콘텐츠를 생성합니다
기본값：standard
​
sequential_image_generation
string
default:"disabled"
연속 이미지 생성 모드 (Doubao 전용 기능)여러 이미지를 생성할지 여부를 제어합니다:
  • disabled: 연속 모드 비활성화, 여러 참조 이미지가 있어도 1장만 생성 (기본값)
  • auto: 연속 모드 활성화, 여러 이미지 생성 가능
사용 방법:
  • ✅ image_urls 제공 필수 - 최소 1장의 참조 이미지 필요
  • ✅ n: 3 설정 또는 sequential_image_generation: "auto" + max_images: 3 사용
  • ✅ 이렇게 하면 참조 이미지를 기반으로 3장의 다른 이미지가 생성됩니다
  • ⚠️ n > 1인 경우 자동으로 auto로 설정됩니다
제한 사항:
  • 순수 텍스트-이미지 변환 (image_urls 없음)에서는 여러 이미지를 생성할 수 없습니다 - 이것은 Doubao API의 제한입니다
​
sequential_image_generation_options
object
연속 이미지 생성 옵션sequential_image_generation이 auto로 설정된 경우 사용 가능속성:
  • max_images (integer): 생성할 이미지 수 지정, 범위: 1-15
예시:
"sequential_image_generation": "auto",
"sequential_image_generation_options": {
  "max_images": 3
}
​
watermark
boolean
default:"false"
생성된 이미지에 워터마크를 추가할지 여부
  • true: 워터마크 추가
  • false: 워터마크 없음 (기본값)

​
Response

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