payload.country sigue las reglas y los valores predeterminados de cada motor. Doubao siempre pregunta desde China continental. payload.state pregunta desde un estado de EE. UU. en los motores compatibles. Consulta las reglas de cada motor antes de enviar.
País
Envía un código ISO 3166-1 alfa-2 enpayload.country:
400 VALIDATION_ERROR. El valor por defecto y el significado de country dependen del motor:
Países no admitidos
Un partaskType y country que no se puede servir devuelve 422 REGION_UNSUPPORTED al enviar. Reintentar no sirve de nada.
Consulta
countries.policy de cada motor en GET /v1/capabilities: only enumera países admitidos y all_except enumera exclusiones. Commerce enumera los países de todo su catálogo; cada solicitud debe coincidir con su tienda o URL de producto. La aceptación del país y la ubicación de ejecución siguen las reglas de cada motor indicadas arriba. El siguiente error incluye la causa en details:
Estado de EE. UU.
Define enpayload.state el código de dos letras de un estado de EE. UU. para preguntar desde ese estado. El motor responde como a un usuario que está allí, así que las preguntas “cerca de mí” traen lugares de ese estado. state va con country US, que también es el valor por defecto. Esta solicitud pregunta a ChatGPT desde Texas:
El resultado devuelve el mismo código como
state. Una tarea con state cuesta 1 crédito más que el precio del motor. Un código que no es un estado de EE. UU., un country distinto de US o state junto con uule devuelven 400 VALIDATION_ERROR. GET /v1/states?country=US lista los 50 estados y DC.
uule de Google
GOOGLE_AIO, GOOGLE_AIMODE y GOOGLE_SERP también aceptan payload.uule, el parámetro de ubicación propio de Google, para sistemas que ya guardan uno por lugar. Envía el valor w+ tal como va en una URL de búsqueda de Google. Google lo recibe sin cambios, así que la página de resultados, AI Overview y AI Mode responden para ese lugar, y country sigue fijando el mercado. Esta solicitud pregunta desde Austin, Texas:
uule. Envía uule o state; una solicitud con ambos devuelve 400 VALIDATION_ERROR, igual que un valor que no es un UULE w+, como el w%2B… codificado con porcentajes. Los demás motores rechazan el campo con 422 LOCATION_UNSUPPORTED.
GOOGLE_PLACES acepta uule del mismo modo o, en su lugar, city, un nombre de lugar como "Reno, Nevada, United States". Busca cada página de su lista desde ese lugar.
Consulta qué sirve cada motor
GET /v1/capabilities devuelve cada taskType público con sus alias, campos de entrada, precio, compatibilidad con la ubicación y política de países. No necesita clave de API, se lee de las mismas reglas que validan los envíos y se puede guardar en caché durante 5 minutos. Añade ?taskType= para obtener un solo motor; se aceptan alias.
Un
taskType desconocido devuelve 400 VALIDATION_ERROR. Consulta también la referencia de capabilities.