API 參考
Qwen 圖像生成
呼叫 NeonAPI 所需的端點、請求參數與回應結構。
POST /v1/images/generations
身分驗證
將 NeonAPI 金鑰放入 Authorization: Bearer YOUR_API_KEY 請求標頭,在可信應用環境中保管金鑰。
可用性與相容性
呼叫前核對模型的協定、權限、報價與支援參數。不支援的參數可能被拒絕。範例中的金鑰與模型均為佔位符。
本頁記錄目前規格中的 Qwen 格式 JSON 請求。其他圖像模型可能使用 OpenAI 格式 JSON 或 multipart 上傳;請以所選模型發布的格式為準。
請求參數
application/json
| 欄位 | 類型 | 必填 | 限制 | 意義 |
|---|---|---|---|---|
model | string | 是 | — | 模型廣場發布的準確 ID。 |
input | object | 是 | — | 按目前端點格式提供輸入內容。 |
parameters | object | 否 | — | 供應商特定的生成選項。 |
完整欄位定義、巢狀物件和引用結構可在下載的規格中查看。
請求範例
export NEON_API_KEY="YOUR_API_KEY"
curl https://neon-api.com/v1/images/generations \
-H "Authorization: Bearer $NEON_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_MODEL_ID",
"input": {
"messages": [
{
"role": "user",
"content": [
{
"text": "A quiet constellation above a midnight observatory"
}
]
}
]
},
"parameters": {
"n": 1
}
}'回應說明
實際欄位因模型與協定而異。下方結構描述文件中的成功回應;串流請求使用對應協定的事件。
| 狀態碼 | 意義 |
|---|---|
| 200 | 請求成功 |
回應結構
| 欄位 | 類型 | 必填 | 限制 | 意義 |
|---|---|---|---|---|
created | integer | 否 | — | — |
data | object[] | 否 | — | 目前端點回傳的結果項目。 |
另見常見錯誤與串流回應和非同步任務。