火山方舟是什麼、怎麼用：豆包大模型 API 平台、Coding Plan 與 Agent Plan 入門

本文根據火山引擎文檔中心《火山方舟 · 產品簡介》整理（該頁最近更新時間為 2026-10-09），資料核對於 2026-10-11。功能和價格變化快，以官網為準。

是什麼

火山方舟是字節跳動旗下雲服務品牌「火山引擎」的大模型服務平台，運營主體為北京火山引擎科技有限公司。簡單說，豆包 App 背後的那些模型，開發者要通過 API 調用，就是在火山方舟上開通。平台同時上架了第三方模型，文檔的模型欄目裏能看到 DeepSeek 系列。

能做什麼

官方產品簡介頁列出的能力：

• 文本與多模態：深度思考、圖片理解、影片理解、文檔（PDF）理解、聯網搜尋、函數調用。
• 生成類模型：影片生成（文檔首頁推薦 Doubao Seedance 2.5）、圖片生成（Doubao Seedream 5.0 pro）、3D 生成。
• Coding 與 Agent 模型：文檔介紹 Doubao Seed Evolving 是面向 Coding 和 Agent 的模型，按周迭代。
• 推理方式：在線推理（常規 / 低延遲 / 低優先級 / TPM 保障包 / 模型單元）和批量推理。
• 進階能力：上下文緩存、續寫模式、視覺定位、文件輸入、雲部署 MCP、GUI Agent 能力。
• 訓練與評測：模型精調、模型評測、數據集管理。
• Managed Agents：定義 Agent、配置運行環境、委派任務並管理上下文；文檔提供了把舊的零代碼應用遷移過來的說明。
• 訂閱計劃：文檔中心單列了「火山方舟 Coding Plan」和「火山方舟 Agent Plan」兩個欄目。

怎麼上手

1. 註冊火山引擎帳號並完成實名認證，進入火山方舟控制台。
2. 在控制台創建 API Key，開通要用的模型。
3. 按文檔的快速入門調用。官方示例使用的接入地址是 https://ark.cn-beijing.volces.com/api/v3，提供 Python、Curl、Go、Java 示例，也可以直接用 OpenAI SDK。

python
import os
from arkruntime import Ark

client = Ark(base_url="https://ark.cn-beijing.volces.com/api/v3", api_key=os.getenv("ARK_API_KEY"))
response = client.responses.create(model="文檔模型列表中的模型 ID", input="hello")
print(response)

免費與付費

• 按量計費：按模型的 Token 或生成量計費，單價見文檔的「模型價格」頁。
• Coding Plan / Agent Plan：面向編程工具和智能體場景的訂閱計劃，檔位與價格以官方訂閱頁為準。
• 節省計劃：文檔中心另有「節省計劃」欄目，適合用量穩定的企業。
• 新用戶是否有免費額度、額度多少，以控制台當前顯示為準。

適合誰 / 不適合誰

適合：

• 想在自己產品裏接入豆包文本、生圖、影片模型的開發者；
• 做影片、圖像生成類應用，需要 Seedance、Seedream 官方 API 的團隊；
• 想給 AI 編程工具配一個國產模型訂閱的開發者。

不適合：

• 只想聊天或偶爾生成幾張圖的普通用戶，用豆包、即夢等 App 更直接；
• 不熟悉 API、密鑰管理的非技術用戶；
• 需要海外閉源模型的場景。

注意事項

• 模型 ID 帶日期後綴：調用時必須寫完整的模型 ID，舊版本會按計劃下線，留意官方的模型生命週期公告。
• 控制用量：影片生成、批量推理費用較高，先設定好預算與告警。
• 密鑰安全：API Key 用環境變量儲存，不要提交到代碼倉庫。
• 生成內容合規：圖片、影片生成受平台內容安全策略約束，商用前閱讀服務條款。