DEVELOPER BETA / FAQ
先把 API 邊界說清楚,再決定要不要加入 Beta。
給正在評估 API 與真實影像工作流的開發者:這裡把目前能做什麼、還不能做什麼,以及 Beta 如何申請說清楚。
這個 Beta 面向有明確圖像工作流、願意提供真實回饋的開發者、創作者與小型團隊。候補申請是提供姓名/團隊、Email 與使用情境,讓團隊先篩選適用性;送出申請不等於立即取得存取權,也不是自動開通。申請入口會回到首頁的 Beta 表單。
目前沒有公開的自助試用流程或免費生成額度。候補申請只是提供使用情境給團隊篩選,不代表試用;首頁所說尚未驗證的生成流程不收費,也不等於保證有免費試用。付費 Beta 是另一個人工確認流程:團隊確認適用情境、付款與開通後才開始,沒有訂閱或即時啟用。
目前 pricing content 的付費 Beta 是單次 US$99,不是月費或年費。Stripe 尚未可用,現在沒有 checkout、hosted payment link 或 Stripe iframe;送出申請後,由團隊人工確認付款方式與開通條件。申請本身不會自動扣款或立即啟用。
預計的 API contract 是 POST /api/image-to-image,使用 Authorization: Bearer <api-key>,body 需要 sourceImageRef、非空的 prompt,以及非空的 generationParams JSON object。實際處理前會先解析生成供應商;目前 resolver 回傳 IMAGE_PROVIDER_NOT_CONFIGURED,所以請求會回 HTTP 503,不會建立 task,也不能把這個輸入契約當成目前已可生成的保證。
登入後到 /dashboard/api-keys 建立或撤銷金鑰。完整 secret 只在建立當下回傳一次,資料庫只保存不可逆 hash;之後呼叫圖像 API 要使用 Authorization: Bearer <secret>。未知、撤銷或格式不正確的 key 都會被拒絕,請把建立時取得的 secret 放在安全的 server-side secret store。
介面設計為非同步 task,狀態包含 queued、processing、completed 與 failed,並可帶有相應時間、錯誤及 output ref 欄位。不過目前生成供應商尚未配置,合法的圖像轉圖像請求會先回 HTTP 503,還不會進入 queued task;這是現階段 Beta 邊界。
使用 GET /api/image-to-image/:taskId 查詢,而且必須使用建立該 task 的同一個 user/API key scope。成功回應只包含狀態欄位,不會回傳 prompt、來源圖或 generation params。未授權是 401;不存在、別的 key 建立的 task,以及 legacy task 共用 404,不會讓不同 key 讀到彼此的資料。
登入後可在 /dashboard/callbacks 保存 HTTP(S) endpoint,並用 POST /api/callbacks/test 發送固定的 developer.callback.test JSON;接收端回任何 2xx 才算測試成功。目前沒有在 image task 完成時派送 callback 的 worker 或呼叫路徑,因此不承諾生成完成通知、事件篩選、簽章或重試。
目前不宣稱任何實際 vendor 或 credential 已配置。可觀察到的狀態是 IMAGE_PROVIDER_NOT_CONFIGURED/HTTP 503;resolver 在生成前擋下請求,且錯誤訊息不會洩露 provider secret。這是申請前應知道的 Beta 前提:候補申請可以讓團隊評估你的情境,但不保證當下已有可用生成路徑。