即夢API接口怎麼用？開發者調用生圖影片能力教程

更新時間:2026-10-08 21:16:06 發布時間:8小時前閱讀:2 views次

jimeng api developer guide

即夢API就是把即夢的AI生圖和影片能力開放給開發者。你可以用API調用即夢的模型，在自己的應用、網站或者服務裡直接生成圖片和影片，不用讓使用者跳轉到即夢官網。比如你開發了一個電商工具，可以接入即夢API，讓使用者一鍵生成商品圖。這對需要大量AI素材的企業和開發者很有用，省事而且可以定制。

API就是一個接口，開發者可以通過編程方式調用即夢的服務。不用打開網頁，不用手動操作，直接發送請求給即夢的伺服器，就能生成圖片或影片。

字節跳動把即夢的核心能力（AI生圖、AI生影片、圖轉影片等）以API的形式開放出來。開發者申請接入後，就可以在自己的產品裡集成這些能力。這樣使用者可以在你的應用裡體驗AI生成，不用跳轉到第三方。

對即夢來說，API是一種商業模式，企業用API調用服務是要付費的。對開發者來說，API是一種快速賦能的手段，用現成的模型省去了自己訓練模型的成本。

即夢API能幹什麼

AI文生圖

根據文字提示詞生成圖片。開發者發送一段描述（比如”一個穿紅色連衣裙的女性，咖啡店裡，陽光”），API就返回一張生成的圖片。這是最常用的功能。

開發者可以設定圖片的尺寸、風格、生成數量等參數。返回的是圖片的URL或者base64編碼，可以直接用或者保存。

AI圖生影片

把一張靜態圖片轉成影片。上傳一張圖，API會根據圖片內容生成相應的動畫效果。比如人物會眨眼、轉身，背景會有微妙的動畫效果。

這個功能對內容創作者和短影片平臺特別有用。可以快速把靜態素材轉成動態影片素材。

AI文生影片

直接根據文字描述生成影片。不用先生成圖再轉影片，可以一步到位。開發者發送提示詞，即夢就生成一段影片。這個功能的生成時間會比較長，因為影片的訊息量大。

這個功能還比較新，可能不是所有的API套餐都包含，要看開發者的權限。

其他衍生能力

根據即夢產品的發展，API可能還支持擴圖、圖片編輯、素材庫調用這樣的其他功能。具體支持什麼，要看官方的最新文檔。

怎麼申請開通即夢API

第一步：訪問開發者平臺

字節跳動有一個統一的開發者平臺，叫”字節跳動開放平臺”或者”ByteDance Developer Console”。即夢的API就在這個平臺上管理。訪問平臺的官網，用字節帳號（或者綁定的開發者帳號）登入。

如果你沒有字節帳號，需要先註冊。註冊的時候會要求填一些基本訊息。

第二步：創建應用

登入後，在平臺上創建一個新的應用項目。填寫應用名稱、應用類型、應用描述。應用類型要選和你使用場景最接近的，比如”電商工具”、”內容創作平臺”、”SaaS服務”。

應用描述裡要說清楚你計劃怎麼用即夢的API，用途越明確，審核通過率越高。

第三步：申請API權限

創建應用後，在應用設定裡找”API權限”或者”功能申請”的選項。勾選你需要的API能力，比如”文生圖”、”圖生影片”。如果需要多個能力，就都勾上。

然後提交申請。字節會審核你的應用和使用場景，確認你的確需要這些能力，而且不會用來做違規的事情。

第四步：審核和認證

提交後，字節的審核團隊會審核你的應用。審核通常需要1到3個工作日。期間可能會反饋意見，比如要求補充訊息或者修改應用描述。

審核通過後，你就能看到自己的API密鑰（Access Key和Secret Key）。這兩個密鑰是調用API的憑證，一定要妥善保管，不要泄露。

常見的審核駁回原因

應用描述太模糊，看不出真實的使用場景
應用涉及違規內容（比如說要用來生成明星臉）
應用的用途涉及商業競爭（比如直接複製即夢的功能）
開發者訊息不完整或者有問題

如果被駁回，仔細看反饋意見，然後改進應用描述或者其他訊息，重新提交。一般改好後會通過。

API接口怎麼調用

基本流程

調用API的流程是：獲取密鑰 → 構造請求 → 發送請求 → 解析響應 → 處理結果。

開發者用自己熟悉的編程語言（Python、JavaScript、Java等）來實現。字節通常會提供官方的SDK，簡化調用過程。如果沒有現成的SDK，也可以用HTTP請求直接調用。

密鑰管理

每個應用都有唯一的Access Key和Secret Key。調用API時，需要在請求頭裡附加這兩個密鑰，以便伺服器驗證你的身份和權限。

密鑰是敏感訊息，千萬不要硬寫在程式碼裡或者上傳到GitHub。應該保存在環境變量或者配置檔案裡，確保只有你的伺服器能訪問。如果密鑰泄露，要立即在開發者平臺裡重新生成。

文生圖請求示例

一個典型的文生圖請求會包含這些參數：

prompt（提示詞）：你要生成什麼內容。比如”一個穿白色連衣裙的女性，在花園裡，陽光，攝影風格”
width、height（圖片尺寸）：寬和高，通常支持常見的比例，比如1024×1024、768×1024這樣的
num_samples（生成數量）：一次生成多少張圖。通常范圍是1到4
style（風格）：可選，指定圖片風格，比如”攝影”、”插畫”、”3D”
seed（隨機種子）：可選，如果給定相同的seed，就能生成相同的圖，便於復現結果

發送這個請求後，API會返回一個包含生成圖片URL的響應。響應通常是JSON格式，包含圖片的地址、生成用時、圖片ID等訊息。

圖生影片請求示例

圖生影片的請求會包含：

image_url或image_base64（圖片）：要轉成影片的圖片。可以是URL或者base64編碼
motion_strength（動畫強度）：控制影片的動畫幅度，值越大動畫越劇烈
duration（影片時長）：影片要多長，通常支持3秒、5秒、8秒等
fps（幀率）：可選，影片的幀率，通常是24或30

返回的是影片的下載鏈接。由於影片生成耗時，通常是異步的，需要你輪詢查詢生成狀態，直到完成。

異步和回調

很多API請求是異步的，特別是影片生成。你發送請求後，伺服器不會立即返回完整的影片，而是返回一個任務ID。然後你需要定期查詢這個任務的狀態，或者在生成完成後，伺服器會通過回調URL通知你。

回調就是你在API申請時提供一個自己伺服器的URL，當生成完成時，字節的伺服器會主動POST請求到這個URL，告訴你結果。這樣你的應用就能及時做出反應。

錯誤處理

調用API會遇到各種錯誤：參數錯誤、權限不足、伺服器錯誤、限流等。開發者需要根據返回的錯誤碼來判斷問題，并做出相應的處理。

比如參數錯誤的話，要檢查提示詞有沒有問題、尺寸有沒有超出范圍。權限不足的話，可能是密鑰過期或者權限還沒開通。限流的話，就要降低請求頻率或者等待。

API收費怎麼算

計費模式

即夢API通常是按調用次數或者生成內容的數量計費。比如文生圖可能是每張圖多少錢，圖生影片可能是每秒影片多少錢。具體的價格要看字節的當前定價。

除了按量計費，字節還可能提供套餐制，比如買一個月的套餐，包含一定數量的調用次數，超出後按超額價格計費。

免費額度

通常新申請的開發者會有一定的免費額度，用於測試和開發。免費額度有時間限制，過期後就需要付費。具體的免費額度和時限要看官方的政策。

建議在開發初期充分利用免費額度來測試API的功能和性能，確保集成沒問題後再考慮商用。

費用預估

如果你計劃用API來做商業服務，需要提前預估成本。計算方法是：預期的月調用次數 × 單次費用 = 月成本。

比如你的應用每月有10萬使用者，其中有20%的使用者會用生圖功能，每個使用者平均生成3張圖。那就是10萬 × 20% × 3 = 6萬張圖。如果單張圖的成本是0.01元，月成本就是600元。在制定產品價格時，要考慮到這個成本。

需要什麼技術基礎

編程能力

調用API需要一定的編程基礎。至少要懂HTTP請求、JSON數據格式、以及基本的異步編程。如果你熟悉任何一種主流語言（Python、JavaScript、Java、Go等），就足以了。

字節通常會提供官方SDK，封裝了HTTP層的細節，讓你只需要關注業務邏輯。所以你不需要從零開始寫HTTP請求。

伺服器基礎設施

你的應用需要有自己的後端伺服器來調用API。不能直接在前端（瀏覽器、手機應用）調用API，因為那樣會暴露密鑰。正確的做法是：使用者的請求先到你的後端，後端再用密鑰調用即夢的API，然後返回結果給前端。

這要求你有基本的後端服務能力。可以自己搭伺服器，也可以用雲服務（阿裡雲、騰訊雲、AWS等）。

調試和監控能力

開發過程中會遇到各種調用問題。需要能看API的調用日志、錯誤訊息，以及用工具來測試API請求。常見的工具有Postman（測試HTTP請求）、curl（命令行工具）。

應用上線後，還要監控API的調用情況，比如成功率、響應時間、錯誤日志等。這有助於及時發現和解決問題。

常見問題

申請API權限被駁回了，怎麼辦

首先看字節給的駁回原因。大多數駁回是因為應用描述不夠清楚或者涉及敏感內容。改進以下幾個方面：

把應用的使用場景描述得更具體。不要說”做內容創作”，要說”電商商家用來快速生成產品圖和營銷海報”
如果涉及人臉，明確說明不會用來生成明星臉或者冒充真人
提供應用的演示影片或者截圖，讓審核人員看到你的應用是真實存在的
完善開發者訊息，比如公司資質、聯系方式，顯得更正規

改完後重新提交，一般會通過。如果還是不通過，可以嘗試聯系字節的開發者支

延伸閱讀：
即夢怎麼製作
 即夢怎麼用