A partir de 29 de abril de 2025, os modelos Gemini 1.5 Pro e Gemini 1.5 Flash não estarão disponíveis em projetos que não os usaram antes, incluindo novos projetos. Para mais detalhes, consulte Versões e ciclo de vida do modelo.
Nesta página, descrevemos como definir um parâmetro opcional da Imagen na Vertex AI para
especificar o idioma do comando usado. Se você não especificar um idioma, a Imagen vai detectar automaticamente.
Imagem gerada com base no comando: ऊपर से देखा गया किताबों का ढेर। सबसे ऊपरी पुस्तक में
एक पक्षी का जलरंग चित्रण है। किताब पर VERTEX AI मोटे अक्षरों में लिखा हुआ है
1
1Uma pilha de livros vista de cima. O livro na parte superior contém uma ilustração em aquarela de um pássaro. VERTEX AI está escrita em negrito no livro.
Imagem gerada com base no comando: 어두운 노란색과 청록색으로 이루어진 밝은
색의 옷을입고 귀걸이를 끼고있는 여자 포스트 모던 패션 사진 2
2Mulher usando brincos e roupas com cores brilhantes, em amarelo-escuro e ciano-escuro; fotografia de moda pós-moderna.
Definir o idioma da solicitação de texto
Os seguintes valores de entrada são compatíveis com o idioma do comando de texto:
Chinês (simplificado) (zh/zh-CN)
Chinese (Traditional) (zh-TW)
Inglês (en, valor padrão)
Francês (fr)
Alemão (de)
Hindi (hi)
Japonês (ja)
Coreano (ko)
Português (pt)
Espanhol (es)
Console
Se o comando estiver em um dos idiomas compatíveis, o Imagen vai detectar e traduzir o texto e retornar as imagens geradas ou editadas.
Se o comando estiver em um idioma sem suporte, o Imagen usará
o texto exatamente como ele foi escrito para a solicitação. Isso pode resultar em uma saída inesperada.
REST
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
TEXT_PROMPT: o comando de texto que orienta quais imagens o modelo gera. Este campo é obrigatório para geração e edição.
PROMPT_LANGUAGE: string. Opcional. O código do idioma correspondente ao idioma do comando de texto.
Neste exemplo, seria hi. Valores disponíveis:
auto - Detecção automática Se o Imagen detectar um
idioma compatível, o comando (e, se quiser, um comando negativo) será
traduzido para o inglês. Se o idioma detectado não for compatível, o Imagen vai usar o texto de entrada sem alterações, o que pode resultar em uma saída inesperada. Nenhum código de erro é retornado.
en: inglês (valor padrão se omitido)
es - Espanhol
hi - Hindi
ja - Japonês
ko - Coreano
pt - Português
zh-TW - Chinese (Traditional)
zh ou zh-CN: chinês (simplificado)
Método HTTP e URL:
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/imagegeneration@005:predict
Corpo JSON da solicitação:
{
"instances": [
{
"prompt": "सूर्यास्त के समय एक समुद्र तट। उड़ते पक्षी, हवा में लहराते नारियल के पेड़। लोग समुद्र तट पर सैर का आनंद ले रहे हैं।"
}
],
"parameters": {
"language": "PROMPT_LANGUAGE"
}
}
Para enviar a solicitação, escolha uma destas opções:
curl
Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:
O exemplo de resposta a seguir é para uma solicitação com "sampleCount": 2. A resposta retorna dois objetos de previsão, com os bytes de imagem gerados codificados em base64.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[],[],null,["# Set text prompt language\n\n| **Caution:** Starting on June 24, 2025, Imagen versions 1 and 2 are deprecated. Imagen models `imagegeneration@002`, `imagegeneration@005`, and `imagegeneration@006` will be removed on September 24, 2025 . For more information about migrating to Imagen 3, see [Migrate to\n| Imagen 3](/vertex-ai/generative-ai/docs/image/migrate-to-imagen-3).\n\n\u003cbr /\u003e\n\n\n| **Preview**\n|\n|\n| This Imagen feature is a Preview offering, subject to the\n| \"Pre-GA Offerings Terms\" of the [Google\n| Cloud Service Specific Terms](/terms/service-terms). Pre-GA products and features may have\n| limited support, and changes to pre-GA products and features may not be\n| compatible with other pre-GA versions. For more information, see the [launch stage descriptions](/products#product-launch-stages).\n| Further, by using this Imagen feature, you agree to the\n| Generative AI Preview\n| [terms and conditions](/trustedtester/aitos) (\"Preview Terms\").\n\n\u003cbr /\u003e\n\n\n[Try image generation (Vertex AI Studio)](https://console.cloud.google.com/vertex-ai/studio/media/generate;tab=image)\n\n[Try Imagen in a Colab](https://colab.research.google.com/github/GoogleCloudPlatform/generative-ai/blob/main/vision/getting-started/imagen4_image_generation.ipynb)\n\nThis page describes how you can set an optional Imagen on Vertex AI parameter to\nspecify the prompt language that you use. If you don't specify a language, then\nImagen automatically detects the language.\n| **Note:** While Imagen models support only English natively, Imagen uses translation to translate several non-English language prompts to English to feed the model.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nSet text prompt language\n------------------------\n\nThe following input values are supported for the text-prompt lanague:\n\n- Chinese (simplified) (`zh`/`zh-CN`)\n- Chinese (traditional) (`zh-TW`)\n- English (`en`, default value)\n- French (`fr`)\n- German (`de`)\n- Hindi (`hi`)\n- Japanese (`ja`)\n- Korean (`ko`)\n- Portuguese (`pt`)\n- Spanish (`es`)\n\n### Console\n\nIf your prompt is in one of the supported languages,\nImagen detects and translates your text and\nreturns your generated or edited images.\n\nIf your prompt is in an unsupported language, Imagen uses\nthe text verbatim for the request. This might result in unexpected output.\n\n### REST\n\n\n| **Important:** `imagen-3.0-generate-002` doesn't support the text prompt language feature.\n\n\nBefore using any of the request data,\nmake the following replacements:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: Your Google Cloud [project ID](/resource-manager/docs/creating-managing-projects#identifiers).\n- \u003cvar translate=\"no\"\u003eTEXT_PROMPT\u003c/var\u003e: The text prompt that guides what images the model generates. This field is required for both generation and editing.\n- \u003cvar translate=\"no\"\u003ePROMPT_LANGUAGE\u003c/var\u003e: string. Optional. The language code that corresponds to your text prompt language. In this example it would be `hi`. Available values:\n - `auto` - Automatic detection. If Imagen detects a supported language, the prompt (and optionally, a negative prompt), are translated to English. If the language detected is not supported, Imagen uses the input text verbatim, which might result in unexpected output. No error code is returned.\n - `en` - English (default value if omitted)\n - `es` - Spanish\n - `hi` - Hindi\n - `ja` - Japanese\n - `ko` - Korean\n - `pt` - Portuguese\n - `zh-TW` - Chinese (traditional)\n - `zh` or `zh-CN` - Chinese (simplified)\n\n\nHTTP method and URL:\n\n```\nPOST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/imagegeneration@005:predict\n```\n\n\nRequest JSON body:\n\n```\n{\n \"instances\": [\n {\n \"prompt\": \"सूर्यास्त के समय एक समुद्र तट। उड़ते पक्षी, हवा में लहराते नारियल के पेड़। लोग समुद्र तट पर सैर का आनंद ले रहे हैं।\"\n }\n ],\n \"parameters\": {\n \"language\": \"\u003cvar translate=\"no\"\u003ePROMPT_LANGUAGE\u003c/var\u003e\"\n }\n}\n```\n\nTo send your request, choose one of these options: \n\n#### curl\n\n| **Note:** The following command assumes that you have logged in to the `gcloud` CLI with your user account by running [`gcloud init`](/sdk/gcloud/reference/init) or [`gcloud auth login`](/sdk/gcloud/reference/auth/login) , or by using [Cloud Shell](/shell/docs), which automatically logs you into the `gcloud` CLI . You can check the currently active account by running [`gcloud auth list`](/sdk/gcloud/reference/auth/list).\n\n\nSave the request body in a file named `request.json`,\nand execute the following command:\n\n```\ncurl -X POST \\\n -H \"Authorization: Bearer $(gcloud auth print-access-token)\" \\\n -H \"Content-Type: application/json; charset=utf-8\" \\\n -d @request.json \\\n \"https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/imagegeneration@005:predict\"\n```\n\n#### PowerShell\n\n| **Note:** The following command assumes that you have logged in to the `gcloud` CLI with your user account by running [`gcloud init`](/sdk/gcloud/reference/init) or [`gcloud auth login`](/sdk/gcloud/reference/auth/login) . You can check the currently active account by running [`gcloud auth list`](/sdk/gcloud/reference/auth/list).\n\n\nSave the request body in a file named `request.json`,\nand execute the following command:\n\n```\n$cred = gcloud auth print-access-token\n$headers = @{ \"Authorization\" = \"Bearer $cred\" }\n\nInvoke-WebRequest `\n -Method POST `\n -Headers $headers `\n -ContentType: \"application/json; charset=utf-8\" `\n -InFile request.json `\n -Uri \"https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/imagegeneration@005:predict\" | Select-Object -Expand Content\n```\nThe following sample response is for a request with `\"sampleCount\": 2`. The response returns two prediction objects, with the generated image bytes base64-encoded.\n\n```\n{\n \"predictions\": [\n {\n \"bytesBase64Encoded\": \"BASE64_IMG_BYTES\",\n \"mimeType\": \"image/png\"\n },\n {\n \"mimeType\": \"image/png\",\n \"bytesBase64Encoded\": \"BASE64_IMG_BYTES\"\n }\n ]\n}\n```\n\n\u003cbr /\u003e\n\nWhat's next\n-----------\n\n- [Use prompt rewriter](/vertex-ai/generative-ai/docs/image/use-prompt-rewriter)\n- [Configure aspect ratio](/vertex-ai/generative-ai/docs/image/configure-aspect-ratio)\n- [Omit content using a negative prompt](/vertex-ai/generative-ai/docs/image/omit-content-using-a-negative-prompt)\n- [Generate deterministic images](/vertex-ai/generative-ai/docs/image/generate-deterministic-images)"]]