소개
공통 모델 참조 문서입니다. 복사 가능한 요청은 사용 사례별 문서에서 확인하세요: 텍스트-이미지 · 이미지-이미지인증
플랫폼의 API 키 페이지에서 키를 생성하세요. 프런트엔드 코드, 공개 저장소 또는 클라이언트 패키지에 키를 포함하지 마세요.모델 정보
엔드포인트
POST https://api.gravitex.ai/v1/images/edits도 같은 JSON 요청 본문을 받습니다. 두 경로는 동일한 업스트림 이미지 엔드포인트로 전달됩니다.
요청 매개변수
prompt
생성과 편집에서는 필수이며 분해에서는 선택 사항입니다. 중국어는 300자 이내, 영어는 600단어 이내를 권장합니다. 대화형 편집: 이미지-이미지image
참조 이미지 형식과 제한size
이미지 생성과 일반 편집에서는 다음 형식 중 하나를 사용하세요:- 해상도 단계:
1K,1.5K,2K(기본값). 프롬프트에 원하는 화면 비율이나 용도를 설명하세요. - 사용자 지정
WIDTHxHEIGHT: 소문자x를 사용하세요. 총 픽셀 수는[921600, 4624220], 가로/세로 비율은[1/16, 16]이어야 합니다.
레이어 분해는
1K, 1.5K, 2K, auto(기본값)만 지원하며 사용자 지정 픽셀 크기는 지원하지 않습니다. 기본 이미지는 size와 원본 비율을 따르고 각 레이어는 선택한 해상도 단계에 가까운 크기로 자체 비율을 유지합니다. auto는 원본 크기를 사용하되 비율을 유지하면서 1K–2K 범위로 조정합니다.
단계별 일반적인 크기(예시에 한정되지 않음):
optimize_prompt_options
{"optimize_prompt_options":{"mode":"standard"}}를 사용하세요.
background
사용 조건 및 예제layer_decomposition
사용 조건 및 예제layer_decomposition_options
사용 조건 및 예제safety_identifier
최대 64자의 고정된 고유 영문 문자열을 사용하세요. 사용자 ID나 이메일의 해시를 권장하며 요청에 포함하면 응답에 그대로 반환됩니다.성공 응답
일반 생성은 이미지 1장을 반환합니다. 입력 이미지 사용량은 실제 입력 수를 반영합니다. 아래 URL은 응답 구조 예시입니다.응답 필드
추가 레이어/OCR 필드 및 레이어 복원
URL 결과는 24시간 이내에 다운로드하여 저장하세요.
요금
계산식: 참조 이미지 요금 + 각 출력 이미지의 실제 픽셀 구간별 요금 합계.- 공식 기본 가격이며 실제 요금에는 토큰 그룹 배율이 적용됩니다. 모델 광장의 가격을 확인하세요.
- 성공적으로 생성된 이미지만 과금합니다. 검토 거부 등으로 출력되지 않은 이미지는 과금하지 않습니다.
- 기본 이미지와 각 레이어는 별도 출력 이미지이며 각각 실제 픽셀 수로 요금 구간을 정합니다.
max_images 상한은 100장입니다. 비용에 맞게 적절한 제한을 설정하세요.
예시:
- 참조 2장 + 2048×2048 출력 1장:
2 × 0.008 + 0.035 = 0.051 USD. - 참조 1장 + 2048×2048 기본 이미지 1장 + 1K 이하 레이어 6개:
0.008 + 0.035 + 6 × 0.020 = 0.163 USD.
