Seedream 5.5 Pro · 이미지-이미지
curl --request POST \
--url https://api.gravitex.ai/v1/images/generationsimport requests
url = "https://api.gravitex.ai/v1/images/generations"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://api.gravitex.ai/v1/images/generations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.gravitex.ai/v1/images/generations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.gravitex.ai/v1/images/generations"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.gravitex.ai/v1/images/generations")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gravitex.ai/v1/images/generations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_bodySeedream 5.5 Pro
Seedream 5.5 Pro · 이미지-이미지
Seedream 5.5 Pro 이미지-이미지 매개변수, 제한 및 복사 가능한 예제
POST
/
v1
/
images
/
generations
Seedream 5.5 Pro · 이미지-이미지
curl --request POST \
--url https://api.gravitex.ai/v1/images/generationsimport requests
url = "https://api.gravitex.ai/v1/images/generations"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://api.gravitex.ai/v1/images/generations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.gravitex.ai/v1/images/generations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.gravitex.ai/v1/images/generations"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.gravitex.ai/v1/images/generations")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gravitex.ai/v1/images/generations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_body소개
참조 이미지와 편집 지시문으로 단일 이미지 편집, 다중 이미지 융합, 대화형 편집, 투명 이미지 또는 레이어 분해를 수행합니다. 일반 편집은 이미지 1장을, 분해는 기본 이미지와 여러 레이어를 반환합니다. 정형 인쇄 텍스트 레이어에는 서식 있는 텍스트 OCR 결과도 반환할 수 있습니다.엔드포인트 및 인증
POST https://api.gravitex.ai/v1/images/generations
Authorization: Bearer sk-xxxxxxxxxx와 Content-Type: application/json을 사용하세요. 이미지 편집은 같은 JSON 본문으로 /v1/images/edits도 사용할 수 있습니다. 매개변수 및 요금
요청 매개변수
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
model | string | 예 | dola-seedream-5-5-261028 |
prompt | string | 편집: 필수, 분해: 선택 | 생성 또는 편집 지시문. 레이어 분해 시 분리할 요소를 지정합니다 |
image | string / string[] | 예 | 참조 URL 또는 Base64. 일반 편집은 최대 10장, 분해는 정확히 1장입니다 |
size | string | 아니요 | 기본값 2K. 1K, 1.5K, 2K 또는 사용자 지정 WIDTHxHEIGHT; 분해 기본값은 auto |
output_format | string | 아니요 | 기본값: png. jpeg / png. 분해 시 기본 이미지에만 적용되며 레이어는 항상 PNG입니다. |
response_format | string | 아니요 | 기본값: url. url(24시간 유효) 또는 b64_json |
watermark | boolean | 아니요 | 기본값: true. 오른쪽 아래에 AI 생성 워터마크를 추가합니다 |
background | string | 아니요 | 기본값: auto. auto / transparent / opaque |
optimize_prompt_options | object | 아니요 | 기본값: {"mode":"standard"}. standard만 지원합니다 |
layer_decomposition | boolean | 아니요 | 기본값: false. 레이어 분해 활성화 |
layer_decomposition_options | object | 아니요 | 레이어 분해를 활성화했을 때만 적용되는 설정 |
n은 생략하거나 1을 사용하고, 결과가 여러 장 필요하면 요청을 각각 보내세요. 공통 매개변수에서 전체 기본값과 safety_identifier를 확인하세요. 두 모델 모두 quality, 연속 이미지 생성, 스트리밍 및 웹 검색을 지원하지 않습니다.
prompt
편집 시 필수입니다. 참조 이미지를 어떻게 사용하거나 변경할지 설명하세요. 분해 시에는 선택 사항이며 분리할 요소를 지정하거나 생략하여 모델이 주요 요소를 자동 인식하게 할 수 있습니다. 중국어는 300자, 영어는 600단어 이내를 권장하며 너무 길면 세부 사항이 누락될 수 있습니다. 대화형 편집에서는 왼쪽 위를 원점으로 하는 정규화 좌표[0, 1000]과 <bbox>x1 y1 x2 y2</bbox>로 영역을 지정하세요. 참조 이미지에 상자, 화살표 또는 스케치를 그린 뒤 변경 사항을 설명할 수도 있습니다.
image
문자열 1개 또는 문자열 배열을 받습니다. 각 항목은 서버에서 접근할 수 있는 공개 URL 또는data:image/<format>;base64,<data> 형식의 Base64 데이터 URI입니다. 형식 이름은 소문자를 사용하세요(예: data:image/png;base64,iVBORw0...).
| 제한 | 일반 편집 | 레이어 분해 |
|---|---|---|
| 수량 | 필수, 최대 10장 | 필수, 정확히 1장 |
| 형식 | jpeg, png, webp, bmp, tiff, gif, heic, heif | png, jpeg |
| 가로/세로 비율 | [1/16, 16] | [1/16, 16] |
| 가로 및 세로 | 모두 14px 초과 | 총 픽셀 및 비율 제한 적용 |
| 이미지당 용량 | ≤ 30 MB | ≤ 30 MB |
| 총 픽셀 | [196, 6000×6000] | [512×512, 6000×6000] |
총 픽셀 수는 가로 × 세로의 곱이며 각 변의 최솟값을 뜻하지 않습니다. 투명 이미지 조건은 아래에 별도로 설명합니다.
size
전체 크기 규칙과 해상도 표 분해는1K, 1.5K, 2K, auto(기본값)만 지원하며 사용자 지정 픽셀 크기는 지원하지 않습니다.
background
| 값 | 설명 |
|---|---|
auto | 기본값. 프롬프트와 출력 형식에 따라 모델이 결정합니다. JPEG에는 알파 채널이 없습니다. |
opaque | 알파 채널 없는 RGB 출력 |
transparent | 알파 채널이 있는 RGBA 출력. PNG를 사용하세요 |
텍스트-이미지와 이미지-이미지 모두 네이티브 투명 이미지를 지원합니다. 편집 시 알파 채널이 없는 참조 이미지도 최대 10장까지 사용할 수 있습니다. 실제 투명도는 요청값과 다를 수 있으므로
data[].background를 확인하세요.background: "transparent"와 JPEG 출력을 함께 사용하지 마세요. 레이어 분해 모드에서는 background를 전달하지 마세요.layer_decomposition
layer_decomposition: true로 이미지 1장을 기본 이미지 1장과 알파 채널을 가진 독립 PNG 레이어 최대 99개로 분해합니다. 기본값은 false입니다.
image는 필수이며 입력은 정확히 1장이어야 합니다.- 레이어 하나라도 실패하면 전체 요청이 실패하며 부분 성공은 지원하지 않습니다.
- 요청한 레이어가 상한을 넘으면 일부 정보가 누락될 수 있습니다.
- 응답에는
z_index,name,description,bounding_box가 포함됩니다. - 기본 이미지와 모든 레이어는
usage.generated_images에 포함됩니다.
layer_decomposition_options
layer_decomposition이 true일 때만 적용됩니다.
| 필드 | 유형 | 기본값 | 범위 | 설명 |
|---|---|---|---|---|
max_images | integer | 30 | [2, 100] | 기본 이미지를 포함한 최대 출력 수 |
text_recognition | boolean | false | true / false | 정형 인쇄 텍스트 레이어의 서식 있는 텍스트 OCR 반환 |
{
"layer_decomposition_options": {
"max_images": 20,
"text_recognition": true
}
}
max_images에 따라 분해를 계획합니다. 상한이 클수록 보통 더 세밀하게 분해됩니다. 업스트림은 max_images 기준으로 IPM(분당 이미지 수) 한도를 예약하고 미사용분을 해제합니다. 비텍스트 레이어와 손글씨, 장식 문자 등 비정형 텍스트는 OCR을 반환하지 않습니다. 지원 글꼴: Seedream 5.5 OCR 글꼴
호출 예제
각 예제는 전체 JSON 본문과 동일한 cURL을 제공합니다.sk-xxxxxxxxxx를 자신의 API 키로 바꾸세요. 입력 URL은 로그인 없이 접근할 수 있는 공개 주소입니다. 응답 URL은 구조 예시입니다.
단일 이미지 편집
{
"model": "dola-seedream-5-5-261028",
"prompt": "참조 이미지 속 강아지의 외형은 유지하고 배경을 설산으로 바꾸세요",
"image": "https://images.unsplash.com/photo-1517849845537-4d257902454a?w=1024&fm=jpg",
"size": "2K"
}
curl --location 'https://api.gravitex.ai/v1/images/generations' \
--header 'Authorization: Bearer sk-xxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"model": "dola-seedream-5-5-261028",
"prompt": "참조 이미지 속 강아지의 외형은 유지하고 배경을 설산으로 바꾸세요",
"image": "https://images.unsplash.com/photo-1517849845537-4d257902454a?w=1024&fm=jpg",
"size": "2K"
}'
다중 이미지 융합
{
"model": "dola-seedream-5-5-261028",
"prompt": "이미지 1의 강아지를 이미지 2의 호숫가 장면에 배치하고, 강아지의 외형을 유지하면서 조명과 원근을 맞추세요",
"image": [
"https://images.unsplash.com/photo-1517849845537-4d257902454a?w=1024&fm=jpg",
"https://images.unsplash.com/photo-1501785888041-af3ef285b470?w=1024&fm=jpg"
],
"size": "2K"
}
curl --location 'https://api.gravitex.ai/v1/images/generations' \
--header 'Authorization: Bearer sk-xxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"model": "dola-seedream-5-5-261028",
"prompt": "이미지 1의 강아지를 이미지 2의 호숫가 장면에 배치하고, 강아지의 외형을 유지하면서 조명과 원근을 맞추세요",
"image": [
"https://images.unsplash.com/photo-1517849845537-4d257902454a?w=1024&fm=jpg",
"https://images.unsplash.com/photo-1501785888041-af3ef285b470?w=1024&fm=jpg"
],
"size": "2K"
}'
대화형 편집
{
"model": "dola-seedream-5-5-261028",
"prompt": "<bbox>0 0 1000 300</bbox> 영역의 배경만 연한 파란색으로 바꾸고 강아지와 나머지 영역은 그대로 유지하세요",
"image": "https://images.unsplash.com/photo-1517849845537-4d257902454a?w=1024&fm=jpg",
"size": "2K"
}
curl --location 'https://api.gravitex.ai/v1/images/generations' \
--header 'Authorization: Bearer sk-xxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"model": "dola-seedream-5-5-261028",
"prompt": "<bbox>0 0 1000 300</bbox> 영역의 배경만 연한 파란색으로 바꾸고 강아지와 나머지 영역은 그대로 유지하세요",
"image": "https://images.unsplash.com/photo-1517849845537-4d257902454a?w=1024&fm=jpg",
"size": "2K"
}'
투명 이미지 편집
{
"model": "dola-seedream-5-5-261028",
"prompt": "참조 이미지의 강아지를 추출하고 배경을 제거하여 투명 배경 이미지로 출력하세요",
"image": "https://images.unsplash.com/photo-1517849845537-4d257902454a?w=1024&fm=jpg",
"background": "transparent",
"output_format": "png",
"size": "2K"
}
curl --location 'https://api.gravitex.ai/v1/images/generations' \
--header 'Authorization: Bearer sk-xxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"model": "dola-seedream-5-5-261028",
"prompt": "참조 이미지의 강아지를 추출하고 배경을 제거하여 투명 배경 이미지로 출력하세요",
"image": "https://images.unsplash.com/photo-1517849845537-4d257902454a?w=1024&fm=jpg",
"background": "transparent",
"output_format": "png",
"size": "2K"
}'
레이어 분해 및 OCR
{
"model": "dola-seedream-5-5-261028",
"prompt": "이미지의 정형 인쇄 텍스트를 문단별 독립 레이어로 분해하고 텍스트 내용과 스타일을 인식하세요",
"image": "https://raw.githubusercontent.com/tesseract-ocr/tessdoc/main/images/eurotext.png",
"layer_decomposition": true,
"layer_decomposition_options": {
"max_images": 20,
"text_recognition": true
},
"size": "2K",
"output_format": "jpeg"
}
curl --location 'https://api.gravitex.ai/v1/images/generations' \
--header 'Authorization: Bearer sk-xxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"model": "dola-seedream-5-5-261028",
"prompt": "이미지의 정형 인쇄 텍스트를 문단별 독립 레이어로 분해하고 텍스트 내용과 스타일을 인식하세요",
"image": "https://raw.githubusercontent.com/tesseract-ocr/tessdoc/main/images/eurotext.png",
"layer_decomposition": true,
"layer_decomposition_options": {
"max_images": 20,
"text_recognition": true
},
"size": "2K",
"output_format": "jpeg"
}'
자동 레이어 분해
{
"model": "dola-seedream-5-5-261028",
"image": "https://images.unsplash.com/photo-1501785888041-af3ef285b470?w=1024&fm=jpg",
"layer_decomposition": true,
"safety_identifier": "5f4dcc3b5aa765d61d8327deb882cf99"
}
curl --location 'https://api.gravitex.ai/v1/images/generations' \
--header 'Authorization: Bearer sk-xxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"model": "dola-seedream-5-5-261028",
"image": "https://images.unsplash.com/photo-1501785888041-af3ef285b470?w=1024&fm=jpg",
"layer_decomposition": true,
"safety_identifier": "5f4dcc3b5aa765d61d8327deb882cf99"
}'
prompt를 생략하면 주요 요소를 자동으로 인식하고 분해합니다. 기본값은 size: "auto", max_images: 30입니다.
성공 응답
일반 편집은 공통 응답 형식을 사용하며usage.input_images는 실제 참조 이미지 수입니다. 아래는 기본 이미지와 레이어 1개만 발췌한 예시이며 usage는 전체 결과 기준입니다. 따라서 generated_images는 표시된 항목 수보다 큽니다. URL은 구조 예시입니다. 공통 응답
{
"model": "dola-seedream-5-5-261028",
"created": 1784696685,
"data": [
{
"url": "https://example.com/base.jpeg",
"size": "2048x2048",
"output_format": "jpeg",
"z_index": 0
},
{
"url": "https://example.com/layer-1.png",
"size": "1273x265",
"output_format": "png",
"z_index": 1,
"bounding_box": {
"absolute": [383, 120, 1655, 384],
"normalized": [187, 59, 808, 188]
},
"name": "Seedream 제목 텍스트",
"description": "노란색 대형 세리프체의 Seedream 제목 텍스트",
"text_recognition": {
"text": "Seedream",
"lines": [
{
"bounding_box": {
"absolute": [383, 120, 1655, 384],
"normalized": [187, 59, 808, 188]
},
"runs": [
{
"text": "Seedream",
"style": {
"similar_font_family": "Playfair Display",
"foreground_color": "#F5C518",
"bold": true,
"italic": false,
"underline": false,
"strikethrough": false,
"shadow": false,
"translucent": false
}
}
]
}
]
}
}
],
"usage": {
"input_images": 1,
"generated_images": 8,
"output_tokens": 23107,
"total_tokens": 23107
}
}
응답 필드
공통 응답 필드| 추가 필드 | 유형 | 설명 |
|---|---|---|
data[].z_index | integer | 쌓임 순서. 기본 이미지는 0, 레이어는 1부터 시작하며 큰 값일수록 위에 표시 |
data[].name | string | 모델이 생성한 레이어 이름 |
data[].description | string | 레이어 상세 설명 |
data[].bounding_box.absolute | integer[4] | 출력 기본 이미지에서 레이어의 픽셀 좌표 [left, top, right, bottom]. 기본 이미지에는 없음 |
data[].bounding_box.normalized | integer[4] | 같은 좌표를 [0, 1000]으로 정규화한 값. 기본 이미지에는 없음 |
data[].text_recognition | object | 활성화되어 있고 레이어가 정형 인쇄 텍스트일 때만 반환되는 서식 있는 텍스트 OCR |
text_recognition
| OCR 필드 | 유형 | 설명 |
|---|---|---|
text | string | 전체 일반 텍스트. 위에서 아래, 왼쪽에서 오른쪽 순서이며 줄은 \n으로 구분 |
lines[] | array | 텍스트 줄마다 한 항목 |
lines[].bounding_box.absolute / .normalized | integer[4] | 기본 이미지 내 줄 좌표. 같은 경계 상자 규칙 적용 |
lines[].runs[] | array | 스타일 구간. 줄 전체가 같은 스타일이면 한 항목 |
lines[].runs[].text | string | 줄바꿈 없는 구간 텍스트 |
lines[].runs[].style.similar_font_family | string | 가장 유사한 글꼴. 인식 실패 또는 신뢰도 부족 시 unknown |
lines[].runs[].style.foreground_color | string | 알파 값 없는 대문자 #RRGGBB |
lines[].runs[].style.bold | boolean | 굵게 |
lines[].runs[].style.italic | boolean | 글자 자체의 기울임. 레이어 전체 회전이나 원근 기울기는 제외 |
lines[].runs[].style.underline | boolean | 밑줄. 독립 구분선과 표 테두리는 제외 |
lines[].runs[].style.strikethrough | boolean | 취소선 |
lines[].runs[].style.shadow | boolean | 뚜렷한 그림자, 투영 또는 오프셋 발광 |
lines[].runs[].style.translucent | boolean | 텍스트 자체의 반투명 여부. 단순히 밝은 불투명 텍스트는 제외 |
스타일은 자동 인식되므로 원본의 정확한 속성과 차이가 있을 수 있습니다.
레이어 복원: 절대 좌표를 사용하여 레이어를
(right - left) × (bottom - top) 크기로 조정한 뒤 기본 이미지의 (left, top) 위치에 놓으세요. 정규화 좌표를 W × H 캔버스에 적용하면 왼쪽 위 위치는 (left / 1000 × W, top / 1000 × H)입니다. z_index가 작은 순서부터 쌓으세요.결과 URL은 24시간 후 만료되므로 즉시 다운로드하여 저장하세요.
