1. 功能简介#
方舟提供官方产物验证 API,用于查询由方舟大模型平台生成的图片或视频产物对应的模型版本。
2. 开通功能#
仅企业用户可调用,暂不支持个人用户调用。企业用户可在 方舟控制台 > 开通管理 > 应用组件库 开通本功能,并使用产物验证免费资源包进行体验。
可在 账户管理-基本信息 中查看账户类型。
3. 使用方法#
3.1 使用 API 验证产物#
产物验证 API 需使用 Access Key 鉴权,采用异步查询方式。
关于 API 接口的详细信息,请查阅 CreateArkOfficialResultQuery 和 GetArkOfficialResult API 参考文档。
- 提交查询任务:调用
CreateArkOfficialResultQuery创建查询任务接口,上传图片或视频产物文件,获取查询任务query_id。 - 获取结果:调用
GetArkOfficialResult获取查询结果接口,使用返回的query_id轮询查询处理状态及最终识别结果,包括是否为方舟平台产物、模型版本、资源类型等信息。
3.2 支持验证的产物范围及接口限流信息#
- 支持验证产物的模型版本:
- 生图:Seedream 5.0 系列及后续模型。
- 生视频:Seedance 2.0 / 2.0 fast / 2.0 mini 系列及后续模型。
- 查询时效限制:支持查询 30 天内生成的产物信息。
- 上传文件限制:
- 图片:文件大小 ≤ 20 MB;支持
png、jpg(jpeg)、heic、webp格式。 - 视频:文件大小 ≤ 100 MB;支持
mp4、mov、avi格式。
- 图片:文件大小 ≤ 20 MB;支持
- 账号维度限流:
- 单日调用上限:1000
- 单账号 QPS:1
4. 计费说明#
- 计费规则:免费体验额度用尽后,将使用后付费方式计费,每次请求 0.1 元。
5. FAQ#
Q1. “检测到与方舟产物相关的技术特征”说明什么?
这表明您提交的产物极有可能由方舟生成。此时,接口在产物中识别出了与方舟生成过程相关联的技术特征,并解析出了对应的模型版本信息。此类特征的匹配结果具有较高可靠性。
Q2. “未检测到明显的方舟产物相关技术特征”说明什么?
这表明本接口已完成对您提交产物的识别,但未发现与方舟生成过程相关联的技术特征。
“未命中”并不代表该产物一定不是由方舟生成的。以下情况均可能导致未命中:
- 产物中的溯源信息在传播或加工过程中受到影响:产物在流转过程中的各类处理或再加工均可能对可携带的溯源特征造成影响,进而影响识别。
- 产物的生成时间早于当前接口所覆盖的时间范围:部分早期产物在生成时未包含可被本接口识别的溯源信息。
- 产物由未接入本能力的模型生成:本接口当前仅覆盖列表内的方舟模型(详见 支持验证的产物范围及接口限流信息),列表之外的方舟模型或非方舟模型产物均不在识别范围内。
Q3. 本功能能否识别图片、视频内容是否失实或具有误导性?
不能。成功检测到相关特征仅能证明产物由方舟生成,但该结果无法判定图片、视频所传达的信息是否准确,也无法评估其展示背景是否符合事实。
Q4. 同一图片、视频,为什么有时能查到模型版本,有时查不到?
模型版本的识别依赖于产物中可用的溯源特征。通常情况下:
- 直接使用方舟生成的原始文件时,识别效果最稳定;
- 文件在流转与再加工过程中,溯源特征可能受到影响,进而出现难以识别的情况。
如果您对同一产物反复出现无法识别,建议先确认是否仍持有原始文件。
Q5. 上传的图片、视频会如何处理?
您上传的文件仅用于本次产物来源及模型版本查询,不会用于模型训练。
为满足审计合规要求,上传的文件在处理完成后将临时保留不超过 24 小时,随后自动清除。除法律另有规定外,文件不会以其他形式保留或使用。
Q6. 查询结果的准确性如何?返回结果是否可作为法律证据?
查询结果基于自动化分析生成,仅供参考,不构成官方认证、法律鉴定或权属认定。“未检测到明显的方舟产物相关技术特征”不能作为“非方舟产物”的证据,因为溯源特征可能在流转过程中受到影响而丢失。请勿将本接口的查询结果用于版权归属、真实性鉴定或合规判定等需要具备法律效力的场景。
Q7. 为什么会出现“返回内容不完整”的情况?
- 任务未执行完毕:异步查询下,当
status = running时,仅返回query_id和status;请在status = succeeded时再读取is_official、model_name等业务字段。 - 产物超出可查询时限:
is_official/model_name字段:仅可返回 30 天内生成产物的信息。resolution字段:仅支持查询 2026 年 7 月 21 日及之后生成的产物,并且需在生成后 7 天内查询。