메인 콘텐츠로 건너뛰기
POST
/
v1
/
images
/
generations
Create image
curl --request POST \
  --url https://api.dgrid.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A cute baby sea otter wearing a beret",
  "model": "dall-e-3",
  "size": "1024x1024"
}
'
{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>",
      "revised_prompt": "<string>"
    }
  ],
  "usage": {
    "total_tokens": 123,
    "input_tokens": 123,
    "output_tokens": 123,
    "input_tokens_details": {
      "text_tokens": 123,
      "image_tokens": 123
    }
  }
}
이 페이지는 이미지 생성과 동일한 images/generations 작업을 사용하며, 위의 플레이그라운드에는 일반적인 OpenAI 스타일 이미지 스키마(prompt, model, size 등)가 미리 입력되어 있습니다. 아래 내용은 wanx-v1 스타일 모델을 위한 Qwen 전용 요청 형식을 설명합니다.
Qwen 이미지 모델은 최상위 prompt 필드 대신 프롬프트를 input.messages 안에 포함하는 대체 요청 형식을 사용합니다. 이 형식을 사용하려면 플레이그라운드의 요청 본문에 model과 input을 함께 제공하세요.

​
Qwen 전용 요청 필드

필드유형필수설명
modelstring예wanx-v1과 같은 모델 식별자입니다.
inputobject예최상위 prompt 대신 요청에 전달되는 입력 래퍼 객체입니다.
input.messagesarray예input 하위에 중첩된 메시지 배열입니다.
input.messages[].rolestring예메시지 역할입니다 (예: user).
input.messages[].contentstring예원하는 이미지를 설명하는 프롬프트 텍스트입니다.
플레이그라운드에 표시된 표준 prompt/size/quality 필드와 달리, Qwen의 wanx-v1 모델은 input.messages[].content에서 프롬프트를 읽습니다. n 및 response_format과 같은 다른 최상위 필드는 이 형식에서 사용되지 않습니다.

​
예시: 이미지 생성

{
  "model": "wanx-v1",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": "A serene mountain lake at dawn, photorealistic."
      }
    ]
  }
}

​
응답 필드

응답은 표준 이미지 생성 형식을 따릅니다.
​
created
integer
생성 타임스탬프입니다.
​
data
array
생성된 이미지 항목입니다.

​
응답 예시

200
{
  "created": 1719859200,
  "data": [
    {
      "url": "https://cdn.dgrid.ai/generated/abc123.png",
      "b64_json": "",
      "revised_prompt": "A serene mountain lake at dawn with mist rising off the water, photorealistic."
    }
  ]
}

인증

​
Authorization
string
header
필수

Your DGrid API key. All endpoints use Authorization: Bearer <DGRID_API_KEY>.

본문

application/json
​
prompt
string
필수

Image prompt.

​
model
string
기본값:dall-e-2

Model such as dall-e-2 or dall-e-3.

​
n
integer
기본값:1

Number of images to generate.

​
quality
enum<string>
기본값:standard
사용 가능한 옵션:
standard,
hd
​
response_format
enum<string>
기본값:url
사용 가능한 옵션:
url,
b64_json
​
size
string
기본값:1024x1024

Output size.

​
style
enum<string>
기본값:vivid
사용 가능한 옵션:
vivid,
natural
​
user
string

End-user identifier.

응답

Generated images.

​
created
integer

Creation timestamp.

​
data
object[]

Generated image entries.

​
usage
object