메인 콘텐츠로 건너뛰기
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-seedream-5-0-lite",
    "prompt": "정원에서 노는 골든 리트리버, 맑은 날, 고화질 사진 스타일",
    "size": "16:9",
    "resolution": "2K",
    "n": 1
  }'

{
  "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-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"
필수
이미지 생성 모델 이름지원 모델: doubao-seedream-5-0-lite, doubao-seedream-5.0-lite, Doubao-Seedream-5.0-liteExample: "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 - 고해상도
  • 4K - 초고해상도
참고: Seedream-5.0-Lite는 2K, 3K, 4K 해상도를 지원합니다. 1K는 지원되지 않습니다
해상도 참조 크기:
해상도1:1 크기16:9 크기
2K2048x20482848x1600
3K3072x30724096x2304
4K4096x40965504x3040
​
n
integer
생성할 이미지 수범위: 1-15기본값: 1참고:
  • n > 1일 때 연속 이미지 생성 모드가 자동으로 활성화됩니다
  • 숫자만 입력하세요 (예: 1). 따옴표를 사용하면 오류가 발생합니다
생성 수에 따라 사전 청구됩니다
image_urls의 참조 이미지 수 + n으로 지정한 최종 생성 이미지 수는 ≤ 15장이어야 합니다.
​
image_urls
array
이미지-이미지 생성을 위한 참조 이미지 URL 목록두 가지 형식을 지원합니다:1. 전체 이미지 URL
  • 공개적으로 접근 가능한 이미지 URL (http:// 또는 https://)
  • 예: https://example.com/image.jpg
2. Base64 인코딩 형식
  • 완전한 Data URI 형식을 사용해야 합니다
  • 형식: data:image/{format};base64,{base64data}
  • 지원 이미지 형식: jpeg, png
  • 예: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • 참고: data:image/jpeg;base64, 접두사를 포함해야 합니다
제한:
  • 이미지 형식: jpeg, png
  • 종횡비 (너비/높이) 범위: [1/3, 3]
  • 너비와 높이 (px) > 14
  • 크기: 이미지당 10MB 이하
  • 총 픽셀: 6000×6000 px 이하
image_urls의 참조 이미지 수 + n으로 지정한 최종 생성 이미지 수는 ≤ 15장이어야 합니다.
​
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
응답 데이터 배열