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返回的 choices。
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-圖像描述。
modelstringdall-e-2模型,例如 dall-e-2dall-e-3
ninteger1生成數量。
qualitystringstandardstandardhd
response_formatstringurlurlb64_json
sizestring1024x1024輸出尺寸。
stylestringvividvividnatural
userstring-終端使用者識別。

回應體

欄位型別說明
createdinteger建立時間戳。
dataarray生成圖像列表。
data[].urlstringURL 形式輸出時的圖像連結。
data[].b64_jsonstringBase64 形式輸出時的圖像內容。
data[].revised_promptstring模型調整後的提示文字。

OpenAI 圖像編輯

透過 OpenAI 相容圖像編輯端點,搭配可選 mask 修改上傳圖像。

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

表單欄位

欄位型別必填說明
imagefile原始圖像,PNG 格式且小於 4 MB。
maskfile可選遮罩圖像。
promptstring編輯指令。
modelstring目標模型。
ninteger輸出數量。
sizestring輸出尺寸。
response_formatstring回應格式。
userstring終端使用者識別。

回應體

回應遵循 OpenAI 圖像生成 schema,包含 data[].urldata[].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修訂或正規化後的提示。