圖片與影片生成

本區整理 PopGo 對外提供的圖片與影片模型。所有範例都使用 PopGo 統一的 OpenAI 相容 API；目前可用狀態、價格與能力以即時模型與價格頁為準。

開始前

1. 將客戶端 Base URL 設為 https://api.popgo.site/v1。
2. 使用 Authorization: Bearer YOUR_API_KEY 認證。
3. 從模型與價格頁複製公開模型 ID，替換 YOUR_MODEL。
4. 先驗證最小的文生圖或短影片請求，再加入參考素材或高成本選項。

公開模型

類型	模型
圖片	gpt-image-2、gpt-image-2 4K
圖片	nano-banana-1、nano-banana-2
圖片	grok-imagine-image、grok-imagine-image-quality
影片	grok-imagine-video、grok-imagine-video-1.5
影片	kling-video-v3、kling-video-v3-omni、kling-video-v3-turbo
影片	seedance-2.5-B、seedance2.0-F-1080p、seedance2.5-A、seedance2.0-B、seedance2.0-fast-F-720p、seedance2.0-F-720p、seedance2.0-E-720p、seedance2.0-fast-B、seedance2.0-A、seedance-2.0-C

同一列的模型具有相近協定，但限制不一定相同。請在模型頁確認解析度、時長、參考素材與計費維度。

Endpoint 速查

用途	方法	PopGo 路徑
文生圖	POST	/v1/images/generations
圖片編輯	POST	/v1/images/edits
建立影片任務	POST	/v1/videos
查詢影片任務	GET	/v1/videos/{task_id}
下載影片	GET	/v1/videos/{task_id}/content

客戶端只需使用 PopGo 公開路徑，不需要知道渠道的內部建立或輪詢路徑。

參考素材

• 圖片編輯通常使用 multipart/form-data，並以 image 欄位上傳檔案。
• 影片參考 URL 必須是服務端可直接取得的公開直連，不可要求登入、Cookie 或分享頁跳轉。
• Base64 輸入必須是完整 Data URL，例如 data:image/png;base64,...，不可使用沒有 MIME 前綴的裸 Base64。
• 圖片、影片、音訊、首尾幀與數量限制依模型而不同。