Qwen 圖像生成

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"
}
'

import requests

url = "https://api.dgrid.ai/v1/images/generations"

payload = {
    "prompt": "A cute baby sea otter wearing a beret",
    "model": "dall-e-3",
    "size": "1024x1024"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    prompt: 'A cute baby sea otter wearing a beret',
    model: 'dall-e-3',
    size: '1024x1024'
  })
};

fetch('https://api.dgrid.ai/v1/images/generations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dgrid.ai/v1/images/generations"

	payload := strings.NewReader("{\n  \"prompt\": \"A cute baby sea otter wearing a beret\",\n  \"model\": \"dall-e-3\",\n  \"size\": \"1024x1024\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	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.dgrid.ai/v1/images/generations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"A cute baby sea otter wearing a beret\",\n  \"model\": \"dall-e-3\",\n  \"size\": \"1024x1024\"\n}")
  .asString();

{
  "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
    }
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

POST

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"
}
'

import requests

url = "https://api.dgrid.ai/v1/images/generations"

payload = {
    "prompt": "A cute baby sea otter wearing a beret",
    "model": "dall-e-3",
    "size": "1024x1024"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    prompt: 'A cute baby sea otter wearing a beret',
    model: 'dall-e-3',
    size: '1024x1024'
  })
};

fetch('https://api.dgrid.ai/v1/images/generations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dgrid.ai/v1/images/generations"

	payload := strings.NewReader("{\n  \"prompt\": \"A cute baby sea otter wearing a beret\",\n  \"model\": \"dall-e-3\",\n  \"size\": \"1024x1024\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	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.dgrid.ai/v1/images/generations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"A cute baby sea otter wearing a beret\",\n  \"model\": \"dall-e-3\",\n  \"size\": \"1024x1024\"\n}")
  .asString();

{
  "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
    }
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

本頁使用與建立圖像相同的 images/generations 操作，上方 playground 已預先填入通用的 OpenAI 風格圖像結構（prompt、model、size 等）。以下說明 wanx-v1 類模型的 Qwen 專用請求格式。

Qwen 圖像模型接受另一種請求格式：將 prompt 包在 input.messages 中，而不是使用頂層 prompt 欄位。若要使用這種格式，請在 playground 的請求本文中同時提供 model 與 input。

Qwen 專用請求欄位

欄位	類型	必填	說明
`model`	string	是	模型識別碼，例如 `wanx-v1`。
`input`	object	是	請求中傳送的輸入包裝物件，用來取代頂層 `prompt`。
`input.messages`	array	是	巢狀於 `input` 之下的 messages 陣列。
`input.messages[].role`	string	是	訊息角色，例如 `user`。
`input.messages[].content`	string	是	描述目標圖像的 prompt 文字。

與 playground 中顯示的標準 prompt、size、quality 欄位不同，Qwen 的 wanx-v1 模型會從 input.messages[].content 讀取 prompt。像 n 與 response_format 這類其他頂層欄位，並不適用於此格式。

範例：生成圖像

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

回應欄位

回應遵循標準圖像生成結構：

integer

建立時間戳。

array

生成圖像條目。

顯示 data item properties

string

圖像 URL。

string

Base64 圖像負載。

string

模型回傳的修訂 prompt。

回應範例

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

OpenAI format
Qwen format

prompt

string

必填

Image prompt.

model

string

預設值:dall-e-2

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

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.

Show child attributes

usage

object

Show child attributes

建立圖像

編輯圖像

新手入門

模型 API

管理 API 金鑰

X402 API

Qwen 專用請求欄位

範例：生成圖像

回應欄位

回應範例

授權

主體

回應

​Qwen 專用請求欄位

​範例：生成圖像

​回應欄位

​回應範例

授權

主體

回應

Qwen 專用請求欄位

範例：生成圖像

回應欄位

回應範例