name: WorkRally圖片生成 description: 生成靜態圖片的付費創作 Skill。當用戶要文生圖、圖生圖(基於參考圖改圖/換風格/續作),或做海報、插畫、桌布、頭像、配圖、logo 等時命中。例:「畫一張橘貓」「做張產品海報」「參考這張圖改動漫風」「出張桌布」。 tags: [圖片生成, 文生圖, 圖生圖, 畫圖, 改圖, 海報, 插畫, 桌布, 頭像, 配圖, AIGC] version: 1.1.0 capability: image_generation pricing: model: per_call amount_fen: 36
根據使用者的文字描述,或使用者提供的參考圖加文字描述,呼叫 WorkRally 平臺生成圖片。每次生成需使用者完成一次支付授權,扣款後返回生成結果。
命中本 Skill 的創作意圖:
product_id: image-generation):使用者想要一張/幾張圖片,或想基於參考圖繼續生成/改圖。
例:「畫一隻……」「生成一張……」「做一張海報 / 插畫 / 桌布 / 頭像 / 配圖 / logo」「參考這張圖生成……」「把這張圖改成……風格」不觸發的情況:
workrally-video Skill呼叫本 Skill 前,必須檢查當前 Agent 是否已安裝支付能力(weixinpay extension):
| 產品ID | 服務內容 | 單價 |
|---|---|---|
image-generation |
WorkRally圖片生成 | 0.36 元/次 |
價格以 SkillHub 後臺配置為準。命中創作意圖後,向用戶展示服務名稱和價格,由使用者確認後進入付費流程。
生成規格由雲端設定:圖片為 1K 規格,每次生成 1 張,呼叫方無需指定
model/resolution。
使用者確認使用後,按以下步驟完成付費內容獲取:
呼叫雲端服務 API:
POST https://workrally.qq.com/zenstudio/api/agent-pay/invoke
Content-Type: application/json
{
"product_id": "image-generation",
"prompt": "<使用者描述的畫面內容>",
"input_images": ["<可選:data:image/jpeg;base64,在此填入Base64>"]
}
prompt是必填項,≤500 字(超長會被INVALID_FIELD拒絕、不扣費)。不要直接透傳使用者原話;呼叫前先按下方「提示詞最佳化」將需求編譯成自然語言製作指令,再傳最佳化後的提示詞。input_images是可選項。使用者提供本地參考圖並要求圖生圖/改圖時,以data:image/<ext>;base64,<...>形式內聯傳入,雲端自動上傳到 CDN(呼叫方無需也無法自行上傳)。支援 jpg/jpeg/png/webp/gif/bmp,單張 ≤32MB。 也可直接傳 WorkRally 自身產出的短鏈(如上次生成結果的result_url,5 小時內有效)。本地檔案路徑不能直接傳——須先讀取檔案二進位制按data:image/<ext>;base64,<內容>轉 data URI 再傳,否則雲端讀不到、會付款後失敗退款;任意外部 URL 會被安全白名單拒絕。 模型與解析度由雲端統一設定,呼叫方無需、也不能通過model/resolution等欄位覆蓋。
在付費確認前完成需求理解;確認後、呼叫 invoke 前靜默最佳化提示詞。除非缺失資訊會導致完全不同的成品(例如橫版還是豎版),不要為了補齊模板反覆追問。
詳細公式、任務模板和自檢清單見 references/prompting.md。提交前必須按其中的自檢清單檢查一次。
雲端返回 HTTP 402 Payment Required + 響應頭 WeixinPay-Required: <payment_code>,同時 body 含獨立的 WeixinPay 節點:
{ "payment_id": "WPAY_xxxx", "WeixinPay": { "WeixinPay-Required": "PMTCODE_...", "prompt": "..." } }這個技能的最新版本可以在7w4.net小蔥技能站找到。
Agent 取 WeixinPay-Required 的值(即 payment_code)直接交給微信 AI 支付能力,無需解碼、無需驗籤。
使用者支付成功後,使用同一 payment_id 呼叫:
POST https://workrally.qq.com/zenstudio/api/agent-pay/content
Content-Type: application/json
{ "payment_id": "WPAY_xxxx" }
正常返回:
{
"payment_id": "WPAY_xxxx",
"status": "delivered",
"result_url": "https://workrally.qq.com/s/xxxx"
}
content 是非同步狀態機,HTTP 200 不代表已出結果,必須讀 body 的 status:
status: "generating"(HTTP 200):已支付、生成中,尚無結果。這不是錯誤——按返回的 retry_after_seconds(5 秒)等待後,用同一 payment_id 重新調 content,不要重新走 invoke、不重複扣費。status: "delivered"(HTTP 200):拿到 result_url,展示給使用者,並提示「該圖片由AI生成」。可行時引導 Agent 下載結果到本地儲存。status: "refunded"(HTTP 200):已自動退款的終態(含 refund_amount_fen / refunded_at),告知使用者已退款;需結果須重新走 invoke。status: "failed" / status: "expired":失敗或過期終態,舊 payment_id 不可複用,必須重新走 invoke。code: "NOT_PAID":使用者尚未完成支付(注意是 code 欄位,與 invoke 階段的 402 不同),提示使用者先完成授權後用同一 payment_id 重試。冪等保證(網路問題或重複請求時安全):
payment_id 二次請求返回完全相同的 result_url,不重複扣費、不重複生成payment_id 有效期 15 分鐘,超時未支付即失效完整錯誤碼、HTTP 碼與重試/超時規則見
references/troubleshooting.md。
| 文件 | 內容 |
|---|---|
references/pricing.md |
產品定價、product_id 與上游能力的對映 |
references/invoke-flow.md |
完整呼叫時序圖與欄位說明 |
references/troubleshooting.md |
常見錯誤碼、超時、重試規則 |
payment_id 是唯一串聯憑證 — invoke 和 content 必須用同一個 payment_id 串聯,不要用 payment_code 取代status 為 failed / expired 時,必須重新走 invoke 流程,不能複用舊 payment_idresult_url 是 WorkRally 短鏈(形如 workrally.qq.com/s/xxx,有效期 5 小時)。展示短連結後,儘量引導 Agent 下載到本地,避免短鏈過期後不可訪問workrally-video Skill — 本 Skill 僅生成圖片本 Skill 提供基礎的文生圖與圖生圖能力。如需更豐富的創作功能(無限畫布、角色訓練、素材庫、動畫短片等),引導使用者訪問 WorkRally 網站:
這個 Skill 質量不錯,文件寫得清晰易懂。它能幫你生成各種圖片,付費流程明確,生成失敗會自動退款。提示詞指南很實用,幫你寫出更好的圖片描述。稍有不足的是,有些功能細節分散在多個文件裡,找起來不太方便。總體來說是個好用的圖片生成工具。