即梦 AI 的 API 不在即梦客户端里,而是通过火山引擎开放。官方入口为火山引擎即梦产品页与智能视觉控制台(console.volcengine.com/ai/overview)。需要特别注意:即梦 API 不使用单一 API Key,而是采用 AK/SK(AccessKey ID + AccessKey Secret)签名鉴权,调用地址为 visual.volcengineapi.com,与走火山方舟的豆包 API 是两套机制。本文整理官方入口、开通与密钥申请步骤、调用示例、价格与注意事项。 即梦API的官方入口有哪些
即梦 AI 是字节跳动的 AI 创作产品,其 API 能力统一托管在火山引擎。四个常用入口如下:
| | |
|---|
| | |
| volcengine.com/product/jimeng | |
| console.volcengine.com/ai/overview | 开通服务、管理实例、查看用量统计、购买资源包与增购并发 |
| docs.volcengine.com/docs/85621 | |
注意区分两套计费体系:即梦网页端与 App 采用积分制(注册赠送、签到领取、按次消耗积分),而 API 走火山引擎的按量计费与资源包。两者账号互通但额度独立,网页端会员权益不会自动变成 API 额度。
另外,若你更习惯 OpenAI 兼容的调用方式,火山方舟另提供 Seedream、Seedance 系列图像与视频模型的 OpenAI 兼容接口——但那是方舟体系、模型名前缀与鉴权方式都不同。选哪条路取决于你的技术栈,不是"哪个更好"。
即梦开放平台怎么开通服务
开通流程全部在火山引擎完成,实名认证是硬门槛:
- 完成实名认证。未认证时点击控制台任意按钮都会弹出认证提示,必须先认证才能进行后续操作;
- 进入智能视觉控制台(console.volcengine.com/ai/overview),也可从即梦官网侧边栏的「API」按钮跳转;
- 在模型广场找到「即梦AI」分类,定位需要的能力,例如「即梦AI-图片生成4.0系列」;
- 点击「开通服务」,在弹窗中选择「免费试用」或「正式调用」。免费试用含 200 次体验额度、并发限制为 1;正式调用按量计费,并发限制通常提升至 2;
- 开通后在「概览 → 服务管理」查看已开通服务,在「系统管理 → 用量统计」查看调用量、QPS、错误量与耗时。
AK/SK 申请与接口调用示例
这一步是与豆包(火山方舟)最大的差异:即梦 API 用的是 AK/SK 而非单一 API Key。AccessKey ID 用于标识用户,AccessKey Secret 用于生成签名,两者配合使用。
申请方式:点击控制台右上角账号下拉列表 → 选择「API 访问密钥」→ 点击「新建密钥」,即可获取 AK/SK。Secret 只在创建时完整显示,务必立即保存。官方同时提示使用主账号密钥存在风险,生产环境建议改用子账号并按需授予最小权限。
调用规范(摘自官方接口文档):
| |
|---|
| https://visual.volcengineapi.com |
| POST,Content-Type 为 application/json |
| Action=CVSync2AsyncSubmitTask,Version=2022-08-31 |
| Region 为 cn-north-1,Service 为 cv |
| |
请求体结构示例(签名由官方 SDK 处理):
req_key 是服务标识,不同能力取值不同,例如文生视频 3.0 1080P 为 jimeng_t2v_v30_1080p、图生视频 3.0 Pro 为 jimeng_ti2v_v30_pro。官方建议 prompt 控制在 400 字以内、不超过 800 字,过长可能导致效果异常或不生效;传入图片时支持单张 JPEG 或 PNG,文件最大 4.7MB,分辨率最大 4096×4096,最短边不低于 320,长短边比例在 3 以内。
视频生成为异步模式:先提交任务,再根据任务 ID 查询结果。官方提供 Python、Golang、PHP 等语言的 SDK,已封装网关签名与调用逻辑,不建议手写签名。
即梦API的调用价格与计费
官方计费文档列出两类价格。图片生成按调用次数计费(单位:元/图):
| | |
|---|
即梦AI-图像生成 3.0 系列(文生图 3.0 / 3.1、图生图 3.0 智能参考、AI 营销商品图 3.0) | | |
| | |
| | |
| | |
视频生成按时长计费,这是成本最容易失控的地方(单位:元/秒):
计费规则要点:只有调用成功(正常返回图片或视频)才计费;免费状态含 200 次体验额度、并发限制 1;资源包支持按秒购买(如视频 3.0 720P 有 250 秒与 2500 秒等档位,限时优惠以活动页为准),有效期 1 年、可叠加,用完后不会禁止调用,转按量计费。
欠费规则需要格外留意:账户余额不足即视为欠费,欠费起 2 小时内仍可正常使用,但 24 小时未补缴将被视为主动放弃服务,资源释放且无法恢复。
调用接口时的注意事项
- AK/SK 不是 API Key:即梦走签名鉴权,不能像方舟那样直接把 Key 塞进 Bearer。务必使用官方 SDK,手写签名容易出错且难排查。
- Secret 只显示一次:创建时立即保存,丢失只能重建,所有引用处都要同步更新。
- 慎用主账号密钥:官方明确提示主账号密钥风险,生产环境建议创建子账号并授予最小权限,按项目分配不同密钥。
- 不实名认证寸步难行:点击控制台任意按钮都会弹认证提示,这一步没做完后面全白搭。
- 先算清视频成本再调用:视频按时长计费,3.0 Pro 为 1 元/秒,一条 5 秒素材就是 5 元。批量生成前务必用少量任务验证效果,避免为失败素材付费。
- 并发是硬瓶颈:免费状态并发 1,付费也仅 2,高峰期会排队。有大量或有时效要求的任务,需提前联系火山引擎销售增购并发。
- 欠费 24 小时资源不可恢复:设置余额告警,别让线上业务卡在一张账单上。
- 网页端积分与 API 额度是两套:买即梦会员不会增加 API 调用额度,反之亦然。
- 商用授权需看条款:免费试用与正式调用在商用范围、水印与授权上可能存在差异,正式商用前请查阅《AI中台服务专用条款》与控制台说明。
即梦开放平台常见问题
Q:即梦 API 有免费额度吗?
A:有。开通时选择「免费试用」可获得 200 次体验额度,并发限制为 1。图片与视频能力分别按各自的免费策略计算,具体以控制台显示为准。
Q:为什么我用 API Key 调不通?
A:因为即梦 API 不用 API Key。它使用 AK/SK 签名鉴权,需要先在火山引擎「API 访问密钥」中新建密钥,再通过官方 SDK 完成签名。如果你是从火山方舟(豆包)转过来,这是最常见的认知错位。
Q:可以用 OpenAI 的 SDK 直接调吗?
A:即梦在火山引擎智能视觉体系下不提供 OpenAI 兼容接口。若你需要 OpenAI 兼容调用,可评估火山方舟上的 Seedream、Seedance 系列模型,但模型名前缀与计费方式都不同。
Q:生成失败会扣费吗?
A:官方说明只有调用成功、正常返回图片或视频才计费,失败不扣费。
Q:视频生成支持多长?
A:按时长计费,单次调用返回 1 个视频。具体时长上限与参数以对应能力的接口文档为准。
Q:并发不够用怎么办?
A:部分能力支持并发增购,需在控制台提前购买;量级较大或有时效要求的,建议联系火山引擎销售沟通。
以上内容整理自火山引擎官方文档中心、即梦产品页与智能视觉控制台相关文档,入口地址、开通流程、密钥机制、接口参数、价格与欠费规则均可能随官方更新而变动,请以火山引擎官方页面与控制台最新公布为准。