跳到正文
土土金API

API 參考

Midjourney 繪圖任務

Midjourney 非同步繪圖介面:POST /mj/submit/imagine 等提交任務,GET /mj/task/{id}/fetch 輪詢結果。相容常見的 Midjourney Proxy 協議,含放大、變換、擴圖、局部重繪、圖生文、影片的請求示例與按次計費說明。

Midjourney 是非同步任務介面,用法和 OpenAI 格式的同步介面不同:先提交任務拿到任務 ID,再輪詢查詢,直到出圖。路徑和欄位相容常見的 Midjourney Proxy 協議,已經寫好的 MJ 程式碼把地址換成 https://www.tutujin.com、Key 換成本站的即可。

POSThttps://www.tutujin.com/mj/submit/imagine

請求頭

請求頭必填說明
Authorization是Bearer sk-...,控制台建立的 API Key。Midjourney Proxy 客戶端常用的 mj-api-secret: sk-... 也可以
Content-Type是application/json

請求體裡不需要 model 欄位:呼叫哪個介面、執行哪個動作,就按對應的模型計費。

介面一覽

介面用途計費模型
POST /mj/submit/imagine文生圖,base64Array 可帶墊圖mj_imagine
POST /mj/submit/action點結果裡的按鈕:放大、變換、強 / 弱變換、重新生成、擴圖、平移mj_upscale、mj_variation、mj_high_variation、mj_low_variation、mj_reroll、mj_zoom、mj_pan
POST /mj/submit/modal局部重繪、自定義擴圖的第二步mj_modal
POST /mj/submit/describe圖生文:根據圖片反推提示詞mj_describe
POST /mj/submit/edits按提示詞編輯圖片mj_edits
POST /mj/submit/video文 / 圖生影片,一次生成 4 段mj_video
POST /mj/submit/upload-discord-images上傳圖片,換取可在提示詞裡引用的圖片地址mj_upload
GET /mj/task/{id}/fetch查詢單個任務免費
POST /mj/task/list-by-condition按 {"ids": [...]} 批次查詢免費

各操作的單價見本頁底部的模型列表或模型廣場。目錄裡沒有列出的操作(目前包括 Blend、Shorten、換臉)暫不支援,請求會返回「無可用渠道」,不會扣費。

請求參數

參數類型用於說明
promptstringimagine、edits、video、modal提示詞,可以帶 --ar 16:9 等 Midjourney 參數。--fast、--relax、--turbo 會被忽略,速度檔位由本站固定
base64Arrayarrayimagine、upload圖片陣列,每項是 data:image/png;base64,...。imagine 中作為墊圖
taskIdstringaction、modal要繼續操作的原任務 ID
customIdstringaction按鈕 ID,從原任務結果的 buttons 裡取,決定執行哪個操作
maskBase64stringmodal局部重繪的蒙版圖片(base64)
base64stringdescribe要反推提示詞的圖片(base64)
imagestringedits、video參考圖或影片首幀的圖片地址
motionstringvideo運動幅度,low 或 high

請求示例

先提交 imagine,再輪詢任務直到 status 為 SUCCESS 或 FAILURE:

curl https://www.tutujin.com/mj/submit/imagine \
  -H "Authorization: Bearer $TUTUJIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "一只在窗边晒太阳的橘猫,水彩风格 --ar 3:2"
  }'

# 用上一步返回的 result(任务 ID)查询
curl https://www.tutujin.com/mj/task/$TASK_ID/fetch \
  -H "Authorization: Bearer $TUTUJIN_API_KEY"

出圖通常需要幾十秒到一兩分鐘,輪詢間隔 3–10 秒即可,不必更頻繁。

繼續操作:放大、變換、擴圖、平移

任務完成後,結果裡的 buttons 就是 Midjourney 介面上的按鈕。把按鈕的 customId 和原任務 ID 一起提交到 /mj/submit/action,會生成一個新任務,用同樣的方式輪詢:

cURL
curl https://www.tutujin.com/mj/submit/action \
  -H "Authorization: Bearer $TUTUJIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "1794500000000001",
    "customId": "MJ::JOB::upsample::1::2f4a9c1e7b3d5a8f0c6e1b92"
  }'

upsample 對應放大(U1–U4、2x / 4x 放大),variation 對應變換(V1–V4),reroll 是重新生成,Outpaint 是擴圖,pan_* 是平移。

局部重繪(Vary Region)和自定義擴圖分兩步:先用 action 提交 Inpaint 或 CustomZoom 按鈕,返回 code 21 和一個新的任務 ID,這一步不扣費;再把這個 ID 連同新的 prompt(局部重繪還要 maskBase64 蒙版)提交到 /mj/submit/modal,按 mj_modal 計費。

響應示例

提交成功:

JSON
{ "code": 1, "description": "Submit success", "result": "1794500000000001" }

查詢結果:

JSON
{
  "id": "1794500000000001",
  "action": "IMAGINE",
  "status": "SUCCESS",
  "progress": "100%",
  "imageUrl": "https://www.tutujin.com/mj/image/1794500000000001",
  "failReason": "",
  "buttons": [
    { "customId": "MJ::JOB::upsample::1::2f4a9c1e7b3d5a8f0c6e1b92", "label": "U1" },
    { "customId": "MJ::JOB::variation::1::2f4a9c1e7b3d5a8f0c6e1b92", "label": "V1" }
  ]
}
欄位說明
code提交結果:1 成功;21 表示需要再提交 modal(局部重繪、自定義擴圖);其他值表示失敗,見 description
result任務 ID
statusNOT_START、SUBMITTED、IN_PROGRESS、SUCCESS、FAILURE
progress進度,例如 67%
imageUrl結果圖(四宮格或放大後的單圖),經本站域名中轉;拿到後儘快下載儲存
videoUrlsvideo 任務生成的影片地址
promptEndescribe 任務反推出的提示詞
buttons可繼續執行的操作
failReason失敗原因

計費

  • 按次計費,每個操作對應一個模型名,價格見下方列表。提交成功(code 為 1)才扣費;提交被拒絕不扣費,任務最終失敗會退回。
  • 所有放大按鈕(U1–U4、2x、4x)都按 mj_upscale 計費,擴圖按 mj_zoom 計費,同一模型名下的不同按鈕價格相同。
  • 局部重繪、自定義擴圖的第一步不扣費,第二步按 mj_modal 計費。
  • 查詢任務免費。

注意事項

  • 這個介面是非同步的:不要在一個 HTTP 請求裡等結果,提交後儲存任務 ID,輪詢或稍後再查。
  • 不支援回呼(notifyHook 會被忽略),請用輪詢獲取結果。
  • 速度檔位由本站固定,提示詞裡的 --fast、--relax、--turbo 不起作用。
  • 提示詞觸發 Midjourney 的內容審核時,提交會失敗或任務以 FAILURE 結束,修改提示詞後再提交。
  • 結果圖地址只適合短期使用,下載後轉存到自己的儲存。

支援此介面的模型

模型廠商最低價分組輸入 ¥/百萬輸出 ¥/百萬按次 ¥/次
Midjourney UploadMidjourney標準——¥0.02
Midjourney DescribeMidjourney標準——¥0.1
Midjourney ImagineMidjourney標準——¥0.4
Midjourney VariationMidjourney標準——¥0.4
Midjourney Vary (Strong)Midjourney標準——¥0.4
Midjourney Vary (Subtle)Midjourney標準——¥0.4
Midjourney RerollMidjourney標準——¥0.4
Midjourney UpscaleMidjourney標準——¥0.4
Midjourney Zoom OutMidjourney標準——¥0.4
Midjourney PanMidjourney標準——¥0.4
Midjourney Vary Region / Custom ZoomMidjourney標準——¥0.4
Midjourney EditMidjourney標準——¥0.4
Midjourney VideoMidjourney標準——¥2.8

價格為人民幣,取各模型最低價分組;價格更新於 2026年11月13日 下午6:08。

沒找到答案?加客服微信 JsnonoChat,傳送報錯資訊裡的 request id,我們幫你排查。