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

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

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

{
  "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-seedance-4-0"
필수
이미지 생성 모델 이름지원 모델: doubao-seedance-4-0, doubao-seedream-4.0, doubao-seedream-4-0, Doubao-Seedream-4.0Example: "doubao-seedance-4-0"
​
prompt
string
필수
이미지 생성을 위한 텍스트 설명최대 1000자
​
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 - 울트라 와이드
  • 9:21 - 울트라 톨
  • auto - 참조 이미지 비율 자동 매칭 (image_urls 필요)
​
resolution
string
기본값:"2K"
이미지 해상도지원되는 해상도:
  • 1K - 기본 해상도
  • 2K - 표준 해상도 (기본값)
  • 4K - 고해상도
해상도 참고 크기:
해상도1:1 크기16:9 크기
1K1024x10241280x720
2K2048x20482560x1440
4K4096x40965404x3040
​
n
integer
생성할 이미지 수범위: 1-15 (최소 1장, 최대 15장)기본값: 1참고:
  • 실제로 생성할 수 있는 이미지 수는 이 매개변수와 입력 참조 이미지 수의 영향을 받습니다. 참조 이미지 수 + 생성 이미지 수 ≤ 15장
  • 순수한 숫자를 입력하세요（예：1）。인용부호를 사용하면 오류가 발생합니다
수량에 따라 요금이 사전 차감됩니다
​
image_urls
array
이미지 간 변환 또는 이미지 편집을 위한 참조 이미지 URL 목록두 가지 형식 지원:1. 완전한 이미지 URL
  • 공개적으로 접근 가능한 이미지 URL (http:// 또는 https://)
  • 예: https://example.com/image.jpg
2. Base64 인코딩 형식
  • 완전한 Data URI 형식을 사용해야 합니다
  • 형식: data:image/{형식};base64,{base64 데이터}
  • 지원되는 이미지 형식: jpeg, png
  • 예: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • ⚠️ 주의: data:image/jpeg;base64, 접두사를 포함해야 합니다
제한:
  • 최대 10개 이미지
  • 이미지 형식: jpeg, png
  • 가로세로 비율(너비/높이) 범위: [1/3, 3]
  • 너비 및 높이(px) > 14
  • 크기: 10MB 이하
  • 총 픽셀: 6000×6000 px 이하
​
optimize_prompt_options
string
기본값:"standard"
프롬프트 최적화 모드
  • standard：표준 모드, 더 높은 품질의 콘텐츠를 생성하지만 처리 시간이 더 깁니다
  • fast：빠른 모드, 처리 시간이 짧고 일반적인 품질의 콘텐츠를 생성합니다
기본값：standard
​
sequential_image_generation
string
기본값:"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
기본값:"false"
생성된 이미지에 워터마크를 추가할지 여부
  • true: 워터마크 추가
  • false: 워터마크 없음 (기본값)

​
Response

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