Saltar para o conteúdo principal
payload.country segue as regras de países e os padrões de cada mecanismo. O Doubao sempre pergunta a partir da China continental. payload.state pergunta a partir de um estado dos EUA nos mecanismos compatíveis. Confira as regras de cada mecanismo abaixo antes do envio.

País

Envie um código ISO 3166-1 alfa-2 em payload.country:
Um valor que não é um código ISO 3166-1 alfa-2 retorna 400 VALIDATION_ERROR. O padrão e o significado de country dependem do mecanismo:

Países não suportados

Um par taskType e country que não pode ser atendido retorna 422 REGION_UNSUPPORTED no envio. Tentar de novo não adianta. Leia countries.policy de cada mecanismo em GET /v1/capabilities: only lista países aceitos e all_except lista exclusões. Commerce lista os países de todo o catálogo; cada requisição ainda precisa corresponder à sua loja ou URL de produto. A aceitação do país e o local de execução seguem as regras de cada mecanismo acima. O erro a seguir inclui a causa em details:

Estado dos EUA

Defina em payload.state o código de duas letras de um estado dos EUA para perguntar a partir desse estado. O mecanismo responde como a um usuário que está ali, então perguntas “perto de mim” trazem lugares desse estado. state acompanha country US, que também é o padrão. Esta requisição pergunta ao ChatGPT a partir do Texas:
O resultado devolve o mesmo código em state. Uma tarefa com state custa 1 crédito a mais que o preço do mecanismo. Um código que não é um estado dos EUA, um country diferente de US ou state junto com uule retornam 400 VALIDATION_ERROR. GET /v1/states?country=US lista os 50 estados e DC.

uule do Google

GOOGLE_AIO, GOOGLE_AIMODE e GOOGLE_SERP também aceitam payload.uule, o parâmetro de localização do próprio Google, para sistemas que já guardam um por lugar. Envie o valor w+ exatamente como ele entra em uma URL de busca do Google. O Google o recebe sem alterações, então a página de resultados, o AI Overview e o AI Mode respondem para esse lugar, e country continua definindo o mercado. Esta requisição pergunta a partir de Austin, Texas:
O resultado devolve o mesmo valor como uule. Envie uule ou state; uma requisição com os dois retorna 400 VALIDATION_ERROR, assim como um valor que não é um UULE w+, como o w%2B… codificado em porcentagem. Os outros mecanismos recusam o campo com 422 LOCATION_UNSUPPORTED. GOOGLE_PLACES aceita uule da mesma forma ou, no lugar dele, city, um nome de lugar como "Reno, Nevada, United States". Cada página da lista é buscada a partir desse lugar.

Listar o que cada mecanismo atende

GET /v1/capabilities retorna cada taskType público com seus aliases, campos de entrada, preço, suporte a localização e política de países. Não exige chave de API, é lido das mesmas regras que validam os envios e pode ficar em cache por 5 minutos. Adicione ?taskType= para receber um único mecanismo; aliases são aceitos.
Um taskType desconhecido retorna 400 VALIDATION_ERROR. Veja também a referência de capabilities.

Vazão

Limites de taxa, contrapressão, concorrência e lotes são tratados em Créditos e limites. Para enviar muitas tarefas em uma requisição, veja Lotes e grades.