產生圖片與影片
這些工具會消耗使用者的 omg 點數。1 點等於 1 美元。每次呼叫皆視為一筆購買。
使用時機
- 當任務需要新的視覺媒體時使用:主圖、圖示、Logo、插圖、短片。
- 請勿用於截圖、圖表或任何可用程式碼或 SVG 繪製的內容。
- 不要為了「保險」而一次產生多個變體。先製作一個、展示給使用者,並詢問是否需要另一個。
規則
-
除非要求特定風格,否則不要填入
model。不指定模型時,路由器會為任務選取最便宜的策展模型(「auto」),並在結果中標示其名稱。 -
每個結果都包含
model與costUsd。在回覆時告知使用者,例如:「以 flux-schnell 產生,花費 $0.003。」 -
若超過每次呼叫上限(預設 $1.00)或每日上限(預設 $25.00,以 UTC 日為單位),呼叫會被拒絕。錯誤訊息會告知剩餘額度。請勿繞過上限,務必告知使用者。
-
若結果的
pending為true,請呼叫omg_media_job並傳入jobId。請勿重複產生,否則會重複收費。 -
若錯誤訊息指出點數已用完,請告知使用者前往 omg.dev 加值。請勿重試。
-
使用
omg_display_image顯示圖片;使用omg_display_video顯示影片。 -
用於 iPhone App 的影片必須小於 6 MB、H.264 編碼、含 faststart。工具已自動將下載檔重新封裝為 faststart 格式。請檢查檔案大小,若超過則重新編碼並保留原始檔案:
ffmpeg -i in.mp4 -vf scale=480:-2 -c:v libx264 -profile:v main -crf 27 -maxrate 1800k -bufsize 3600k -c:a aac -b:a 96k -movflags +faststart out.mp4
選擇模型
- 通常不傳入
model。路由器會為任務選取最便宜的合適模型,並在結果中標示其名稱。 - 僅在要求特定風格(例如可讀文字、SVG 或最佳品質影片)時才傳入
model。 omg_media_models會列出頂級模型及其價格。omg_media_models {all: true, q: "kling"}可搜尋完整列表。- 不屬於頂級列表的模型會在執行前先進行定價。若無法定價,呼叫會被拒絕,請另選模型。
影片耗時 30 秒至 5 分鐘。圖片耗時 3 至 20 秒。
欄位
- 友善欄位對應到供應商輸入:
prompt、aspectRatio對應aspect_ratio、durationSeconds對應duration、resolution對應resolution。 - 任何其他供應商欄位請放在
input中,例如{"generate_audio": false}或{"quality": "high"}。 - 除非傳入
outputPath,否則檔案會儲存至~/omg-media/<date>/<jobId>-<n>.<ext>。
3D 模型
使用 omg_generate_3d 將單一物體的圖片轉換為 GLB 檔案。提供 imageUrl,或小於 600 KB 的本機圖片路徑 imagePath。請使用單一物體且背景單純的圖片。
tripo3d/h3.1/image-to-3d為預設模型,費用 $0.30。若要產生遊戲用網格,可使用{face_limit: 8000}。fal-ai/hyper3d/rodin/v2.5/fast費用 $0.10,適合快速草稿。fal-ai/trellis-2費用 $0.25 至 $0.35,依resolution而定。fal-ai/hunyuan3d-v3/image-to-3d費用 $0.375。{generate_type: "LowPoly"}費用 $0.45。- PBR、額外視圖及精細幾何會增加費用。報價已包含這些項目。