跳转到主要内容
payload.country 遵循各引擎的国家规则和默认值。Doubao 始终从中国大陆提问。payload.state 在支持它的引擎上指定提问的美国州。提交前请查看下方各引擎的规则。

国家

在 payload.country 中发送 ISO 3166-1 alpha-2 代码:
不是 ISO 3166-1 alpha-2 代码的值返回 400 VALIDATION_ERROR。country 的默认值和含义因引擎而异:

不支持的国家

无法服务的 taskType 与 country 组合会在提交时返回 422 REGION_UNSUPPORTED。重试无济于事。 请读取 GET /v1/capabilities 中各引擎的 countries.policy:only 列出支持的国家,all_except 列出排除的国家。Commerce 列表汇总了整个商城目录的国家,每次请求仍须匹配商城或商品 URL 的国家。国家接受规则和执行地点遵循上方各引擎的说明。以下错误在 details 中包含原因:

美国州

在 payload.state 中填写美国州的两位字母代码,即可从该州提问。引擎会像回答该州的用户一样作答,所以“附近”类问题会给出该州的地方。state 在 country 为 US 时使用,US 也是默认值。下面的请求从得克萨斯州向 ChatGPT 提问:
结果以 state 返回同一代码。带 state 的任务在引擎价格之上多收 1 积分。不是美国州的代码、US 以外的 country,或与 uule 一起发送的 state 都返回 400 VALIDATION_ERROR。GET /v1/states?country=US 列出 50 个州和 DC。

Google 的 uule

GOOGLE_AIO、GOOGLE_AIMODE 和 GOOGLE_SERP 还接受 payload.uule,即 Google 自己的位置参数,适合已经为每个地点保存 UULE 的系统。请按放入 Google 搜索 URL 的原样发送 w+ 值。Google 会原样收到该值,因此搜索结果页、AI 概览和 AI 模式都按该地点作答,市场仍由 country 决定。下面的请求从得克萨斯州奥斯汀发问:
结果以 uule 返回同一值。uule 和 state 只发送其一;两者都发送返回 400 VALIDATION_ERROR,不是 w+ 形式 UULE 的值(例如百分号编码的 w%2B…)也一样。其他引擎以 422 LOCATION_UNSUPPORTED 拒绝该字段。 GOOGLE_PLACES 以同样方式接受 uule,也可以改用 city 传入地点名称,例如 "Reno, Nevada, United States"。它的列表每一页都从该地点搜索。

列出各引擎支持的范围

GET /v1/capabilities 返回每个公开的 taskType 及其别名、输入字段、价格、位置支持和国家策略。它无需 API 密钥,读取的是与提交校验相同的规则,可缓存 5 分钟。添加 ?taskType= 可只获取一个引擎;也接受别名。
未知的 taskType 返回 400 VALIDATION_ERROR。另见 capabilities 参考。

吞吐量

速率限制、背压、并发和批量提交见积分与限制。如需在一个请求中提交多个任务,见批次与网格。