Pure Tokens 圖片
只調用固定 Pure Tokens Images API：https://api.puretokensx.com/v1/images/generations，編輯僅在精確模型資料聲明時調用 /v1/images/generations 或 /v1/images/edits。每次都使用完整固定 URL，不使用已配置 Base URL 作為請求目標，也不檢查 provider 名稱。
當前宿主使用其已有認證 HTTPS/API 能力，以當前匹配 Pure Tokens 連接的憑證完成請求；憑證僅可在記憶體中用於這一次固定請求。第三方 CC Switch 與手動宿主配置都可作為該連接來源。不得顯示、索取、保存、記錄或報告 Key、Base URL、請求頭、完整宿主配置、原始回應或用戶媒體；不得使用 Node、MCP、代理、sidecar、獨立上傳或備用 endpoint。
按需讀取資料
不要在每個請求載入全部模型和全部異常場景。按下列順序最少讀取：
- 先讀
references/model-index.json：解析預設模型或唯一別名，並取得精確 profile 路徑。 - 只讀被選中模型的
references/profiles/<model>.json：檢查參數、約束、operation 和 lifecycle。未在索引中的精確模型只允許核心文生圖欄位；只有用戶要求額外參數、參考圖或編輯時，才按需查詢即時目錄。 - 一般核心 POST 可只依據本 Skill、索引和選中 profile 執行；收到回應後、進入輪詢/交付時，或構造編輯等非核心 operation 時，再讀
references/execution-contract.json與references/task-receipt.json。 - 只有出現對應異常、歧義、拒絕、附件或交付問題時，才讀
references/behavior-scenarios.json中的匹配場景。
模型與請求
- 一般文生圖預設
gpt-image-2；image2是其唯一別名。用戶給出唯一別名時使用索引映射；零個或多個候選時列出精確 ID，請用戶選擇。用戶給出精確 ID 時保留該 ID，一般核心請求不得為確認權限或能力而預讀目錄。 - 一般請求只提交一次
POST /v1/images/generations，始終帶model、prompt、async: true。僅當精確 profile 聲明時才帶n、size、image_size、aspect_ratio、width、height、strength或其他可選欄位及值。 - 一次用戶請求只能建立一個付費任務，絕不拆單。
n必須被 profile 明確允許；否則說明一次僅支援一張或請用戶選支援該數量的模型。 200cm × 230cm等物理尺寸不能傳 API。說明無法精確保證物理尺寸，並列出 profile 實際聲明的像素尺寸、語義尺寸或比例選項。width、height被聲明為必須成對時，缺一即停止；多個尺寸表達同時給出時，只按 profile 的優先級提交一種。- 只有用戶明確問當前模型、所需參數/operation 不在本地 profile、附件 transport 不相容，或 API 因模型/參數/capability 拒絕後需要解釋時，才讀取一次
GET https://api.puretokensx.com/v1/media/models。目錄讀取失敗不能阻止本來合法的核心文生圖，也不觸發自動重試。
參考圖與編輯
- 用戶附圖但沒說明用途時，先問它是視覺參考還是待編輯圖片；不得猜測。
- 公網圖片只接受用戶明確提供的合規
https://URL，並且只能放入 profile 聲明的欄位和 transport。不得下載、探測、轉存、改寫或產生 URL。 - 本地圖片參考或編輯必須由選中 profile 的
image_editmultipart operation 明確支援，嚴格使用其路徑、欄位、數量和multipart_filetransport。只將當前附件隨這一次 Images API 請求發送；不得上傳到 R2、呼叫獨立上傳介面、產生 file ID、把附件內容轉寫成提示詞，或靜默降級為文生圖。 - 參考圖提示詞保留「參考」的意圖；編輯提示詞明確「修改什麼、保留什麼」。mask、透明背景、未聲明的多參考圖和其他未聲明擴展均在計費前停止並說明限制。
非同步任務與交付
- 每個新請求最多一次 POST。若 POST 可能開始但沒有可解析結果或任務 ID，提交結果為未知：不重提、不換模型、不聲稱未建立、未扣費或已退款。無任務 ID 時，後續新建請求必須得到用戶明確確認。
- 只從聲明的頂層欄位或頂層
task_id/id取得 task ID；只查詢同一個https://api.puretokensx.com/v1/images/{task_id}，並在成功後按content?index=0..n-1順序交付。URL、狀態文字、HTML、SVG 不是成功交付。 - 每個輪詢視窗最多 6 次狀態讀取、最多 120 秒；常規等待為 3、6、12、24、30 秒，429 只在有效
Retry-After仍符合本輪預算時繼續同一任務。無後台輪詢、無並發狀態讀取、無自動重提。 - 只有宿主實際交付原生圖片位元組或附件時才報告成功。逐張交付，不預取、不重複讀取、不緩存用戶媒體；成功後結束目前回覆。
失敗回執
宿主在 POST 前因網路、審批、附件傳遞或原生位元組交付能力被阻止時，返回 failure_phase: validation，明確 Images API 未執行，且不猜測配置原因。其他失敗按 execution-contract.json 和匹配行為場景輸出安全回執：只報告 API 實際傳回的 HTTP 狀態和公開錯誤碼；不暴露原始回應、內部 URL、堆疊、憑證、請求內容或用戶媒體。