PROMPT_LANGUAGE: 文字列。省略可。テキスト プロンプト言語に対応する言語コード。この例では hi です。使用可能な値:
auto - 自動検出。Imagen がサポートされている言語を検出すると、プロンプト(および必要に応じて否定的なプロンプト)が英語に翻訳されます。検出された言語がサポートされていない場合、Imagen は入力テキストをそのまま使用するため、予期しない出力になる可能性があります。エラーコードは返されません。
en - 英語(省略した場合はデフォルト値)
es - スペイン語
hi - ヒンディー語
ja - 日本語
ko - 韓国語
pt - ポルトガル語
zh-TW - 中国語(繁体)
zh または zh-CN - 中国語(簡体)
HTTP メソッドと URL:
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/imagegeneration@005:predict
リクエストの本文(JSON):
{
"instances": [
{
"prompt": "सूर्यास्त के समय एक समुद्र तट। उड़ते पक्षी, हवा में लहराते नारियल के पेड़। लोग समुद्र तट पर सैर का आनंद ले रहे हैं।"
}
],
"parameters": {
"language": "PROMPT_LANGUAGE"
}
}
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["わかりにくい","hardToUnderstand","thumb-down"],["情報またはサンプルコードが不正確","incorrectInformationOrSampleCode","thumb-down"],["必要な情報 / サンプルがない","missingTheInformationSamplesINeed","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 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)"]]