Passer au contenu principal
payload.country suit les règles et les valeurs par défaut de chaque moteur. Doubao interroge toujours depuis la Chine continentale. payload.state interroge depuis un État américain sur les moteurs compatibles. Consultez les règles par moteur ci-dessous avant l’envoi.

Pays

Envoyez un code ISO 3166-1 alpha-2 dans payload.country :
Une valeur qui n’est pas un code ISO 3166-1 alpha-2 renvoie 400 VALIDATION_ERROR. La valeur par défaut et le sens de country dépendent du moteur :

Pays non pris en charge

Une paire taskType et country qui ne peut pas être servie renvoie 422 REGION_UNSUPPORTED à l’envoi. Réessayer n’y change rien. Lisez countries.policy pour chaque moteur dans GET /v1/capabilities : only liste les pays pris en charge et all_except les exclusions. Commerce liste les pays de tout son catalogue ; chaque requête doit correspondre à sa boutique ou à son URL de produit. L’acceptation du pays et le lieu d’exécution suivent les règles par moteur ci-dessus. L’erreur suivante inclut la cause dans details :

État américain

Indiquez dans payload.state le code à deux lettres d’un État américain pour interroger depuis cet État. Le moteur répond comme à un utilisateur qui s’y trouve, si bien que les questions « près de moi » renvoient des lieux de cet État. state s’utilise avec country US, qui est aussi la valeur par défaut. Cette requête interroge ChatGPT depuis le Texas :
Le résultat renvoie le même code dans state. Une tâche avec state coûte 1 crédit de plus que le prix du moteur. Un code qui n’est pas un État américain, un country autre que US ou state envoyé avec uule renvoient 400 VALIDATION_ERROR. GET /v1/states?country=US liste les 50 États et DC.

uule de Google

GOOGLE_AIO, GOOGLE_AIMODE et GOOGLE_SERP acceptent aussi payload.uule, le paramètre de localisation propre à Google, pour les systèmes qui en stockent déjà un par lieu. Envoyez la valeur w+ telle qu’elle figure dans une URL de recherche Google. Google la reçoit telle quelle : la page de résultats, l’AI Overview et AI Mode répondent pour ce lieu, et country fixe toujours le marché. Cette requête interroge depuis Austin, Texas :
Le résultat renvoie la même valeur dans uule. Envoyez uule ou state ; une requête avec les deux renvoie 400 VALIDATION_ERROR, tout comme une valeur qui n’est pas un UULE w+, par exemple le w%2B… encodé en pourcentage. Les autres moteurs refusent le champ avec 422 LOCATION_UNSUPPORTED. GOOGLE_PLACES accepte uule de la même façon ou, à sa place, city, un nom de lieu comme "Reno, Nevada, United States". Chaque page de sa liste est recherchée depuis ce lieu.

Lister ce que sert chaque moteur

GET /v1/capabilities renvoie chaque taskType public avec ses alias, ses champs d’entrée, son prix, sa prise en charge de la position et sa politique de pays. Il ne demande pas de clé d’API, est lu à partir des mêmes règles que celles qui valident les envois, et peut être mis en cache 5 minutes. Ajoutez ?taskType= pour un seul moteur ; les alias sont acceptés.
Un taskType inconnu renvoie 400 VALIDATION_ERROR. Voir aussi la référence capabilities.

Débit

Les limites de débit, la contre-pression, la concurrence et les lots sont traités dans Crédits et limites. Pour envoyer de nombreuses tâches en une requête, voir Lots et grilles.