Skip to content

이미지

이미지 API는 Gemini 네이티브 이미지 생성, OpenAI 호환 이미지 엔드포인트, Qwen 호환 이미지 워크플로를 포함합니다.

Gemini 네이티브 형식

공급자 네이티브 멀티모달 응답 제어가 필요하면 Gemini generateContent 인터페이스로 이미지를 생성하세요.

POST
https://api.dgrid.ai
POST/v1/models/{model}:generateContent
Authorization
Authorization: Bearer <DGRID_API_KEY>
Request
application/json
Response
200 · application/json

요청 본문

필드타입필수설명
contentsarray입력 콘텐츠 배열입니다.
contents[]object현재 예시는 빈 객체를 하나 포함한 배열을 전송합니다.
generationConfigobject이미지 생성 설정입니다.
generationConfig.responseModalitiesarray반환할 모달리티 목록입니다.
generationConfig.imageConfigobject이미지 설정입니다.
generationConfig.imageConfig.aspectRatiostring이미지 종횡비입니다.
generationConfig.imageConfig.imageSizestring이미지 크기입니다.

응답 본문

필드타입설명
candidatesarray모델이 반환한 후보 응답 목록입니다.
candidates[].contentobject후보 콘텐츠 객체입니다.
candidates[].content.rolestring응답 콘텐츠 역할입니다.
candidates[].content.partsarray반환된 콘텐츠 파트 목록입니다.
candidates[].finishReasonstring생성 종료 이유입니다.
candidates[].safetyRatingsarray안전 평가 결과입니다.
usageMetadataobjecttoken 사용량 메타데이터입니다.
usageMetadata.promptTokenCountinteger입력 token 수입니다.
usageMetadata.candidatesTokenCountinteger출력 token 수입니다.
usageMetadata.totalTokenCountinteger총 token 수입니다.

OpenAI 채팅 형식

OpenAI 호환 클라이언트에서 Gemini 기반 이미지 생성을 요청하려면 Chat Completions 엔드포인트를 사용할 수 있습니다.

POST
https://api.dgrid.ai
POST/v1/chat/completions
Authorization
Authorization: Bearer <DGRID_API_KEY>
Request
application/json
Response
200 · application/json

요청 본문

필드타입필수설명
modelstringGemini 기반 모델 ID입니다.
streamboolean현재 예시는 true 를 전송합니다.
messagesarray채팅 메시지 배열입니다.
messages[]object현재 예시는 빈 객체를 하나 포함합니다.
contentsarray현재 예시는 추가 contents 배열도 함께 전송합니다.

응답 본문

필드타입설명
idstringcompletion 식별자입니다.
modelstring응답을 생성한 모델입니다.
objectstring최상위 객체 타입입니다.
createdinteger생성 타임스탬프입니다.
choicesarray반환된 choice 목록입니다.
choices[].indexintegerchoice 인덱스입니다.
choices[].messageobject어시스턴트 메시지 객체입니다.
choices[].message.rolestring응답 역할입니다.
choices[].message.contentstring응답 콘텐츠입니다.
choices[].finish_reasonstring종료 이유입니다.
usageobjecttoken 사용량 정보입니다.

OpenAI 이미지 생성

OpenAI 호환 images/generations 엔드포인트로 이미지를 생성합니다.

POST
https://api.dgrid.ai
POST/v1/images/generations
Authorization
Authorization: Bearer <DGRID_API_KEY>
Request
application/json
Response
200 · application/json

요청 본문

필드타입필수기본값설명
promptstring-이미지 프롬프트입니다.
modelstring아니오dall-e-2dall-e-2, dall-e-3 등의 모델입니다.
ninteger아니오1생성할 이미지 수입니다.
qualitystring아니오standardstandard 또는 hd.
response_formatstring아니오urlurl 또는 b64_json.
sizestring아니오1024x1024출력 크기입니다.
stylestring아니오vividvivid 또는 natural.
userstring아니오-최종 사용자 식별자입니다.

응답 본문

필드타입설명
createdinteger생성 타임스탬프입니다.
dataarray생성된 이미지 목록입니다.
data[].urlstringURL 출력일 때의 이미지 링크입니다.
data[].b64_jsonstringBase64 출력일 때의 이미지 데이터입니다.
data[].revised_promptstring모델이 보정한 프롬프트입니다.

OpenAI 이미지 편집

선택적 mask와 함께 업로드한 이미지를 수정하려면 OpenAI 호환 이미지 편집 엔드포인트를 사용하세요.

POST
https://api.dgrid.ai
POST/v1/images/edits
Authorization
Authorization: Bearer <DGRID_API_KEY>
Request
multipart/form-data
Response
200 · application/json

Form Data

필드타입필수설명
imagefilePNG 형식의 원본 이미지, 4 MB 미만.
maskfile아니오선택적 마스크 이미지입니다.
promptstring편집 지시문입니다.
modelstring아니오대상 이미지 모델입니다.
ninteger아니오출력 이미지 수입니다.
sizestring아니오출력 크기입니다.
response_formatstring아니오응답 형식입니다.
userstring아니오최종 사용자 식별자입니다.

응답 본문

응답은 OpenAI 이미지 생성 스키마와 동일하며 data[].url 또는 data[].b64_json 을 반환합니다.

Qwen 이미지 생성

Qwen 호환 OpenAI 이미지 엔드포인트를 통해 `wanx-v1` 같은 모델에 생성 요청을 보낼 수 있습니다.

POST
https://api.dgrid.ai
POST/v1/images/generations
Authorization
Authorization: Bearer <DGRID_API_KEY>
Request
application/json
Response
200 · application/json

요청 본문

필드타입필수설명
modelstring모델 ID, 예: wanx-v1.
inputobject입력 객체입니다.
input.messagesarray입력 메시지 배열입니다.
input.messages[]object현재 예시는 빈 객체를 하나 포함합니다.

응답 본문

필드타입설명
createdinteger생성 타임스탬프입니다.
dataarray생성된 이미지 결과 목록입니다.
data[].urlstring이미지 URL입니다.
data[].b64_jsonstringBase64 인코딩 이미지 데이터입니다.
data[].revised_promptstring수정 또는 정규화된 프롬프트입니다.

Qwen 이미지 편집

Qwen 호환 이미지 편집 플로우로 업로드한 이미지를 수정할 수 있습니다.

POST
https://api.dgrid.ai
POST/v1/images/edits
Authorization
Authorization: Bearer <DGRID_API_KEY>
Request
application/json
Response
200 · application/json

요청 본문

필드타입필수설명
modelstringQwen 이미지 모델 ID입니다.
inputobject입력 객체입니다.
input.messagesarray입력 메시지 배열입니다.
input.messages[]object현재 예시는 빈 객체를 하나 포함합니다.

응답 본문

필드타입설명
createdinteger생성 타임스탬프입니다.
dataarray생성된 이미지 결과 목록입니다.
data[].urlstring이미지 URL입니다.
data[].b64_jsonstringBase64 인코딩 이미지 데이터입니다.
data[].revised_promptstring수정 또는 정규화된 프롬프트입니다.