TEXT_PROMPT: 모델이 생성하는 이미지를 안내하는 텍스트 프롬프트. 이 필드는 생성 및 수정 모두에서 필요합니다.
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)"]]
