# Table of Contents - [Gemini API  |  Google AI for Developers](#gemini-api-google-ai-for-developers) - [Gemini API  |  Google AI for Developers](#gemini-api-google-ai-for-developers) - [إنشاء صور باستخدام Imagen  |  Gemini API  |  Google AI for Developers](#-imagen-gemini-api-google-ai-for-developers) - [Membuat video dengan Veo 3.1 di Gemini API  |  Google AI for Developers](#membuat-video-dengan-veo-3-1-di-gemini-api-google-ai-for-developers) --- # Gemini API  |  Google AI for Developers [Skip to main content](https://ai.google.dev/gemini-api/docs/gemini-for-research#main-content) [![Gemini API](https://ai.google.dev/_static/googledevai/images/gemini-api-logo.svg)](https://ai.google.dev/) / * English * Deutsch * Español – América Latina * Français * Indonesia * Italiano * Polski * Português – Brasil * Shqip * Tiếng Việt * Türkçe * Русский * עברית * العربيّة * فارسی * हिंदी * বাংলা * ภาษาไทย * 中文 – 简体 * 中文 – 繁體 * 日本語 * 한국어 [Get API key](https://aistudio.google.com/apikey) [Cookbook](https://github.com/google-gemini/cookbook) [Community](https://discuss.ai.google.dev/c/gemini-api/) Sign in * [Home](https://ai.google.dev/) * [Gemini API](https://ai.google.dev/gemini-api) Accelerate discovery with Gemini for Research ============================================= [Get a Gemini API Key](https://aistudio.google.com/apikey) Gemini models can be used to advance foundational research across disciplines. Here are ways that you can explore Gemini for your research: * **Fine-tuning**: You can fine-tune Gemini models for a variety of modalities to advance your research. [Learn more](https://ai.google.dev/gemini-api/docs/model-tuning/tutorial) . * **Analyze and control model outputs**: For further analysis, you can examine a response candidate generated by the model using tools like `Logprobs` and `CitationMetadata`. You can also configure options for model generation and outputs, such as `responseSchema`, `topP`, and `topK`. [Learn more](https://ai.google.dev/api/generate-content) . * **Multimodal inputs**: Gemini can process images, audio, and videos, enabling a multitude of exciting research directions. [Learn more](https://ai.google.dev/gemini-api/docs/vision) . * **Long-context capabilities**: Gemini 1.5 Flash comes with a 1-million-token context window, and Gemini 1.5 Pro comes with a 2-million-token context window. [Learn more](https://ai.google.dev/gemini-api/docs/long-context) . * **Grow with Google**: Quickly access Gemini models through the API and Google AI Studio for production use cases. If you're looking for a Google Cloud-based platform, Vertex AI can provide additional supporting infrastructure. To support academic research and drive cutting-edge research, Google provides access to Gemini API credits for scientists and academic researchers through the [Gemini Academic Program](https://ai.google.dev/gemini-api/docs/gemini-for-research#gemini-academic-program) . Get started with Gemini ----------------------- The Gemini API and Google AI Studio help you start working with Google's latest models and turn your ideas into applications that scale. ### Python from google import genai client = genai.Client() response = client.models.generate_content( model="gemini-2.0-flash", contents="How large is the universe?", ) print(response.text) ### JavaScript import { GoogleGenAI } from "@google/genai"; const ai = new GoogleGenAI({}); async function main() { const response = await ai.models.generateContent({ model: "gemini-2.0-flash", contents: "How large is the universe?", }); console.log(response.text); } await main(); ### REST curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent" \ -H "x-goog-api-key: $GEMINI_API_KEY" \ -H 'Content-Type: application/json' \ -X POST \ -d '{ "contents": [{\ "parts":[{"text": "How large is the universe?"}]\ }] }' Featured academics ------------------ ![](https://ai.google.dev/static/site-assets/images/diyi-yang.png) "Our research investigates Gemini as a visual language model (VLM) and its agentic behaviors in diverse environments from robustness and safety perspectives. So far, we have evaluated Gemini's robustness against distractions such as pop-up windows when VLM agents perform computer tasks, and have leveraged Gemini to analyze social interaction, temporal events as well as risk factors based on video input." [](https://cs.stanford.edu/~diyiy/) ![](https://ai.google.dev/static/site-assets/images/lerrel-pinto.png) "Gemini Pro and Flash, with their long context window, have been helping us in OK-Robot, our open-vocabulary mobile manipulation project. Gemini enables complex natural language queries and commands over the robot's "memory": in this case, previous observations made by the robot over a long operation duration. Mahi Shafiullah and I are also using Gemini to decompose tasks into code that the robot can execute in the real world." [](https://www.lerrelpinto.com/) Gemini Academic Program ----------------------- Qualified academic researchers (such as faculty, staff, and PhD students) in [supported countries](https://ai.google.dev/gemini-api/docs/available-regions) can apply to receive Gemini API credits and higher rate limits for research projects. This support enables higher throughput for scientific experiments and advances research. We are particularly interested in the research areas in the following section, but we welcome applications from diverse scientific disciplines: * **Evaluations and benchmarks**: Community-endorsed evaluation methods that can provide a strong performance signal in areas such as factuality, safety, instruction following, reasoning, and planning. * **Accelerating scientific discovery to benefit humanity**: Potential applications of AI in interdisciplinary scientific research, including areas such as rare and neglected diseases, experimental biology, materials science, and sustainability. * **Embodiment and interactions**: Utilizing large language models to investigate novel interactions within the fields of embodied AI, ambient interactions, robotics, and human-computer interaction. * **Emergent capabilities**: Exploring new agentic capabilities required to enhance reasoning and planning, and how capabilities can be expanded during inference (e.g., by utilizing Gemini Flash). * **Multimodal interaction and understanding**: Identifying gaps and opportunities for multimodal foundational models for analysis, reasoning, and planning across a variety of tasks. Eligibility: Only individuals (faculty members, researchers or equivalent) affiliated with a valid academic institution, or academic research organization can apply. Note that API access and credits will be granted and removed at Google's discretion. We review applications on a monthly basis. ### Start researching with the Gemini API [Apply now](https://forms.gle/HMviQstU8PxC5iCt5) Except as otherwise noted, the content of this page is licensed under the [Creative Commons Attribution 4.0 License](https://creativecommons.org/licenses/by/4.0/) , and code samples are licensed under the [Apache 2.0 License](https://www.apache.org/licenses/LICENSE-2.0) . For details, see the [Google Developers Site Policies](https://developers.google.com/site-policies) . Java is a registered trademark of Oracle and/or its affiliates. Last updated 2025-12-18 UTC. --- # Gemini API  |  Google AI for Developers [Chuyển ngay đến nội dung chính](https://ai.google.dev/gemini-api/docs?hl=vi#main-content) [![Gemini API](https://ai.google.dev/_static/googledevai/images/gemini-api-logo.svg?hl=vi)](https://ai.google.dev/) / * English * Deutsch * Español – América Latina * Français * Indonesia * Italiano * Polski * Português – Brasil * Shqip * Tiếng Việt * Türkçe * Русский * עברית * العربيّة * فارسی * हिंदी * বাংলা * ภาษาไทย * 中文 – 简体 * 中文 – 繁體 * 日本語 * 한국어 [Lấy khoá API](https://aistudio.google.com/apikey?hl=vi) [Sổ tay nấu ăn](https://github.com/google-gemini/cookbook) [Cộng đồng](https://discuss.ai.google.dev/c/gemini-api/?hl=vi) Đăng nhập * [Trang chủ](https://ai.google.dev/?hl=vi) * [Gemini API](https://ai.google.dev/gemini-api?hl=vi) * [Tài liệu](https://ai.google.dev/gemini-api/docs?hl=vi) Gemini API ========== Lộ trình nhanh nhất từ câu lệnh đến sản phẩm với Gemini, Veo, Nano Banana và nhiều công cụ khác. ### Python from google import genai client = genai.Client() response = client.models.generate_content( model="gemini-3-flash-preview", contents="Explain how AI works in a few words", ) print(response.text) ### JavaScript import { GoogleGenAI } from "@google/genai"; const ai = new GoogleGenAI({}); async function main() { const response = await ai.models.generateContent({ model: "gemini-2.5-flash", contents: "Explain how AI works in a few words", }); console.log(response.text); } await main(); ### Go package main import ( "context" "fmt" "log" "google.golang.org/genai" ) func main() { ctx := context.Background() client, err := genai.NewClient(ctx, nil) if err != nil { log.Fatal(err) } result, err := client.Models.GenerateContent( ctx, "gemini-2.5-flash", genai.Text("Explain how AI works in a few words"), nil, ) if err != nil { log.Fatal(err) } fmt.Println(result.Text()) } ### Java package com.example; import com.google.genai.Client; import com.google.genai.types.GenerateContentResponse; public class GenerateTextFromTextInput { public static void main(String[] args) { Client client = new Client(); GenerateContentResponse response = client.models.generateContent( "gemini-2.5-flash", "Explain how AI works in a few words", null); System.out.println(response.text()); } } ### C# using System.Threading.Tasks; using Google.GenAI; using Google.GenAI.Types; public class GenerateContentSimpleText { public static async Task main() { var client = new Client(); var response = await client.Models.GenerateContentAsync( model: "gemini-2.5-flash", contents: "Explain how AI works in a few words" ); Console.WriteLine(response.Candidates[0].Content.Parts[0].Text); } } ### REST curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent" \ -H "x-goog-api-key: $GEMINI_API_KEY" \ -H 'Content-Type: application/json' \ -X POST \ -d '{ "contents": [\ {\ "parts": [\ {\ "text": "Explain how AI works in a few words"\ }\ ]\ }\ ] }' [Bắt đầu xây dựng](https://ai.google.dev/gemini-api/docs/quickstart?hl=vi) Hãy làm theo hướng dẫn Bắt đầu nhanh của chúng tôi để lấy khoá API và thực hiện lệnh gọi API đầu tiên chỉ trong vài phút. * * * Làm quen với các mô hình ------------------------ [auto\_awesome Gemini 3 Pro\ \ Mô hình thông minh nhất của chúng tôi, mô hình tốt nhất trên thế giới về khả năng hiểu đa phương thức, tất cả đều được xây dựng trên nền tảng suy luận tiên tiến hàng đầu.](https://ai.google.dev/gemini-api/docs/models?hl=vi#gemini-3-pro) [spark Gemini 3 Flash\ \ Hiệu suất ở cấp độ tiên tiến, cạnh tranh với các mô hình lớn hơn với chi phí thấp hơn.](https://ai.google.dev/gemini-api/docs/models?hl=vi#gemini-3-flash) [🍌 Nano Banana và Nano Banana Pro\ \ Mô hình tạo và chỉnh sửa hình ảnh tiên tiến.](https://ai.google.dev/gemini-api/docs/image-generation?hl=vi) [spark Gemini 2.5 Pro\ \ Mô hình suy luận mạnh mẽ của chúng tôi, vượt trội trong việc lập trình và xử lý các nhiệm vụ suy luận phức tạp.](https://ai.google.dev/gemini-api/docs/models?hl=vi#gemini-2.5-pro) [spark Gemini 2.5 Flash\ \ Mô hình cân bằng nhất của chúng tôi, với cửa sổ ngữ cảnh 1 triệu token và nhiều tính năng khác.](https://ai.google.dev/gemini-api/docs/models/gemini?hl=vi#gemini-2.5-flash) [spark Gemini 2.5 Flash-Lite\ \ Mô hình đa phương thức nhanh nhất và tiết kiệm chi phí nhất của chúng tôi, có hiệu suất cao cho các tác vụ có tần suất cao.](https://ai.google.dev/gemini-api/docs/models/gemini?hl=vi#gemini-2.5-flash-lite) [video\_library Veo 3.1\ \ Mô hình tạo video tân tiến của chúng tôi, có âm thanh gốc.](https://ai.google.dev/gemini-api/docs/video?hl=vi) [spark Gemini 2.5 Pro TTS\ \ Biến thể mô hình Gemini 2.5 có khả năng chuyển văn bản sang lời nói (TTS) nguyên bản.](https://ai.google.dev/gemini-api/docs/models/gemini?hl=vi#gemini-2.5-pro-tts) [spark Gemini Robotics-ER 1.5\ \ Một mô hình thị giác-ngôn ngữ (VLM) mang các tính năng tác nhân của Gemini vào lĩnh vực robot học và cho phép suy luận nâng cao trong thế giới thực.](https://ai.google.dev/gemini-api/docs/robotics-overview?hl=vi) Khám phá các khả năng --------------------- [imagesmode\ \ Tạo hình ảnh gốc (Nano Banana)\ \ Tạo và chỉnh sửa hình ảnh có tính ngữ cảnh cao một cách tự nhiên bằng Gemini 2.5 Flash Image.](https://ai.google.dev/gemini-api/docs/image-generation?hl=vi) [article\ \ Ngữ cảnh dài\ \ Nhập hàng triệu mã thông báo vào các mô hình Gemini và rút ra thông tin từ hình ảnh, video và tài liệu không có cấu trúc.](https://ai.google.dev/gemini-api/docs/long-context?hl=vi) [code\ \ Đầu ra có cấu trúc\ \ Giới hạn Gemini chỉ phản hồi bằng JSON, một định dạng dữ liệu có cấu trúc phù hợp để xử lý tự động.](https://ai.google.dev/gemini-api/docs/structured-output?hl=vi) [functions\ \ Gọi hàm\ \ Tạo quy trình công việc dựa trên tác nhân bằng cách kết nối Gemini với các API và công cụ bên ngoài.](https://ai.google.dev/gemini-api/docs/function-calling?hl=vi) [videocam\ \ Tạo video bằng Veo 3.1\ \ Tạo nội dung video chất lượng cao từ câu lệnh văn bản hoặc hình ảnh bằng mô hình tân tiến của chúng tôi.](https://ai.google.dev/gemini-api/docs/video?hl=vi) [android\_recorder\ \ Voice Agents with Live API\ \ Xây dựng các ứng dụng và tác nhân thoại theo thời gian thực bằng Live API.](https://ai.google.dev/gemini-api/docs/live?hl=vi) [build\ \ Công cụ\ \ Kết nối Gemini với thế giới thông qua các công cụ tích hợp như Google Tìm kiếm, Ngữ cảnh URL, Google Maps, Thực thi mã và Sử dụng máy tính.](https://ai.google.dev/gemini-api/docs/tools?hl=vi) [stacks\ \ Hiểu tài liệu\ \ Xử lý tối đa 1.000 trang tệp PDF bằng tính năng hiểu biết đa phương thức toàn diện hoặc các loại tệp dựa trên văn bản khác.](https://ai.google.dev/gemini-api/docs/document-processing?hl=vi) [cognition\_2\ \ Mô hình tư duy\ \ Khám phá cách các khả năng tư duy cải thiện khả năng suy luận cho các tác vụ và tác nhân phức tạp.](https://ai.google.dev/gemini-api/docs/thinking?hl=vi) Tài nguyên ---------- [Google AI Studio\ \ Kiểm thử câu lệnh, quản lý khoá API, giám sát mức sử dụng và tạo nguyên mẫu trong nền tảng của chúng tôi dành cho nhà phát triển AI.\ \ Mở Google AI Studio](https://aistudio.google.com/?hl=vi) [group Cộng đồng nhà phát triển\ \ Đặt câu hỏi và tìm giải pháp từ các nhà phát triển khác và kỹ sư của Google.\ \ Tham gia cộng đồng](https://discuss.ai.google.dev/c/gemini-api/4?hl=vi) [menu\_book Tài liệu tham khảo về API\ \ Tìm thông tin chi tiết về Gemini API trong tài liệu tham khảo chính thức.\ \ Đọc tài liệu tham khảo API](https://ai.google.dev/api?hl=vi) Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo [Giấy phép ghi nhận tác giả 4.0 của Creative Commons](https://creativecommons.org/licenses/by/4.0/) và các mẫu mã lập trình được cấp phép theo [Giấy phép Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0) . Để biết thông tin chi tiết, vui lòng tham khảo [Chính sách trang web của Google Developers](https://developers.google.com/site-policies?hl=vi) . Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle. Cập nhật lần gần đây nhất: 2025-12-28 UTC. --- # إنشاء صور باستخدام Imagen  |  Gemini API  |  Google AI for Developers [التخطّي إلى المحتوى الرئيسي](https://ai.google.dev/gemini-api/docs/imagen?hl=ar#main-content) [![Gemini API](https://ai.google.dev/_static/googledevai/images/gemini-api-logo.svg?hl=ar)](https://ai.google.dev/) / * English * Deutsch * Español – América Latina * Français * Indonesia * Italiano * Polski * Português – Brasil * Shqip * Tiếng Việt * Türkçe * Русский * עברית * العربيّة * فارسی * हिंदी * বাংলা * ภาษาไทย * 中文 – 简体 * 中文 – 繁體 * 日本語 * 한국어 [الحصول على مفتاح واجهة برمجة التطبيقات](https://aistudio.google.com/apikey?hl=ar) [كتاب الطبخ](https://github.com/google-gemini/cookbook) [منتدى](https://discuss.ai.google.dev/c/gemini-api/?hl=ar) تسجيل الدخول * [الصفحة الرئيسية](https://ai.google.dev/?hl=ar) * [Gemini API](https://ai.google.dev/gemini-api?hl=ar) * [المستندات](https://ai.google.dev/gemini-api/docs?hl=ar) إرسال ملاحظات إنشاء صور باستخدام Imagen ========================= ‫Imagen هو نموذج من Google لإنشاء صور عالية الدقة، وهو قادر على إنشاء صور واقعية وعالية الجودة من الطلبات النصية. تتضمّن جميع الصور التي يتم إنشاؤها علامة SynthID المائية. لمزيد من المعلومات عن صيغ نموذج Imagen المتاحة، يُرجى الاطّلاع على قسم [إصدارات النموذج](https://ai.google.dev/gemini-api/docs/imagen?hl=ar#model-versions) . إنشاء صور باستخدام نماذج Imagen ------------------------------- يوضّح هذا المثال كيفية إنشاء صور باستخدام [نموذج Imagen](https://deepmind.google/technologies/imagen-3/?hl=ar) : ### Python from google import genai from google.genai import types from PIL import Image from io import BytesIO client = genai.Client() response = client.models.generate_images( model='imagen-4.0-generate-001', prompt='Robot holding a red skateboard', config=types.GenerateImagesConfig( number_of_images= 4, ) ) for generated_image in response.generated_images: generated_image.image.show() ### JavaScript import { GoogleGenAI } from "@google/genai"; import * as fs from "node:fs"; async function main() { const ai = new GoogleGenAI({}); const response = await ai.models.generateImages({ model: 'imagen-4.0-generate-001', prompt: 'Robot holding a red skateboard', config: { numberOfImages: 4, }, }); let idx = 1; for (const generatedImage of response.generatedImages) { let imgBytes = generatedImage.image.imageBytes; const buffer = Buffer.from(imgBytes, "base64"); fs.writeFileSync(`imagen-${idx}.png`, buffer); idx++; } } main(); ### Go package main import ( "context" "fmt" "os" "google.golang.org/genai" ) func main() { ctx := context.Background() client, err := genai.NewClient(ctx, nil) if err != nil { log.Fatal(err) } config := &genai.GenerateImagesConfig{ NumberOfImages: 4, } response, _ := client.Models.GenerateImages( ctx, "imagen-4.0-generate-001", "Robot holding a red skateboard", config, ) for n, image := range response.GeneratedImages { fname := fmt.Sprintf("imagen-%d.png", n) _ = os.WriteFile(fname, image.Image.ImageBytes, 0644) } } ### REST curl -X POST \ "https://generativelanguage.googleapis.com/v1beta/models/imagen-4.0-generate-001:predict" \ -H "x-goog-api-key: $GEMINI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "instances": [\ {\ "prompt": "Robot holding a red skateboard"\ }\ ], "parameters": { "sampleCount": 4 } }' ![صورة من إنشاء الذكاء الاصطناعي لروبوت يحمل لوح تزلّج أحمر](https://ai.google.dev/static/gemini-api/docs/images/robot-skateboard.png?hl=ar) صورة من إنشاء الذكاء الاصطناعي لروبوت يحمل لوح تزلّج أحمر ### إعدادات Imagen تتيح Imagen حاليًا كتابة الطلبات باللغة الإنجليزية فقط، بالإضافة إلى استخدام المَعلمات التالية: * `numberOfImages`: عدد الصور المطلوب إنشاؤها، من 1 إلى 4 (شاملة). القيمة التلقائية هي 4. * `imageSize`: حجم الصورة من إنشاء الذكاء الاصطناعي التوليدي تتوفّر هذه الميزة فقط في طرازَي Standard وUltra. القيمتان المسموح بإدراجهما هما `1K` و`2K`. القيمة التلقائية هي `1K`. * `aspectRatio`: لتغيير نسبة العرض إلى الارتفاع في الصورة التي تم إنشاؤها القيم المسموح بها هي `"1:1"` و`"3:4"` و`"4:3"` و`"9:16"` و`"16:9"`. القيمة التلقائية هي `"1:1"`. * ‫`personGeneration`: السماح للنموذج بإنشاء صور لأشخاص يمكن استخدام القيم التالية: * `"dont_allow"`: لحظر إنشاء صور لأشخاص * ‫`"allow_adult"`: إنشاء صور لبالغين فقط هذا هو الخيار التلقائي. * ‫`"allow_all"`: إنشاء صور تتضمّن بالغين وأطفالاً دليل كتابة الطلبات في Imagen ---------------------------- يوضّح لك هذا القسم من دليل Imagen كيفية تعديل طلب نصي لإنشاء صورة للحصول على نتائج مختلفة، بالإضافة إلى أمثلة على الصور التي يمكنك إنشاؤها. ### أساسيات كتابة الطلبات يجب أن يكون الطلب جيدًا وواضحًا، وأن يستخدم كلمات رئيسية ومعدِّلات ذات صلة. ابدأ بالتفكير في **الموضوع** و**السياق** و**الأسلوب**. ![طلب يتضمّن الموضوع والسياق والنمط مع التركيز عليها](https://ai.google.dev/static/gemini-api/docs/images/imagen/style-subject-context.png?hl=ar) نص الصورة: _رسم تخطيطي_ (**الأسلوب**) _لمبنى سكني حديث_ (**الموضوع**) محاط _بناطحات سحاب_ (**السياق والخلفية**). 1. **الموضوع**: أول ما يجب التفكير فيه عند كتابة أي طلب هو _الموضوع_، أي الكائن أو الشخص أو الحيوان أو المشهد الذي تريد إنشاء صورة له. 2. **السياق والخلفية:** لا تقلّ أهمية _الخلفية أو السياق_ الذي سيتم وضع الموضوع فيه. جرِّب وضع العنصر الأساسي في الصورة أمام مجموعة متنوعة من الخلفيات. على سبيل المثال، استوديو بخلفية بيضاء أو في الخارج أو في بيئات داخلية 3. **النمط:** أخيرًا، أضِف نمط الصورة الذي تريده. يمكن أن تكون _الأنماط_ عامة (مثل الرسم أو التصوير الفوتوغرافي أو الرسومات التخطيطية) أو دقيقة جدًا (مثل الرسم بالألوان الباستيل أو الرسم بالفحم أو الرسومات ثلاثية الأبعاد المتساوية القياس). يمكنك أيضًا الجمع بين الأنماط. بعد كتابة النسخة الأولى من الطلب، حسِّنه من خلال إضافة المزيد من التفاصيل إلى أن تحصل على الصورة التي تريدها. التكرار مهم. ابدأ بتحديد فكرتك الأساسية، ثم حسِّنها ووسّع نطاقها إلى أن تصبح الصورة التي تم إنشاؤها قريبة من فكرتك. | | | | | --- | --- | --- | | ![صورة نموذجية واقعية 1](https://ai.google.dev/static/gemini-api/docs/images/imagen/0_prompt-writing-basics_park_short.png?hl=ar)

الطلب: حديقة في الربيع بجانب بحيرة | ![صورة نموذجية واقعية 2](https://ai.google.dev/static/gemini-api/docs/images/imagen/0_prompt-writing-basics_park_medium.png?hl=ar)

الطلب: حديقة في فصل الربيع بجوار بحيرة، **تغرب الشمس فوق البحيرة، وقت الغروب** | ![صورة نموذجية واقعية 3](https://ai.google.dev/static/gemini-api/docs/images/imagen/0_prompt-writing-basics_park_long.png?hl=ar)

الوصف: حديقة في فصل الربيع بجوار بحيرة، _**تغرب الشمس فوق البحيرة، وقت الغروب، زهور برية حمراء**_ | يمكن لنماذج Imagen تحويل أفكارك إلى صور مفصّلة، سواء كانت طلباتك قصيرة أو طويلة ومفصّلة. حسِّنوا رؤيتكم من خلال تقديم طلبات متكررة وإضافة التفاصيل إلى أن تحصلوا على النتيجة المثالية. | | | | --- | --- | | تتيح لك الطلبات القصيرة إنشاء صورة بسرعة.

![مثال على طلب قصير في Imagen 3](https://ai.google.dev/static/gemini-api/docs/images/imagen/imagen3_short-prompt.png?hl=ar)

الطلب: صورة مقرّبة لامرأة في العشرينات من عمرها، تصوير شوارع، لقطة من فيلم، درجات برتقالية دافئة هادئة | تتيح لك الطلبات الأطول إضافة تفاصيل محدّدة وإنشاء صورتك.

![مثال على طلب طويل في Imagen 3](https://ai.google.dev/static/gemini-api/docs/images/imagen/imagen3_long-prompt.png?hl=ar)

الطلب: صورة آسرة لامرأة في العشرينات من عمرها بأسلوب التصوير الفوتوغرافي في الشارع. يجب أن تبدو الصورة مثل لقطة من فيلم بألوان برتقالية دافئة. | نصائح إضافية لكتابة الطلبات في Imagen: * **استخدام لغة وصفية**: استخدِم صفات وأحوال مفصّلة لتقديم صورة واضحة إلى Imagen. * **توفير السياق**: إذا لزم الأمر، أدرِج معلومات أساسية لمساعدة الذكاء الاصطناعي في فهم طلبك. * **الإشارة إلى فنّانين أو أنماط معيّنة**: إذا كان لديك أسلوب جمالي معيّن في ذهنك، يمكن أن تكون الإشارة إلى فنّانين أو حركات فنية معيّنة مفيدة. * **استخدام أدوات هندسة الطلبات**: ننصحك باستكشاف أدوات أو مراجع هندسة الطلبات لمساعدتك في تحسين طلباتك وتحقيق أفضل النتائج. * **تحسين تفاصيل الوجه في صورك الشخصية وصور المجموعات**: حدِّد تفاصيل الوجه كعنصر أساسي في الصورة (على سبيل المثال، استخدِم كلمة "صورة شخصية" في الطلب). ### إنشاء نص في الصور يمكن لنماذج Imagen إضافة نص إلى الصور، ما يتيح المزيد من الإمكانات الإبداعية لإنشاء الصور. اتّبِع الإرشادات التالية للاستفادة إلى أقصى حدّ من هذه الميزة: * **التكرار بثقة**: قد تحتاج إلى إعادة إنشاء الصور إلى أن تحصل على المظهر الذي تريده. لا يزال دمج النصوص في Imagen في مرحلة التطوير، وفي بعض الأحيان، قد تؤدي المحاولات المتعددة إلى الحصول على أفضل النتائج. * **اختصِر النص**: يجب أن يتألف النص من 25 حرفًا أو أقل للحصول على أفضل النتائج. * **عبارات متعدّدة**: جرِّب استخدام عبارتَين أو ثلاث عبارات مختلفة لتقديم معلومات إضافية. تجنَّب تجاوز ثلاث عبارات للحصول على أغانٍ أكثر وضوحًا. ![مثال على إنشاء نص باستخدام Imagen 3](https://ai.google.dev/static/gemini-api/docs/images/imagen/imagen3_generate-text.png?hl=ar) الطلب: ملصق يتضمّن النص "Summerland" بخط غامق كعنوان، وتحته الشعار "لم يكن الصيف ممتعًا إلى هذا الحد" * **موضع النص**: على الرغم من أنّ Imagen يمكنه محاولة وضع النص في الموضع المطلوب، قد تظهر اختلافات أحيانًا. نعمل باستمرار على تحسين هذه الميزة. * **نمط خط ملهم**: حدِّد نمط خط عامًا للتأثير بشكل طفيف في خيارات Imagen. لا تعتمد على تكرار الخطوط بدقة، ولكن توقَّع تفسيرات إبداعية. * **حجم الخط**: حدِّد حجم الخط أو مؤشرًا عامًا للحجم (على سبيل المثال، _صغير_ أو _متوسط_ أو _كبير_) للتأثير في عملية إنشاء حجم الخط. ### تحديد مَعلمات الطلب للتحكّم بشكل أفضل في نتائج الإخراج، قد يكون من المفيد تحديد مَعلمات للإدخالات في Imagen. على سبيل المثال، لنفترض أنّك تريد أن يتمكّن عملاؤك من إنشاء شعارات لمؤسساتهم، وأنّك تريد التأكّد من أنّ الشعارات يتم إنشاؤها دائمًا على خلفية بلون موحّد. تريد أيضًا حصر الخيارات التي يمكن للعميل تحديدها من القائمة. في هذا المثال، يمكنك إنشاء طلب يتضمّن مَعلمات مشابه لما يلي: A {logo\_style} logo for a {company\_area} company on a solid color background. Include the text {company\_name}. في واجهة المستخدم المخصّصة، يمكن للعميل إدخال المَعلمات باستخدام قائمة، ويتم ملء الطلب الذي تتلقّاه Imagen بالقيمة التي يختارها. على سبيل المثال: 1. الطلب: `A minimalist logo for a health care company on a solid color background. Include the text Journey.` ![مثال 1 على تحديد مَعلمات الطلب في Imagen 3](https://ai.google.dev/static/gemini-api/docs/images/imagen/imagen3_prompt-param_healthcare.png?hl=ar) 2. الطلب: `A modern logo for a software company on a solid color background. Include the text Silo.` ![مثال 2 على تحديد مَعلمات الطلب في Imagen 3](https://ai.google.dev/static/gemini-api/docs/images/imagen/imagen3_prompt-param_software.png?hl=ar) 3. الطلب: `A traditional logo for a baking company on a solid color background. Include the text Seed.` ![مثال 3 على تحديد مَعلمات الطلب في Imagen 3](https://ai.google.dev/static/gemini-api/docs/images/imagen/imagen3_prompt-param_baking.png?hl=ar) ### أساليب متقدّمة لكتابة الطلبات استخدِم الأمثلة التالية لإنشاء طلبات أكثر تحديدًا استنادًا إلى سمات مثل أوصاف التصوير الفوتوغرافي والأشكال والمواد والحركات الفنية التاريخية ومعدّلات جودة الصورة. #### تصوير فوتوغرافي * يتضمّن الطلب: _"صورة لـ..."_ لاستخدام هذا النمط، ابدأ باستخدام كلمات رئيسية توضّح لـ Imagen أنّك تبحث عن صورة فوتوغرافية. ابدأ طلباتك بعبارة _"صورة لـ. . ."_. على سبيل المثال: | | | | | --- | --- | --- | | ![صورة نموذجية واقعية 1](https://ai.google.dev/static/gemini-api/docs/images/imagen/1_style-photography_coffee-beans.png?hl=ar)

الطلب: **صورة** لحبوب قهوة في مطبخ على سطح خشبي | ![صورة نموذجية واقعية 2](https://ai.google.dev/static/gemini-api/docs/images/imagen/1_style-photography_chocolate-bar.png?hl=ar)

الطلب: **صورة** لقطعة شوكولاتة على منضدة مطبخ | ![صورة نموذجية واقعية 3](https://ai.google.dev/static/gemini-api/docs/images/imagen/1_style-photography_modern-building.png?hl=ar)

الطلب: **صورة** لمبنى عصري يظهر الماء في الخلفية | مصدر الصورة: تم إنشاء كل صورة باستخدام الطلب النصي الخاص بها من خلال نموذج Imagen 3. ##### معدّلات التصوير الفوتوغرافي في الأمثلة التالية، يمكنك الاطّلاع على العديد من المعدِّلات والمعلَمات الخاصة بالتصوير. يمكنك الجمع بين معدّلات متعددة للتحكّم بدقة أكبر. 1. **تقريب الكاميرا**: _لقطات مقرّبة من مسافة بعيدة_ | | | | --- | --- | | ![صورة نموذجية للقطة مقرّبة بالكاميرا](https://ai.google.dev/static/gemini-api/docs/images/imagen/3_camera-proximity_close-up.png?hl=ar)

الطلب: صورة **مقرّبة** لحبوب القهوة | ![صورة عيّنة تم تصغيرها بالكاميرا](https://ai.google.dev/static/gemini-api/docs/images/imagen/3_camera-proximity_zoomed-out.png?hl=ar)

الطلب: صورة **مصغّرة** لكيس صغير من حبوب القهوة
في مطبخ غير مرتّب | 2. **موضع الكاميرا** - _من الأعلى، من الأسفل_ | | | | --- | --- | | ![نموذج صورة جوية](https://ai.google.dev/static/gemini-api/docs/images/imagen/4_camera-position_aerial-photo.png?hl=ar)

الطلب: **صورة جوية** لمدينة حضرية تضم ناطحات سحاب | ![صورة نموذجية من الأسفل](https://ai.google.dev/static/gemini-api/docs/images/imagen/4_camera-position_from-below.png?hl=ar)

الطلب: صورة لمظلة غابة مع سماء زرقاء **من الأسفل** | 3. **الإضاءة** - _طبيعية، درامية، دافئة، باردة_ | | | | --- | --- | | ![صورة نموذجية للإضاءة الطبيعية](https://ai.google.dev/static/gemini-api/docs/images/imagen/5_lighting_natural-lighting.png?hl=ar)

الطلب: صورة استوديو لكرسي بذراعَين عصري، **إضاءة طبيعية** | ![صورة نموذجية للإضاءة الدرامية](https://ai.google.dev/static/gemini-api/docs/images/imagen/5_lighting_dramatic-lighting.png?hl=ar)

الطلب: صورة استوديو لكرسي بذراعَين عصري، **إضاءة درامية** | 4. **إعدادات الكاميرا** _\- تمويه الحركة، والتركيز الناعم، والبوكيه، ووضع "بورتريه"_ | | | | --- | --- | | ![صورة نموذجية لتعتيم الصورة المتحركة](https://ai.google.dev/static/gemini-api/docs/images/imagen/6_camera-settings_motion-blur.png?hl=ar)

الطلب: صورة لمدينة فيها ناطحات سحاب من داخل سيارة مع **تأثير التمويه الناتج عن الحركة** | ![صورة نموذجية بتركيز ضعيف](https://ai.google.dev/static/gemini-api/docs/images/imagen/6_camera-settings_soft-focus.png?hl=ar)

الطلب: **صورة بتركيز خفيف** لجسر في مدينة حضرية ليلاً | 5. **أنواع العدسات**: _35 ملم و50 ملم وعدسة عين السمكة والزاوية الواسعة وعدسة التقريب_ | | | | --- | --- | | ![صورة نموذجية تم التقاطها باستخدام عدسة ماكرو](https://ai.google.dev/static/gemini-api/docs/images/imagen/7_lens-types_macro-lens.png?hl=ar)

الطلب: صورة ورقة شجر، **عدسة ماكرو** | ![صورة نموذجية لعدسة عين السمكة](https://ai.google.dev/static/gemini-api/docs/images/imagen/7_lens-types_fisheye-lens.png?hl=ar)

الطلب: تصوير الشوارع، مدينة نيويورك، **عدسة عين السمكة** | 6. **أنواع الأفلام** - _أبيض وأسود، بولارويد_ | | | | --- | --- | | ![صورة نموذجية لصور بولارويد](https://ai.google.dev/static/gemini-api/docs/images/imagen/8_film-types_polaroid-portrait.png?hl=ar)

الطلب: **صورة بولارويد** لكلب يرتدي نظارات شمسية | ![صورة نموذجية بالأبيض والأسود](https://ai.google.dev/static/gemini-api/docs/images/imagen/8_film-types_bw-photo.png?hl=ar)

الطلب: **صورة بالأبيض والأسود** لكلب يرتدي نظارة شمسية | مصدر الصورة: تم إنشاء كل صورة باستخدام الطلب النصي الخاص بها من خلال نموذج Imagen 3. ### الرسومات التوضيحية والفن * يتضمّن الطلب: _"painting من..."_، _"sketch من..."_ تتنوّع الأساليب الفنية بين الأساليب أحادية اللون، مثل رسومات الرصاص، والفن الرقمي الواقعي جدًا. على سبيل المثال، تستخدم الصور التالية الطلب نفسه مع أنماط مختلفة: _"صورة \[art style or creation technique\] لسيارة سيدان كهربائية رياضية ذات تصميم زاوي مع ناطحات سحاب في الخلفية"_ | | | | | --- | --- | --- | | ![صور نماذج فنية](https://ai.google.dev/static/gemini-api/docs/images/imagen/2_style-illustration1A.png?hl=ar)

الطلب: **رسم بقلم رصاص** لزاوية... | ![صور نماذج فنية](https://ai.google.dev/static/gemini-api/docs/images/imagen/2_style-illustration1B.png?hl=ar)

الطلب: **رسم بالفحم** لزاوية... | ![صور نماذج فنية](https://ai.google.dev/static/gemini-api/docs/images/imagen/2_style-illustration1C.png?hl=ar)

الطلب: **رسم بقلم رصاص ملون** ل... | | | | | | --- | --- | --- | | ![صور نماذج فنية](https://ai.google.dev/static/gemini-api/docs/images/imagen/2_style-illustration2E.png?hl=ar)

الطلب: **لوحة مرسومة بألوان الباستيل** لـ... | ![صور نماذج فنية](https://ai.google.dev/static/gemini-api/docs/images/imagen/2_style-illustration2F.png?hl=ar)

الطلب: **عمل فني رقمي** يظهر فيه... | ![صور نماذج فنية](https://ai.google.dev/static/gemini-api/docs/images/imagen/2_style-illustration2G.png?hl=ar)

الطلب: **ملصق** على طراز الآرت ديكو يظهر فيه شكل زاوي... | مصدر الصورة: تم إنشاء كل صورة باستخدام الطلب النصي الخاص بها مع نموذج Imagen 2. ##### الأشكال والمواد * يتضمّن الطلب: _"...مصنوع من..."_، _"...على شكل..."_ من مزايا هذه التكنولوجيا أنّه يمكنك إنشاء صور يصعب أو يستحيل إنشاؤها بطرق أخرى. على سبيل المثال، يمكنك إعادة إنشاء شعار شركتك باستخدام مواد وخامات مختلفة. | | | | | --- | --- | --- | | ![صورة توضيحية 1 عن الأشكال والمواد](https://ai.google.dev/static/gemini-api/docs/images/imagen/9_shapes-materials_duffel.png?hl=ar)

الطلب: حقيبة رياضية كبيرة **مصنوعة من** الجبن | ![صورة توضيحية 2 عن الأشكال والمواد](https://ai.google.dev/static/gemini-api/docs/images/imagen/9_shapes-materials_bird.png?hl=ar)

الطلب: أنابيب نيون **على شكل** طائر | ![صورة توضيحية 3 عن الأشكال والمواد](https://ai.google.dev/static/gemini-api/docs/images/imagen/9_shapes-materials_paper.png?hl=ar)

الطلب: كرسي بذراعين **مصنوع من الورق**، صورة استوديو، أسلوب الأوريغامي | مصدر الصورة: تم إنشاء كل صورة باستخدام الطلب النصي الخاص بها من خلال نموذج Imagen 3. #### مراجع فنية تاريخية * يتضمّن الطلب: _"...بأسلوب..."_ أصبحت بعض الأساليب مميزة على مر السنين. في ما يلي بعض الأفكار حول أنماط اللوحات أو الفنون التاريخية التي يمكنك تجربتها. _"أنشئ صورة بأسلوب \[art period or movement\] : مزرعة رياح"_ | | | | | --- | --- | --- | | ![مثال على صورة انطباعية](https://ai.google.dev/static/gemini-api/docs/images/imagen/10_historical-ref1_impressionism.png?hl=ar)

الطلب: إنشاء صورة **بأسلوب _لوحة انطباعية_**: مزرعة رياح | ![صورة مثال من عصر النهضة](https://ai.google.dev/static/gemini-api/docs/images/imagen/10_historical-ref1_renaissance.png?hl=ar)

الطلب: أنشئ صورة **بأسلوب _لوحة من عصر النهضة_**: مزرعة رياح | ![مثال على صورة فن البوب](https://ai.google.dev/static/gemini-api/docs/images/imagen/10_historical-ref1_pop-art.png?hl=ar)

الطلب: أنشئ صورة **بأسلوب _فن البوب_**: مزرعة رياح | مصدر الصورة: تم إنشاء كل صورة باستخدام الطلب النصي الخاص بها من خلال نموذج Imagen 3. #### معدِّلات جودة الصور يمكن أن تتيح كلمات رئيسية معيّنة للنموذج معرفة أنّك تبحث عن مواد عرض عالية الجودة. تشمل الأمثلة على معدّلات الجودة ما يلي: * **المعدّلات العامة** - _عالي الجودة، جميل، منمّق_ * **الصور** - _4K وHDR و"استوديو صور"_ * **فن، رسم توضيحي** - _من إبداع محترف، تفاصيل دقيقة_ في ما يلي بعض الأمثلة على الطلبات بدون معدّلات جودة والطلب نفسه مع معدّلات جودة. | | | | --- | --- | | ![صورة مثال على الذرة بدون معدّلات](https://ai.google.dev/static/gemini-api/docs/images/imagen/11_quality-modifier2_no-mods.png?hl=ar)

التوجيه (بدون معدّلات الجودة): صورة لساق ذرة | ![صورة مثال على الذرة مع أدوات تعديل](https://ai.google.dev/static/gemini-api/docs/images/imagen/11_quality-modifier2_4k-hdr.png?hl=ar)

الطلب (مع معدّلات الجودة): **صورة جميلة بنطاق عالي الديناميكية بدقة 4K**
لساق ذرة **التقطها
مصوّر محترف** | مصدر الصورة: تم إنشاء كل صورة باستخدام الطلب النصي الخاص بها من خلال نموذج Imagen 3. #### نِسب العرض إلى الارتفاع تتيح لك ميزة إنشاء الصور في Imagen ضبط خمس نسب عرض إلى ارتفاع مختلفة للصور. 1. **مربّع** (1:1، الوضع التلقائي): صورة مربّعة عادية تشمل الاستخدامات الشائعة لنسبة العرض إلى الارتفاع هذه المشاركات على وسائل التواصل الاجتماعي. 2. **ملء الشاشة** (4:3): تُستخدم نسبة العرض إلى الارتفاع هذه عادةً في الوسائط أو الأفلام. وهي أيضًا أبعاد معظم أجهزة التلفزيون القديمة (غير ذات الشاشة العريضة) وكاميرات التنسيق المتوسط. تتيح هذه النسبة التقاط المزيد من المشهد أفقيًا (مقارنةً بنسبة 1:1)، ما يجعلها نسبة العرض إلى الارتفاع المفضّلة للتصوير الفوتوغرافي. | | | | --- | --- | | ![مثال على نسبة العرض إلى الارتفاع](https://ai.google.dev/static/gemini-api/docs/images/imagen/aspect-ratios_4-3_piano.png?hl=ar)

الطلب: صورة مقرّبة لأصابع عازف يعزف على البيانو، فيلم أبيض وأسود، قديم (نسبة عرض إلى ارتفاع 4:3) | ![مثال على نسبة العرض إلى الارتفاع](https://ai.google.dev/static/gemini-api/docs/images/imagen/aspect-ratios_4-3_fries.png?hl=ar)

الطلب: صورة احترافية في استوديو لبطاطس مقلية لمطعم فاخر، بأسلوب مجلة طعام (نسبة العرض إلى الارتفاع 4:3) | 3. **ملء الشاشة في الوضع الرأسي** (3:4): هذه هي نسبة العرض إلى الارتفاع في وضع ملء الشاشة بعد تدويرها بمقدار 90 درجة. يتيح ذلك التقاط المزيد من تفاصيل المشهد عموديًا مقارنةً بنسبة العرض إلى الارتفاع 1:1. | | | | --- | --- | | ![مثال على نسبة العرض إلى الارتفاع](https://ai.google.dev/static/gemini-api/docs/images/imagen/aspect-ratios_3-4_hiking.png?hl=ar)

الطلب: امرأة تتنزّه، لقطة مقرّبة لحذائها منعكسة في بركة، جبال كبيرة في الخلفية، بأسلوب إعلاني، زوايا درامية (نسبة العرض إلى الارتفاع 3:4) | ![مثال على نسبة العرض إلى الارتفاع](https://ai.google.dev/static/gemini-api/docs/images/imagen/aspect-ratios_3-4_valley.png?hl=ar)

الطلب: لقطة جوية لنهر يتدفق في وادٍ غامض (نسبة العرض إلى الارتفاع 3:4) | 4. **الشاشة العريضة** (16:9): حلّت هذه النسبة محل 4:3، وهي الآن نسبة العرض إلى الارتفاع الأكثر شيوعًا في أجهزة التلفزيون والشاشات وشاشات الهواتف الجوّالة (الوضع الأفقي). استخدِم نسبة العرض إلى الارتفاع هذه عندما تريد التقاط المزيد من الخلفية (على سبيل المثال، المناظر الطبيعية الخلابة). ![مثال على نسبة العرض إلى الارتفاع](https://ai.google.dev/static/gemini-api/docs/images/imagen/aspect-ratios_16-9_man.png?hl=ar) الطلب: رجل يرتدي ملابس بيضاء بالكامل ويجلس على الشاطئ، صورة مقربة، إضاءة الساعة الذهبية (نسبة العرض إلى الارتفاع ‎16:9) 5. **الصورة العمودية** (9:16): هذه النسبة هي شاشة عريضة ولكن تم تدويرها. هذه نسبة عرض إلى ارتفاع جديدة نسبيًا، وقد أصبحت رائجة بفضل تطبيقات الفيديوهات القصيرة (مثل فيديوهات Shorts على YouTube). استخدِم هذه السمة للأجسام الطويلة ذات الاتجاهات العمودية القوية، مثل المباني أو الأشجار أو الشلالات أو غيرها من الأجسام المشابهة. ![مثال على نسبة العرض إلى الارتفاع](https://ai.google.dev/static/gemini-api/docs/images/imagen/aspect-ratios_9-16_skyscraper.png?hl=ar) الطلب: تصميم رقمي لناطحة سحاب ضخمة وعصرية وفخمة ومهيبة مع منظر جميل لغروب الشمس في الخلفية (نسبة العرض إلى الارتفاع 9:16) #### صور واقعية قد تقدّم الإصدارات المختلفة من نموذج إنشاء الصور مزيجًا من النتائج الفنية والواقعية. استخدِم الكلمات التالية في الطلبات لإنشاء صور واقعية أكثر استنادًا إلى الموضوع الذي تريد إنشاءه. | حالة الاستخدام | نوع العدسة | الأبعاد البؤرية | تفاصيل إضافية | | --- | --- | --- | --- | | الأشخاص (صور شخصية) | التكبير والتصغير | 24-35 مم | فيلم بالأبيض والأسود، فيلم نوار، عمق المجال، لونان (اذكر لونَين) | | الطعام والحشرات والنباتات (الأشياء، الطبيعة الصامتة) | وحدة الماكرو | ‫60-105 مم | تفاصيل عالية، تركيز دقيق، إضاءة مضبوطة | | الرياضة والحياة البرية (صور متحركة) | التكبير/التصغير باستخدام العدسة المقرّبة | 100-400 مم | سرعة غالق عالية، تتبُّع الحركة | | فلكية، مناظر طبيعية (زاوية عريضة) | زاوية عريضة | 10-24mm | أوقات تعرُّض طويلة للضوء، تركيز حاد، تعرُّض طويل للضوء، مياه أو سُحب ناعمة | ##### صور شخصية | حالة الاستخدام | نوع العدسة | الأبعاد البؤرية | تفاصيل إضافية | | --- | --- | --- | --- | | الأشخاص (صور شخصية) | التكبير والتصغير | 24-35 مم | فيلم بالأبيض والأسود، فيلم نوار، عمق المجال، لونان (اذكر لونَين) | باستخدام عدة كلمات رئيسية من الجدول، يمكن لـ Imagen إنشاء الصور الشخصية التالية: | | | | | | --- | --- | --- | --- | | ![مثال على تصوير الوجه](https://ai.google.dev/static/gemini-api/docs/images/imagen/portrait_blue-gray1.png?hl=ar) | ![مثال على تصوير الوجه](https://ai.google.dev/static/gemini-api/docs/images/imagen/portrait_blue-gray2.png?hl=ar) | ![مثال على تصوير الوجه](https://ai.google.dev/static/gemini-api/docs/images/imagen/portrait_blue-gray3.png?hl=ar) | ![مثال على تصوير الوجه](https://ai.google.dev/static/gemini-api/docs/images/imagen/portrait_blue-gray4.png?hl=ar) | الطلب: _صورة عمودية لامرأة، 35 ملم، درجات أزرق ورمادي_ الطراز: `imagen-3.0-generate-002` | | | | | | --- | --- | --- | --- | | ![مثال على تصوير الوجه](https://ai.google.dev/static/gemini-api/docs/images/imagen/portrait_film-noir1.png?hl=ar) | ![مثال على تصوير الوجه](https://ai.google.dev/static/gemini-api/docs/images/imagen/portrait_film-noir2.png?hl=ar) | ![مثال على تصوير الوجه](https://ai.google.dev/static/gemini-api/docs/images/imagen/portrait_film-noir3.png?hl=ar) | ![مثال على تصوير الوجه](https://ai.google.dev/static/gemini-api/docs/images/imagen/portrait_film-noir4.png?hl=ar) | الطلب: _امرأة، صورة شخصية 35 ملم، فيلم نوار_ النموذج: `imagen-3.0-generate-002` ##### العناصر | حالة الاستخدام | نوع العدسة | الأبعاد البؤرية | تفاصيل إضافية | | --- | --- | --- | --- | | الطعام والحشرات والنباتات (الأشياء، الطبيعة الصامتة) | وحدة الماكرو | ‫60-105 مم | تفاصيل عالية، تركيز دقيق، إضاءة مضبوطة | باستخدام عدة كلمات رئيسية من الجدول، يمكن لـ Imagen إنشاء صور العناصر التالية: | | | | | | --- | --- | --- | --- | | ![مثال على تصوير الأغراض](https://ai.google.dev/static/gemini-api/docs/images/imagen/object_leaf1.png?hl=ar) | ![مثال على تصوير الأغراض](https://ai.google.dev/static/gemini-api/docs/images/imagen/object_leaf2.png?hl=ar) | ![مثال على تصوير الأغراض](https://ai.google.dev/static/gemini-api/docs/images/imagen/object_leaf3.png?hl=ar) | ![مثال على تصوير الأغراض](https://ai.google.dev/static/gemini-api/docs/images/imagen/object_leaf4.png?hl=ar) | الطلب: _ورقة نبات الصلاة، عدسة ماكرو، 60 ملم_ النموذج: `imagen-3.0-generate-002` | | | | | | --- | --- | --- | --- | | ![مثال على تصوير الأغراض](https://ai.google.dev/static/gemini-api/docs/images/imagen/object_pasta1.png?hl=ar) | ![مثال على تصوير الأغراض](https://ai.google.dev/static/gemini-api/docs/images/imagen/object_pasta2.png?hl=ar) | ![مثال على تصوير الأغراض](https://ai.google.dev/static/gemini-api/docs/images/imagen/object_pasta3.png?hl=ar) | ![مثال على تصوير الأغراض](https://ai.google.dev/static/gemini-api/docs/images/imagen/object_pasta4.png?hl=ar) | الطلب: _طبق من المعكرونة، عدسة ماكرو 100 ملم_ النموذج: `imagen-3.0-generate-002` ##### حركة | حالة الاستخدام | نوع العدسة | الأبعاد البؤرية | تفاصيل إضافية | | --- | --- | --- | --- | | الرياضة والحياة البرية (صور متحركة) | التكبير/التصغير باستخدام العدسة المقرّبة | 100-400 مم | سرعة غالق عالية، تتبُّع الحركة | باستخدام عدة كلمات رئيسية من الجدول، يمكن لـ Imagen إنشاء الصور المتحركة التالية: | | | | | | --- | --- | --- | --- | | ![مثال على التصوير أثناء الحركة](https://ai.google.dev/static/gemini-api/docs/images/imagen/motion_football1.png?hl=ar) | ![مثال على التصوير أثناء الحركة](https://ai.google.dev/static/gemini-api/docs/images/imagen/motion_football2.png?hl=ar) | ![مثال على التصوير أثناء الحركة](https://ai.google.dev/static/gemini-api/docs/images/imagen/motion_football3.png?hl=ar) | ![مثال على التصوير أثناء الحركة](https://ai.google.dev/static/gemini-api/docs/images/imagen/motion_football4.png?hl=ar) | الطلب: _إحراز هدف الفوز، سرعة غالق عالية، تتبُّع الحركة_ النموذج: `imagen-3.0-generate-002` | | | | | | --- | --- | --- | --- | | ![مثال على التصوير أثناء الحركة](https://ai.google.dev/static/gemini-api/docs/images/imagen/motion_deer1.png?hl=ar) | ![مثال على التصوير أثناء الحركة](https://ai.google.dev/static/gemini-api/docs/images/imagen/motion_deer2.png?hl=ar) | ![مثال على التصوير أثناء الحركة](https://ai.google.dev/static/gemini-api/docs/images/imagen/motion_deer3.png?hl=ar) | ![مثال على التصوير أثناء الحركة](https://ai.google.dev/static/gemini-api/docs/images/imagen/motion_deer4.png?hl=ar) | الطلب: _غزال يركض في الغابة، سرعة التقاط عالية، تتبُّع الحركة_ النموذج: `imagen-3.0-generate-002` ##### زاوية عريضة | حالة الاستخدام | نوع العدسة | الأبعاد البؤرية | تفاصيل إضافية | | --- | --- | --- | --- | | فلكية، مناظر طبيعية (زاوية عريضة) | زاوية عريضة | 10-24mm | أوقات تعرُّض طويلة للضوء، تركيز حاد، تعرُّض طويل للضوء، مياه أو سُحب ناعمة | باستخدام عدة كلمات رئيسية من الجدول، يمكن لـ Imagen إنشاء الصور التالية بزاوية عريضة: | | | | | | --- | --- | --- | --- | | ![مثال على التصوير بزاوية واسعة](https://ai.google.dev/static/gemini-api/docs/images/imagen/wide-angle_mountain1.png?hl=ar) | ![مثال على التصوير بزاوية واسعة](https://ai.google.dev/static/gemini-api/docs/images/imagen/wide-angle_mountain2.png?hl=ar) | ![مثال على التصوير بزاوية واسعة](https://ai.google.dev/static/gemini-api/docs/images/imagen/wide-angle_mountain3.png?hl=ar) | ![مثال على التصوير بزاوية واسعة](https://ai.google.dev/static/gemini-api/docs/images/imagen/wide-angle_mountain4.png?hl=ar) | الطلب: _سلسلة جبال شاسعة، زاوية واسعة للمشهد الطبيعي 10 ملم_ النموذج: `imagen-3.0-generate-002` | | | | | | --- | --- | --- | --- | | ![مثال على التصوير بزاوية واسعة](https://ai.google.dev/static/gemini-api/docs/images/imagen/wide-angle_astro1.png?hl=ar) | ![مثال على التصوير بزاوية واسعة](https://ai.google.dev/static/gemini-api/docs/images/imagen/wide-angle_astro2.png?hl=ar) | ![مثال على التصوير بزاوية واسعة](https://ai.google.dev/static/gemini-api/docs/images/imagen/wide-angle_astro3.png?hl=ar) | ![مثال على التصوير بزاوية واسعة](https://ai.google.dev/static/gemini-api/docs/images/imagen/wide-angle_astro4.png?hl=ar) | الطلب: _صورة للقمر، تصوير فلكي، زاوية واسعة 10 مم_ النموذج: `imagen-3.0-generate-002` إصدارات النماذج --------------- ### Imagen 4 | الموقع | الوصف | | --- | --- | | id\_cardرمز النموذج | **Gemini API**

`imagen-4.0-generate-001`
`imagen-4.0-ultra-generate-001`
`imagen-4.0-fast-generate-001` | | saveأنواع البيانات المتوافقة | **الإدخال**

نص

**الناتج**

الصور | | token\_autoحدود الرموز المميزة[\[\*\]](https://ai.google.dev/gemini-api/docs/tokens?hl=ar) | **حد الرموز المميزة المدخلة**

‫480 رمزًا مميزًا (نص)

**الصور الناتجة**

من 1 إلى 4 (فائق/عادي/سريع) | | calendar\_monthآخر تعديل | يونيو 2025 | ### Imagen 3 | الموقع | الوصف | | --- | --- | | id\_cardرمز النموذج | **Gemini API**

`imagen-3.0-generate-002` | | saveأنواع البيانات المتوافقة | **الإدخال**

نص

**الناتج**

الصور | | token\_autoحدود الرموز المميزة[\[\*\]](https://ai.google.dev/gemini-api/docs/tokens?hl=ar) | **حد الرموز المميزة المدخلة**

لا ينطبق

**الصور الناتجة**

ما يصل إلى 4 | | calendar\_monthآخر تعديل | فبراير 2025 | إرسال ملاحظات إنّ محتوى هذه الصفحة مرخّص بموجب [ترخيص Creative Commons Attribution 4.0‏](https://creativecommons.org/licenses/by/4.0/) ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب [ترخيص Apache 2.0‏](https://www.apache.org/licenses/LICENSE-2.0) . للاطّلاع على التفاصيل، يُرجى مراجعة [سياسات موقع Google Developers‏](https://developers.google.com/site-policies?hl=ar) . إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين. تاريخ التعديل الأخير: 2025-12-18 (حسب التوقيت العالمي المتفَّق عليه) --- # Membuat video dengan Veo 3.1 di Gemini API  |  Google AI for Developers [Langsung ke konten utama](https://ai.google.dev/gemini-api/docs/video?hl=id#main-content) [![Gemini API](https://ai.google.dev/_static/googledevai/images/gemini-api-logo.svg?hl=id)](https://ai.google.dev/) / * English * Deutsch * Español – América Latina * Français * Indonesia * Italiano * Polski * Português – Brasil * Shqip * Tiếng Việt * Türkçe * Русский * עברית * العربيّة * فارسی * हिंदी * বাংলা * ภาษาไทย * 中文 – 简体 * 中文 – 繁體 * 日本語 * 한국어 [Mendapatkan kunci API](https://aistudio.google.com/apikey?hl=id) [Cookbook](https://github.com/google-gemini/cookbook) [Komunitas](https://discuss.ai.google.dev/c/gemini-api/?hl=id) Masuk * [Beranda](https://ai.google.dev/?hl=id) * [Gemini API](https://ai.google.dev/gemini-api?hl=id) * [Dokumen](https://ai.google.dev/gemini-api/docs?hl=id) Kirim masukan Membuat video dengan Veo 3.1 di Gemini API ========================================== [Veo 3.1](https://deepmind.google/models/veo/?hl=id) adalah model tercanggih Google untuk membuat video 8 detik beresolusi 720p atau 1080p dengan fidelitas tinggi yang menampilkan realisme memukau dan audio yang dibuat secara native. Anda dapat mengakses model ini secara terprogram menggunakan Gemini API. Untuk mempelajari lebih lanjut varian model Veo yang tersedia, lihat bagian [Versi Model](https://ai.google.dev/gemini-api/docs/video?hl=id#model-versions) . Veo 3.1 unggul dalam berbagai gaya visual dan sinematik serta memperkenalkan beberapa kemampuan baru: * **Ekstensi video**: Memperpanjang durasi video yang sebelumnya dibuat menggunakan Veo. * **Pembuatan spesifik per frame**: Buat video dengan menentukan frame pertama dan terakhir. * **Arahan berbasis gambar**: Gunakan hingga tiga gambar referensi untuk memandu konten video yang dibuat. Untuk mengetahui informasi selengkapnya tentang cara menulis perintah teks yang efektif untuk pembuatan video, lihat [panduan perintah Veo](https://ai.google.dev/gemini-api/docs/video?hl=id#prompt-guide) . Pembuatan video dari teks ------------------------- Pilih contoh untuk melihat cara membuat video dengan dialog, realisme sinematik, atau animasi kreatif: Dialog & Efek Suara Realisme Sinematik Animasi Kreatif ### Python import time from google import genai from google.genai import types client = genai.Client() prompt = """A close up of two people staring at a cryptic drawing on a wall, torchlight flickering. A man murmurs, 'This must be it. That's the secret code.' The woman looks at him and whispering excitedly, 'What did you find?'""" operation = client.models.generate_videos( model="veo-3.1-generate-preview", prompt=prompt, ) # Poll the operation status until the video is ready. while not operation.done: print("Waiting for video generation to complete...") time.sleep(10) operation = client.operations.get(operation) # Download the generated video. generated_video = operation.response.generated_videos[0] client.files.download(file=generated_video.video) generated_video.video.save("dialogue_example.mp4") print("Generated video saved to dialogue_example.mp4") ### JavaScript import { GoogleGenAI } from "@google/genai"; const ai = new GoogleGenAI({}); const prompt = `A close up of two people staring at a cryptic drawing on a wall, torchlight flickering. A man murmurs, 'This must be it. That's the secret code.' The woman looks at him and whispering excitedly, 'What did you find?'`; let operation = await ai.models.generateVideos({ model: "veo-3.1-generate-preview", prompt: prompt, }); // Poll the operation status until the video is ready. while (!operation.done) { console.log("Waiting for video generation to complete...") await new Promise((resolve) => setTimeout(resolve, 10000)); operation = await ai.operations.getVideosOperation({ operation: operation, }); } // Download the generated video. ai.files.download({ file: operation.response.generatedVideos[0].video, downloadPath: "dialogue_example.mp4", }); console.log(`Generated video saved to dialogue_example.mp4`); ### Go package main import ( "context" "log" "os" "time" "google.golang.org/genai" ) func main() { ctx := context.Background() client, err := genai.NewClient(ctx, nil) if err != nil { log.Fatal(err) } prompt := `A close up of two people staring at a cryptic drawing on a wall, torchlight flickering. A man murmurs, 'This must be it. That's the secret code.' The woman looks at him and whispering excitedly, 'What did you find?'` operation, _ := client.Models.GenerateVideos( ctx, "veo-3.1-generate-preview", prompt, nil, nil, ) // Poll the operation status until the video is ready. for !operation.Done { log.Println("Waiting for video generation to complete...") time.Sleep(10 * time.Second) operation, _ = client.Operations.GetVideosOperation(ctx, operation, nil) } // Download the generated video. video := operation.Response.GeneratedVideos[0] client.Files.Download(ctx, video.Video, nil) fname := "dialogue_example.mp4" _ = os.WriteFile(fname, video.Video.VideoBytes, 0644) log.Printf("Generated video saved to %s\n", fname) } ### REST # Note: This script uses jq to parse the JSON response. # GEMINI API Base URL BASE_URL="https://generativelanguage.googleapis.com/v1beta" # Send request to generate video and capture the operation name into a variable. operation_name=$(curl -s "${BASE_URL}/models/veo-3.1-generate-preview:predictLongRunning" \ -H "x-goog-api-key: $GEMINI_API_KEY" \ -H "Content-Type: application/json" \ -X "POST" \ -d '{ "instances": [{\ "prompt": "A close up of two people staring at a cryptic drawing on a wall, torchlight flickering. A man murmurs, \"This must be it. That'\''s the secret code.\" The woman looks at him and whispering excitedly, \"What did you find?\""\ }\ ] }' | jq -r .name) # Poll the operation status until the video is ready while true; do # Get the full JSON status and store it in a variable. status_response=$(curl -s -H "x-goog-api-key: $GEMINI_API_KEY" "${BASE_URL}/${operation_name}") # Check the "done" field from the JSON stored in the variable. is_done=$(echo "${status_response}" | jq .done) if [ "${is_done}" = "true" ]; then # Extract the download URI from the final response. video_uri=$(echo "${status_response}" | jq -r '.response.generateVideoResponse.generatedSamples[0].video.uri') echo "Downloading video from: ${video_uri}" # Download the video using the URI and API key and follow redirects. curl -L -o dialogue_example.mp4 -H "x-goog-api-key: $GEMINI_API_KEY" "${video_uri}" break fi # Wait for 5 seconds before checking again. sleep 10 done Pembuatan video dari gambar --------------------------- Kode berikut menunjukkan cara membuat gambar menggunakan [Gemini 2.5 Flash Image alias Nano Banana](https://ai.google.dev/gemini-api/docs/image-generation?hl=id) , lalu menggunakan gambar tersebut sebagai frame awal untuk membuat video dengan Veo 3.1. ### Python import time from google import genai client = genai.Client() prompt = "Panning wide shot of a calico kitten sleeping in the sunshine" # Step 1: Generate an image with Nano Banana. image = client.models.generate_content( model="gemini-2.5-flash-image", contents=prompt, config={"response_modalities":['IMAGE']} ) # Step 2: Generate video with Veo 3.1 using the image. operation = client.models.generate_videos( model="veo-3.1-generate-preview", prompt=prompt, image=image.parts[0].as_image(), ) # Poll the operation status until the video is ready. while not operation.done: print("Waiting for video generation to complete...") time.sleep(10) operation = client.operations.get(operation) # Download the video. video = operation.response.generated_videos[0] client.files.download(file=video.video) video.video.save("veo3_with_image_input.mp4") print("Generated video saved to veo3_with_image_input.mp4") ### JavaScript import { GoogleGenAI } from "@google/genai"; const ai = new GoogleGenAI({}); const prompt = "Panning wide shot of a calico kitten sleeping in the sunshine"; // Step 1: Generate an image with Nano Banana. const imageResponse = await ai.models.generateContent({ model: "gemini-2.5-flash-image", prompt: prompt, }); // Step 2: Generate video with Veo 3.1 using the image. let operation = await ai.models.generateVideos({ model: "veo-3.1-generate-preview", prompt: prompt, image: { imageBytes: imageResponse.generatedImages[0].image.imageBytes, mimeType: "image/png", }, }); // Poll the operation status until the video is ready. while (!operation.done) { console.log("Waiting for video generation to complete...") await new Promise((resolve) => setTimeout(resolve, 10000)); operation = await ai.operations.getVideosOperation({ operation: operation, }); } // Download the video. ai.files.download({ file: operation.response.generatedVideos[0].video, downloadPath: "veo3_with_image_input.mp4", }); console.log(`Generated video saved to veo3_with_image_input.mp4`); ### Go package main import ( "context" "log" "os" "time" "google.golang.org/genai" ) func main() { ctx := context.Background() client, err := genai.NewClient(ctx, nil) if err != nil { log.Fatal(err) } prompt := "Panning wide shot of a calico kitten sleeping in the sunshine" // Step 1: Generate an image with Nano Banana. imageResponse, err := client.Models.GenerateContent( ctx, "gemini-2.5-flash-image", prompt, nil, // GenerateImagesConfig ) if err != nil { log.Fatal(err) } // Step 2: Generate video with Veo 3.1 using the image. operation, err := client.Models.GenerateVideos( ctx, "veo-3.1-generate-preview", prompt, imageResponse.GeneratedImages[0].Image, nil, // GenerateVideosConfig ) if err != nil { log.Fatal(err) } // Poll the operation status until the video is ready. for !operation.Done { log.Println("Waiting for video generation to complete...") time.Sleep(10 * time.Second) operation, _ = client.Operations.GetVideosOperation(ctx, operation, nil) } // Download the video. video := operation.Response.GeneratedVideos[0] client.Files.Download(ctx, video.Video, nil) fname := "veo3_with_image_input.mp4" _ = os.WriteFile(fname, video.Video.VideoBytes, 0644) log.Printf("Generated video saved to %s\n", fname) } ### Menggunakan gambar referensi Veo 3.1 kini menerima hingga 3 gambar referensi untuk memandu konten video yang dihasilkan. Berikan gambar orang, karakter, atau produk untuk mempertahankan penampilan subjek dalam video output. Misalnya, menggunakan tiga gambar yang dibuat dengan [Nano Banana](https://ai.google.dev/gemini-api/docs/image-generation?hl=id) sebagai referensi dengan [perintah yang ditulis dengan baik](https://ai.google.dev/gemini-api/docs/video?hl=id#use-reference-images) akan membuat video berikut: | `` `dress_image` `` | `` `woman_image` `` | `` `glasses_image` `` | | --- | --- | --- | | ![Gaun flamingo kelas atas dengan lapisan bulu merah muda dan fuchsia](https://storage.googleapis.com/generativeai-downloads/images/flamingo.png) | ![Perempuan cantik dengan rambut gelap dan mata cokelat hangat](https://storage.googleapis.com/generativeai-downloads/images/flamingo_woman.png) | ![Kacamata surya berbentuk hati merah muda yang unik](https://storage.googleapis.com/generativeai-downloads/images/flamingo_glasses.png) | ### Python import time from google import genai client = genai.Client() prompt = "The video opens with a medium, eye-level shot of a beautiful woman with dark hair and warm brown eyes. She wears a magnificent, high-fashion flamingo dress with layers of pink and fuchsia feathers, complemented by whimsical pink, heart-shaped sunglasses. She walks with serene confidence through the crystal-clear, shallow turquoise water of a sun-drenched lagoon. The camera slowly pulls back to a medium-wide shot, revealing the breathtaking scene as the dress's long train glides and floats gracefully on the water's surface behind her. The cinematic, dreamlike atmosphere is enhanced by the vibrant colors of the dress against the serene, minimalist landscape, capturing a moment of pure elegance and high-fashion fantasy." dress_reference = types.VideoGenerationReferenceImage( image=dress_image, # Generated separately with Nano Banana reference_type="asset" ) sunglasses_reference = types.VideoGenerationReferenceImage( image=glasses_image, # Generated separately with Nano Banana reference_type="asset" ) woman_reference = types.VideoGenerationReferenceImage( image=woman_image, # Generated separately with Nano Banana reference_type="asset" ) operation = client.models.generate_videos( model="veo-3.1-generate-preview", prompt=prompt, config=types.GenerateVideosConfig( reference_images=[dress_reference, glasses_reference, woman_reference], ), ) # Poll the operation status until the video is ready. while not operation.done: print("Waiting for video generation to complete...") time.sleep(10) operation = client.operations.get(operation) # Download the video. video = operation.response.generated_videos[0] client.files.download(file=video.video) video.video.save("veo3.1_with_reference_images.mp4") print("Generated video saved to veo3.1_with_reference_images.mp4") ### Menggunakan frame pertama dan terakhir Veo 3.1 memungkinkan Anda membuat video menggunakan interpolasi, atau menentukan frame pertama dan terakhir video. Untuk mengetahui informasi tentang cara menulis perintah teks yang efektif untuk pembuatan video, lihat [panduan perintah Veo](https://ai.google.dev/gemini-api/docs/video?hl=id#use-reference-images) . ### Python import time from google import genai client = genai.Client() prompt = "A cinematic, haunting video. A ghostly woman with long white hair and a flowing dress swings gently on a rope swing beneath a massive, gnarled tree in a foggy, moonlit clearing. The fog thickens and swirls around her, and she slowly fades away, vanishing completely. The empty swing is left swaying rhythmically on its own in the eerie silence." operation = client.models.generate_videos( model="veo-3.1-generate-preview", prompt=prompt, image=first_image, # Generated separately with Nano Banana config=types.GenerateVideosConfig( last_frame=last_image # Generated separately with Nano Banana ), ) # Poll the operation status until the video is ready. while not operation.done: print("Waiting for video generation to complete...") time.sleep(10) operation = client.operations.get(operation) # Download the video. video = operation.response.generated_videos[0] client.files.download(file=video.video) video.video.save("veo3.1_with_interpolation.mp4") print("Generated video saved to veo3.1_with_interpolation.mp4") | `` `first_image` `` | `` `last_image` `` | _veo3.1\_with\_interpolation.mp4_ | | --- | --- | --- | | ![Seorang wanita hantu dengan rambut putih panjang dan gaun yang berkibar berayun perlahan di ayunan tali](https://storage.googleapis.com/generativeai-downloads/images/ghost_girl.png) | ![Wanita hantu menghilang dari ayunan](https://storage.googleapis.com/generativeai-downloads/images/empty_tree.png) | ![Video sinematik yang menghantui tentang seorang wanita menyeramkan yang menghilang dari ayunan di dalam kabut](https://storage.googleapis.com/generativeai-downloads/images/creepy_swing.gif) | Memperpanjang video Veo ----------------------- Gunakan Veo 3.1 untuk memperpanjang video yang sebelumnya Anda buat dengan Veo hingga 7 detik dan hingga 20 kali. Batasan video input: * Video yang dibuat Veo hanya berdurasi hingga 141 detik. * Gemini API hanya mendukung ekstensi video untuk video yang dibuat Veo. * Video harus berasal dari generasi sebelumnya, seperti `operation.response.generated_videos[0].video` * Video input diharapkan memiliki durasi, rasio aspek, dan dimensi tertentu: * Rasio aspek: 9:16 atau 16:9 * Resolusi: 720p * Durasi video: 141 detik atau kurang Output ekstensi adalah satu video yang menggabungkan video input pengguna dan video yang diperpanjang yang dihasilkan hingga 148 detik video. Contoh ini mengambil video yang dibuat Veo, yang ditampilkan di sini dengan perintah aslinya, dan memperpanjangnya menggunakan parameter `video` dan perintah baru: | Perintah | Output: `butterfly_video` | | --- | --- | | Kupu-kupu origami mengepakkan sayapnya dan terbang keluar dari pintu kaca menuju taman. | ![Kupu-kupu origami mengepakkan sayapnya dan terbang keluar dari pintu kaca menuju taman.](https://storage.googleapis.com/generativeai-downloads/images/Butterfly_original.gif) | ### Python import time from google import genai client = genai.Client() prompt = "Track the butterfly into the garden as it lands on an orange origami flower. A fluffy white puppy runs up and gently pats the flower." operation = client.models.generate_videos( model="veo-3.1-generate-preview", video=operation.response.generated_videos[0].video, # This must be a video from a previous generation prompt=prompt, config=types.GenerateVideosConfig( number_of_videos=1, resolution="720p" ), ) # Poll the operation status until the video is ready. while not operation.done: print("Waiting for video generation to complete...") time.sleep(10) operation = client.operations.get(operation) # Download the video. video = operation.response.generated_videos[0] client.files.download(file=video.video) video.video.save("veo3.1_extension.mp4") print("Generated video saved to veo3.1_extension.mp4") Untuk mengetahui informasi tentang cara menulis perintah teks yang efektif untuk pembuatan video, lihat [panduan perintah Veo](https://ai.google.dev/gemini-api/docs/video?hl=id#extend-prompt) . Menangani operasi asinkron -------------------------- Pembuatan video adalah tugas yang intensif secara komputasi. Saat Anda mengirim permintaan ke API, API akan memulai tugas yang berjalan lama dan segera menampilkan objek `operation`. Kemudian, Anda harus melakukan polling hingga video siap, yang ditunjukkan oleh status `done` yang benar. Inti dari proses ini adalah loop polling, yang secara berkala memeriksa status tugas. ### Python import time from google import genai from google.genai import types client = genai.Client() # After starting the job, you get an operation object. operation = client.models.generate_videos( model="veo-3.1-generate-preview", prompt="A cinematic shot of a majestic lion in the savannah.", ) # Alternatively, you can use operation.name to get the operation. operation = types.GenerateVideosOperation(name=operation.name) # This loop checks the job status every 10 seconds. while not operation.done: time.sleep(10) # Refresh the operation object to get the latest status. operation = client.operations.get(operation) # Once done, the result is in operation.response. # ... process and download your video ... ### JavaScript import { GoogleGenAI } from "@google/genai"; const ai = new GoogleGenAI({}); // After starting the job, you get an operation object. let operation = await ai.models.generateVideos({ model: "veo-3.1-generate-preview", prompt: "A cinematic shot of a majestic lion in the savannah.", }); // Alternatively, you can use operation.name to get the operation. // operation = types.GenerateVideosOperation(name=operation.name) // This loop checks the job status every 10 seconds. while (!operation.done) { await new Promise((resolve) => setTimeout(resolve, 1000)); // Refresh the operation object to get the latest status. operation = await ai.operations.getVideosOperation({ operation }); } // Once done, the result is in operation.response. // ... process and download your video ... Parameter dan spesifikasi Veo API --------------------------------- Berikut adalah parameter yang dapat Anda tetapkan dalam permintaan API untuk mengontrol proses pembuatan video. | Parameter | Deskripsi | Veo 3.1 & Veo 3.1 Fast | Veo 3 & Veo 3 Fast | Veo 2 | | --- | --- | --- | --- | --- | | `prompt` | Deskripsi teks untuk video. Mendukung isyarat audio. | `string` | `string` | `string` | | `negativePrompt` | Teks yang menjelaskan apa yang tidak boleh disertakan dalam video. | `string` | `string` | `string` | | `image` | Gambar awal yang akan dianimasikan. | Objek `Image` | Objek `Image` | Objek `Image` | | `lastFrame` | Gambar akhir untuk transisi video interpolasi. Harus digunakan bersama dengan parameter `image`. | Objek `Image` | Objek `Image` | Objek `Image` | | `referenceImages` | Hingga tiga gambar yang akan digunakan sebagai referensi gaya dan konten. | Objek `VideoGenerationReferenceImage` (khusus Veo 3.1) | t/a | t/a | | `video` | Video yang akan digunakan untuk ekstensi video. | Objek `Video` | t/a | t/a | | `aspectRatio` | Rasio aspek video. | `"16:9"` (default, 720p & 1080p),
`"9:16"`(720p & 1080p) | `"16:9"` (default, 720p & 1080p),
`"9:16"` (720p & 1080p) | `"16:9"` (default, 720p),
`"9:16"` (720p) | | `resolution` | Rasio aspek video. | `"720p"` (default),
`"1080p"` (hanya mendukung durasi 8 detik)

`"720p"` hanya untuk ekstensi | `"720p"` (default),
`"1080p"` (khusus 16:9) | Tidak didukung | | `durationSeconds` | Durasi video yang dihasilkan. | `"4"`, `"6"`, `"8"`.

Harus "8" saat menggunakan ekstensi atau interpolasi (mendukung 16:9 dan 9:16), dan saat menggunakan `referenceImages` (hanya mendukung 16:9) | `"4"`, `"6"`, `"8"` | `"5"`, `"6"`, `"8"` | | `personGeneration` | Mengontrol pembuatan orang.
(Lihat [Batasan](https://ai.google.dev/gemini-api/docs/video?hl=id#limitations)
untuk mengetahui batasan wilayah) | Text-to-video & Ekstensi:
`"allow_all"` saja
Image-to-video, Interpolasi, & Gambar referensi:
`"allow_adult"` saja | Teks ke video:
`"allow_all"` saja
Gambar ke video:
`"allow_adult"` saja | Teks ke video:
`"allow_all"`, `"allow_adult"`, `"dont_allow"`
Gambar ke video:
`"allow_adult"`, dan `"dont_allow"` | Perhatikan bahwa parameter `seed` juga tersedia untuk model Veo 3. Hal ini tidak menjamin determinisme, tetapi sedikit meningkatkannya. Anda dapat menyesuaikan pembuatan video dengan menetapkan parameter dalam permintaan. Misalnya, Anda dapat menentukan `negativePrompt` untuk memandu model. ### Python import time from google import genai from google.genai import types client = genai.Client() operation = client.models.generate_videos( model="veo-3.1-generate-preview", prompt="A cinematic shot of a majestic lion in the savannah.", config=types.GenerateVideosConfig(negative_prompt="cartoon, drawing, low quality"), ) # Poll the operation status until the video is ready. while not operation.done: print("Waiting for video generation to complete...") time.sleep(10) operation = client.operations.get(operation) # Download the generated video. generated_video = operation.response.generated_videos[0] client.files.download(file=generated_video.video) generated_video.video.save("parameters_example.mp4") print("Generated video saved to parameters_example.mp4") ### JavaScript import { GoogleGenAI } from "@google/genai"; const ai = new GoogleGenAI({}); let operation = await ai.models.generateVideos({ model: "veo-3.1-generate-preview", prompt: "A cinematic shot of a majestic lion in the savannah.", config: { aspectRatio: "16:9", negativePrompt: "cartoon, drawing, low quality" }, }); // Poll the operation status until the video is ready. while (!operation.done) { console.log("Waiting for video generation to complete...") await new Promise((resolve) => setTimeout(resolve, 10000)); operation = await ai.operations.getVideosOperation({ operation: operation, }); } // Download the generated video. ai.files.download({ file: operation.response.generatedVideos[0].video, downloadPath: "parameters_example.mp4", }); console.log(`Generated video saved to parameters_example.mp4`); ### Go package main import ( "context" "log" "os" "time" "google.golang.org/genai" ) func main() { ctx := context.Background() client, err := genai.NewClient(ctx, nil) if err != nil { log.Fatal(err) } videoConfig := &genai.GenerateVideosConfig{ AspectRatio: "16:9", NegativePrompt: "cartoon, drawing, low quality", } operation, _ := client.Models.GenerateVideos( ctx, "veo-3.1-generate-preview", "A cinematic shot of a majestic lion in the savannah.", nil, videoConfig, ) // Poll the operation status until the video is ready. for !operation.Done { log.Println("Waiting for video generation to complete...") time.Sleep(10 * time.Second) operation, _ = client.Operations.GetVideosOperation(ctx, operation, nil) } // Download the generated video. video := operation.Response.GeneratedVideos[0] client.Files.Download(ctx, video.Video, nil) fname := "parameters_example.mp4" _ = os.WriteFile(fname, video.Video.VideoBytes, 0644) log.Printf("Generated video saved to %s\n", fname) } ### REST # Note: This script uses jq to parse the JSON response. # GEMINI API Base URL BASE_URL="https://generativelanguage.googleapis.com/v1beta" # Send request to generate video and capture the operation name into a variable. operation_name=$(curl -s "${BASE_URL}/models/veo-3.1-generate-preview:predictLongRunning" \ -H "x-goog-api-key: $GEMINI_API_KEY" \ -H "Content-Type: application/json" \ -X "POST" \ -d '{ "instances": [{\ "prompt": "A cinematic shot of a majestic lion in the savannah."\ }\ ], "parameters": { "aspectRatio": "16:9", "negativePrompt": "cartoon, drawing, low quality" } }' | jq -r .name) # Poll the operation status until the video is ready while true; do # Get the full JSON status and store it in a variable. status_response=$(curl -s -H "x-goog-api-key: $GEMINI_API_KEY" "${BASE_URL}/${operation_name}") # Check the "done" field from the JSON stored in the variable. is_done=$(echo "${status_response}" | jq .done) if [ "${is_done}" = "true" ]; then # Extract the download URI from the final response. video_uri=$(echo "${status_response}" | jq -r '.response.generateVideoResponse.generatedSamples[0].video.uri') echo "Downloading video from: ${video_uri}" # Download the video using the URI and API key and follow redirects. curl -L -o parameters_example.mp4 -H "x-goog-api-key: $GEMINI_API_KEY" "${video_uri}" break fi # Wait for 5 seconds before checking again. sleep 10 done Panduan perintah Veo -------------------- Bagian ini berisi contoh video yang dapat Anda buat menggunakan Veo, dan menunjukkan cara mengubah perintah untuk menghasilkan hasil yang berbeda. ### Filter keamanan Veo menerapkan filter keamanan di Gemini untuk membantu memastikan bahwa video yang dihasilkan dan foto yang diupload tidak berisi konten yang menyinggung. Perintah yang melanggar [persyaratan dan pedoman](https://ai.google.dev/gemini-api/docs/usage-policies?hl=id#abuse-monitoring) kami akan diblokir. ### Dasar-dasar penulisan perintah Perintah yang baik bersifat deskriptif dan jelas. Untuk mendapatkan hasil maksimal dari Veo, mulailah dengan mengidentifikasi ide inti Anda, sempurnakan ide Anda dengan menambahkan kata kunci dan pengubah, serta sertakan terminologi khusus video dalam perintah Anda. Elemen berikut harus disertakan dalam perintah Anda: * **Subjek**: Objek, orang, hewan, atau pemandangan yang Anda inginkan dalam video, seperti _pemandangan kota_, _alam_, _kendaraan_, atau _anak_. * **Tindakan**: Apa yang dilakukan subjek (misalnya, _berjalan_, _berlari_, atau _menolehkan kepala_). * **Gaya**: Tentukan arah kreatif menggunakan kata kunci gaya film tertentu, seperti _sci-fi_, _film horor_, _film noir_, atau gaya animasi seperti _kartun_. * **Pemosisian dan gerakan kamera**: \[Opsional\] Kontrol lokasi dan gerakan kamera menggunakan istilah seperti _tampilan dari atas_, _sejajar mata_, _bidikan dari atas_, _bidikan dolly_, atau _mata cacing_. * **Komposisi**: \[Opsional\] Cara pengambilan gambar, seperti _sudut lebar_, _close-up_, _satu bidikan_, atau _dua bidikan_. * **Efek fokus dan lensa**: \[Opsional\] Gunakan istilah seperti _fokus dangkal_, _fokus dalam_, _soft focus_, _lensa makro_, dan _lensa sudut lebar_ untuk mendapatkan efek visual tertentu. * **Suasana**: \[Opsional\] Bagaimana warna dan cahaya berkontribusi pada latar, seperti _nuansa biru_, _malam_, atau _nuansa hangat_. #### Tips lainnya untuk menulis perintah * **Gunakan bahasa deskriptif**: Gunakan kata sifat dan kata keterangan untuk memberikan gambaran yang jelas kepada Veo. * **Meningkatkan kualitas detail wajah**: Tentukan detail wajah sebagai fokus foto, misalnya dengan menggunakan kata _potret_ dalam perintah. _Untuk strategi penulisan perintah yang lebih komprehensif, buka [Pengantar desain perintah](https://ai.google.dev/gemini-api/docs/prompting-intro?hl=id) ._ ### Meminta audio Dengan Veo 3, Anda dapat memberikan petunjuk untuk efek suara, suara bising di sekitar, dan dialog. Model menangkap nuansa isyarat ini untuk menghasilkan soundtrack yang disinkronkan. * **Dialog:** Gunakan tanda petik untuk ucapan tertentu. (Contoh: "Ini pasti kuncinya," gumamnya.) * **Efek Suara (SFX):** Jelaskan suara secara eksplisit. (Contoh: ban berdecit keras, deru mesin.) * **Suara Latar:** Jelaskan lanskap suara lingkungan. (Contoh: Suara dengungan samar dan aneh beresonansi di latar belakang.) Video ini menunjukkan pembuatan audio Veo 3 dengan perintah yang memiliki tingkat detail yang berbeda-beda. | **Perintah** | **Output yang dihasilkan** | | --- | --- | | **Detail lainnya (Dialog dan suasana)**
Gambar lebar hutan Pacific Northwest yang berkabut. Dua pendaki yang kelelahan, seorang pria dan seorang wanita, berjalan melewati pakis ketika pria itu tiba-tiba berhenti, menatap pohon. Tampilan close-up: Bekas cakaran yang dalam dan baru terlihat di kulit pohon. Pria: (Tangan di pisau berburunya) "Itu bukan beruang biasa." Wanita: (Suara tegang karena takut, memindai hutan) "Lalu apa itu?" Kulit kayu yang kasar, ranting yang patah, langkah kaki di tanah yang lembap. Seekor burung berkicau. | ![Dua orang di hutan menemukan tanda-tanda keberadaan beruang.](https://storage.googleapis.com/generativeai-downloads/images/Scary_Bear.gif) | | **Lebih sedikit detail (Dialog)**
Animasi Potongan Kertas. Pustakawan Baru: "Di mana Anda menyimpan buku-buku terlarang?" Kurator Lama: "Tidak. Mereka menjaga kita." | ![Pustakawan animasi yang mendiskusikan buku-buku terlarang](https://storage.googleapis.com/generativeai-downloads/images/Library.gif) | Coba sendiri perintah ini untuk mendengar audionya. [Coba Veo 3](https://deepmind.google/models/veo/?hl=id) ### Menulis perintah dengan gambar referensi Anda dapat menggunakan satu atau beberapa gambar sebagai input untuk memandu video yang dibuat, menggunakan kemampuan [image-to-video](https://ai.google.dev/gemini-api/docs/video?hl=id#generate-from-images) Veo. Veo menggunakan gambar input sebagai frame awal. Pilih gambar yang paling mendekati visi Anda sebagai adegan pertama video untuk menganimasikan objek sehari-hari, menghidupkan gambar dan lukisan, serta menambahkan gerakan dan suara ke pemandangan alam. | **Perintah** | **Output yang dihasilkan** | | --- | --- | | **Gambar input (Dibuat oleh Nano Banana)**
Foto makro hiper-realistis peselancar kecil miniatur yang sedang berselancar di ombak laut di dalam wastafel kamar mandi batu pedesaan. Keran kuningan antik mengalirkan air, menciptakan ombak abadi. Surealis, unik, pencahayaan alami yang terang. | ![Peselancar miniatur kecil yang menunggangi ombak laut di dalam wastafel kamar mandi batu rustic.](https://storage.googleapis.com/generativeai-downloads/images/Sink_Surfers.png) | | **Video Output (Dibuat oleh Veo 3.1)**
Video makro sinematik yang surealis. Peselancar kecil menunggangi ombak yang terus bergulung di dalam wastafel kamar mandi batu. Keran kuningan antik yang mengalirkan air akan menghasilkan suara ombak yang tak berujung. Kamera perlahan-lahan menggeser pemandangan yang unik dan diterangi sinar matahari saat sosok miniatur dengan ahli mengukir air biru kehijauan. | ![Peselancar kecil mengelilingi ombak di wastafel kamar mandi.](https://storage.googleapis.com/generativeai-downloads/images/sink_surfers.gif) | Veo 3.1 memungkinkan Anda mereferensikan gambar atau bahan untuk mengarahkan konten video yang dihasilkan. Berikan hingga tiga gambar aset dari satu orang, karakter, atau produk. Veo mempertahankan penampilan subjek dalam video output. | **Perintah** | **Output yang dihasilkan** | | --- | --- | | **Gambar referensi (Dibuat oleh Nano Banana)**
Ikan sungut ganda laut dalam bersembunyi di laut dalam yang gelap, dengan gigi terbuka dan umpan bercahaya. | ![Ikan pemancing yang gelap dan bercahaya](https://storage.googleapis.com/generativeai-downloads/images/angler_fish.png) | | **Gambar referensi (Dibuat oleh Nano Banana)**
Kostum putri anak berwarna merah muda lengkap dengan tongkat dan tiara, di latar belakang produk polos. | ![Kostum putri merah muda anak](https://storage.googleapis.com/generativeai-downloads/images/princess_dress.png) | | **Video Output (Dibuat oleh Veo 3.1)**
Buat versi kartun konyol dari ikan yang mengenakan kostum, berenang, dan mengayunkan tongkat. | ![Ikan pemancing mengenakan kostum putri](https://storage.googleapis.com/generativeai-downloads/images/angler_princess.gif) | Dengan Veo 3.1, Anda juga dapat membuat video dengan menentukan frame pertama dan terakhir video. | **Perintah** | **Output yang dihasilkan** | | --- | --- | | **Gambar pertama (Dibuat oleh Nano Banana)**
Gambar depan realistis berkualitas tinggi dari seekor kucing oranye yang mengendarai mobil balap convertible merah di pesisir French Riviera. | ![Kucing oranye mengendarai mobil balap convertible merah](https://storage.googleapis.com/generativeai-downloads/images/ginger_race_cat.jpeg) | | **Gambar terakhir (Dibuat oleh Nano Banana)**
Tunjukkan apa yang terjadi saat mobil melaju dari tebing. | ![Kucing oranye mengendarai mobil convertible merah dan jatuh dari tebing](https://storage.googleapis.com/generativeai-downloads/images/race_cat_cliff.jpeg) | | **Video Output (Dibuat oleh Veo 3.1)**
Opsional | ![Seekor kucing mengemudi dari tebing dan terbang](https://storage.googleapis.com/generativeai-downloads/images/race_cat_cliff.gif) | Fitur ini memberi Anda kontrol yang presisi atas komposisi bidikan dengan memungkinkan Anda menentukan frame awal dan akhir. Upload gambar atau gunakan frame dari pembuatan video sebelumnya untuk memastikan adegan Anda dimulai dan diakhiri persis seperti yang Anda bayangkan. ### Meminta perpanjangan waktu Untuk memperpanjang video yang dibuat Veo dengan Veo 3.1, gunakan video tersebut sebagai input bersama dengan perintah teks opsional. Perpanjang menyelesaikan detik terakhir atau 24 frame terakhir video Anda dan melanjutkan aksinya. Perhatikan bahwa suara tidak dapat diperpanjang secara efektif jika tidak ada dalam 1 detik terakhir video. | **Perintah** | **Output yang dihasilkan** | | --- | --- | | **Video input (Dibuat oleh Veo 3.1)**
Paralayang lepas landas dari puncak gunung dan mulai meluncur menuruni gunung yang menghadap ke lembah yang tertutup bunga di bawahnya. | ![Paralayang lepas landas dari puncak gunung](https://storage.googleapis.com/generativeai-downloads/images/Paraglider.gif) | | **Video Output (Dibuat oleh Veo 3.1)**
Perpanjang video ini dengan paralayang yang turun perlahan. | ![Paralayang lepas landas dari puncak gunung, lalu turun perlahan](https://storage.googleapis.com/generativeai-downloads/images/Paraglider_Extend.gif) | ### Contoh perintah dan output Bagian ini menyajikan beberapa perintah, yang menyoroti bagaimana detail deskriptif dapat meningkatkan hasil setiap video. #### Bunga Es Video ini menunjukkan cara menggunakan elemen [dasar-dasar penulisan perintah](https://ai.google.dev/gemini-api/docs/video?hl=id#basics) dalam perintah Anda. | **Perintah** | **Output yang dihasilkan** | | --- | --- | | Foto close-up (komposisi) tetesan air yang mencair (subjek) di dinding batu yang membeku (konteks) dengan nuansa biru dingin (suasana), diperbesar (gerakan kamera) sambil mempertahankan detail close-up tetesan air (tindakan). | ![Tetesan es dengan latar belakang biru.](https://storage.googleapis.com/generativeai-downloads/images/Icicles.gif) | #### Pria sedang menelepon Video ini menunjukkan cara merevisi perintah Anda dengan detail yang semakin spesifik agar Veo menyempurnakan output sesuai keinginan Anda. | **Perintah** | **Output yang dihasilkan** | | --- | --- | | **Lebih sedikit detail**
Kamera bergerak untuk menampilkan close-up seorang pria putus asa yang mengenakan jas hujan hijau. Dia sedang menelepon menggunakan telepon dinding putar dengan lampu neon hijau. Tampak seperti adegan film. | ![Pria sedang menelepon.](https://storage.googleapis.com/generativeai-downloads/images/Desperate_Man.gif) | | **Detail selengkapnya**
Bidikan sinematik close-up mengikuti seorang pria putus asa yang mengenakan jas hujan hijau lusuh saat dia memutar nomor telepon putar yang terpasang di dinding bata kasar, yang disinari cahaya aneh dari tanda neon hijau. Kamera bergerak mendekat, memperlihatkan ketegangan di rahangnya dan keputusasaan yang terukir di wajahnya saat ia berjuang untuk melakukan panggilan. Kedalaman bidang gambar yang dangkal berfokus pada alisnya yang berkerut dan telepon putar hitam, mengaburkan latar belakang menjadi lautan warna neon dan bayangan yang tidak jelas, sehingga menciptakan kesan mendesak dan terisolasi. | ![Pria sedang menelepon](https://storage.googleapis.com/generativeai-downloads/images/detail_call.gif) | #### Macan tutul salju | **Perintah** | **Output yang dihasilkan** | | --- | --- | | **Perintah sederhana:**
Makhluk lucu dengan bulu seperti macan tutul salju sedang berjalan di hutan musim dingin, render gaya kartun 3D. | ![Macan tutul salju lesu.](https://storage.googleapis.com/generativeai-downloads/images/snowleopard.gif) | | **Perintah mendetail:**
Buat adegan animasi 3D pendek dengan gaya kartun yang ceria. Makhluk imut dengan bulu seperti macan tutul salju, mata besar yang ekspresif, dan bentuk bulat yang ramah, dengan riang melompat-lompat di hutan musim dingin yang unik. Adegan harus menampilkan pohon-pohon bulat yang tertutup salju, kepingan salju yang jatuh dengan lembut, dan sinar matahari hangat yang menembus dahan-dahan. Gerakan makhluk yang melompat-lompat dan senyum lebar harus menyampaikan kegembiraan murni. Gunakan gaya bahasa yang ceria dan menyentuh hati dengan warna-warna cerah dan ceria serta animasi yang menyenangkan. | ![Macan tutul salju berjalan lebih cepat.](https://storage.googleapis.com/generativeai-downloads/images/snow-run.gif) | ### Contoh menurut elemen penulisan Contoh ini menunjukkan cara menyaring perintah Anda berdasarkan setiap elemen dasar. #### Subjek dan konteks Tentukan fokus utama (subjek) dan latar belakang atau lingkungan (konteks). | **Perintah** | **Output yang dihasilkan** | | --- | --- | | Rendering arsitektur bangunan apartemen beton putih dengan bentuk organik yang mengalir, yang berpadu mulus dengan tanaman hijau yang rimbun dan elemen futuristik | ![Placeholder.](https://storage.googleapis.com/generativeai-downloads/images/architecture.gif) | | Satelit mengambang di luar angkasa dengan bulan dan beberapa bintang di latar belakang. | ![Satelit mengapung di atmosfer.](https://storage.googleapis.com/generativeai-downloads/images/satellite.gif) | #### Tindakan Tentukan apa yang dilakukan subjek (misalnya, berjalan, berlari, atau menoleh). | **Perintah** | **Output yang dihasilkan** | | --- | --- | | Bidikan lebar seorang wanita yang berjalan di sepanjang pantai, tampak puas dan santai saat melihat cakrawala saat matahari terbenam. | ![Matahari terbenam sangat indah.](https://storage.googleapis.com/generativeai-downloads/images/sunset.gif) | #### Gaya Tambahkan kata kunci untuk mengarahkan pembuatan ke estetika tertentu (misalnya, surealis, antik, futuristik, film noir). | **Perintah** | **Output yang dihasilkan** | | --- | --- | | Gaya film noir, pria dan wanita berjalan di jalan, misteri, sinematik, hitam putih. | ![Gaya film noir sangat indah.](https://storage.googleapis.com/generativeai-downloads/images/noir.gif) | #### Gerakan dan komposisi kamera Tentukan cara kamera bergerak (bidikan POV, tampilan udara, tampilan drone pelacak) dan cara pengambilan gambar dibingkai (bidikan lebar, close-up, sudut rendah). | **Perintah** | **Output yang dihasilkan** | | --- | --- | | Bidikan POV dari mobil vintage yang melaju di tengah hujan, Kanada pada malam hari, sinematik. | ![Matahari terbenam sangat indah.](https://storage.googleapis.com/generativeai-downloads/images/car-pov.gif) | | Close-up ekstrem mata dengan pantulan kota di dalamnya. | ![Matahari terbenam sangat indah.](https://storage.googleapis.com/generativeai-downloads/images/eye.gif) | #### Suasana Palet warna dan pencahayaan memengaruhi suasana hati. Coba istilah seperti "oranye redup nuansa hangat", "cahaya alami", "matahari terbit", atau "nuansa biru dingin". | **Perintah** | **Output yang dihasilkan** | | --- | --- | | Tampilan dekat seorang gadis yang memegang anak golden retriever yang menggemaskan di taman, sinar matahari. | ![Anak di lengan seorang gadis kecil.](https://ai.google.dev/static/gemini-api/docs/video/images/ambiance_puppy.gif?hl=id) | | Bidikan close-up sinematik seorang wanita sedih yang sedang menaiki bus saat hujan, dengan nuansa biru dingin dan suasana sedih. | ![Seorang perempuan yang sedang naik bus tampak sedih.](https://ai.google.dev/static/gemini-api/docs/video/images/ambiance_sad.gif?hl=id) | ### Perintah negatif Perintah negatif menentukan elemen yang _tidak_ Anda inginkan dalam video. * ❌ Jangan gunakan bahasa instruktif seperti _tidak_ atau _jangan_. (mis., "Tanpa dinding"). * ✅ Jelaskan hal yang tidak ingin Anda lihat. (mis., "dinding, bingkai"). | **Perintah** | **Output yang dihasilkan** | | --- | --- | | **Tanpa Perintah Negatif:**
Buat animasi pendek bergaya dari pohon oak besar yang berdiri sendiri dengan daun-daun yang tertiup angin kencang... \[truncated\] | ![Struktur dengan menggunakan kata-kata.](https://ai.google.dev/static/gemini-api/docs/video/images/tree_with_no_negative.gif?hl=id) | | **Dengan Perintah Negatif:**
\[Perintah yang sama\]

Perintah negatif: latar belakang perkotaan, struktur buatan manusia, suasana gelap, badai, atau mengancam. | ![Struktur tanpa kata negatif.](https://ai.google.dev/static/gemini-api/docs/video/images/tree_with_negative.gif?hl=id) | ### Rasio aspek Veo memungkinkan Anda menentukan rasio aspek untuk video Anda. | **Perintah** | **Output yang dihasilkan** | | --- | --- | | **Layar lebar (16:9)**
Buat video dengan tampilan drone pelacak seorang pria yang mengendarai mobil convertible merah di Palm Springs, tahun 1970-an, sinar matahari hangat, bayangan panjang. | ![Seorang pria mengendarai mobil convertible merah di Palm Springs, dengan gaya tahun 1970-an.](https://ai.google.dev/static/gemini-api/docs/video/images/widescreen_palm_springs.gif?hl=id) | | **Potret (9:16)**
Buat video yang menyoroti gerakan lancar air terjun Hawaii yang megah di dalam hutan hujan yang rimbun. Berfokus pada aliran air yang realistis, dedaunan yang detail, dan pencahayaan alami untuk menyampaikan ketenangan. Abadikan air yang mengalir deras, suasana berkabut, dan sinar matahari yang menembus kanopi hutan yang lebat. Gunakan gerakan kamera yang halus dan sinematik untuk menampilkan air terjun dan sekitarnya. Gunakan nada yang tenang dan realistis, sehingga penonton dapat merasakan keindahan hutan hujan Hawaii yang tenang. | ![Air terjun Hawaii yang megah di hutan hujan yang rimbun.](https://ai.google.dev/static/gemini-api/docs/video/images/waterfall.gif?hl=id) | Batasan ------- * **Latensi permintaan:** Min: 11 detik; Maks: 6 menit (selama jam sibuk). * **Batasan regional:** Di lokasi Uni Eropa, Inggris Raya, Swiss, MENA, berikut adalah nilai yang diizinkan untuk `personGeneration`: * Veo 3: `allow_adult` saja. * Veo 2: `dont_allow` dan `allow_adult`. Jumlah defaultnya adalah `dont_allow` * **Retensi video:** Video yang dibuat disimpan di server selama 2 hari, setelah itu video akan dihapus. Untuk menyimpan salinan lokal, Anda harus mendownload video dalam waktu 2 hari setelah dibuat. Video yang diperpanjang durasinya diperlakukan sebagai video yang baru dibuat. * **Pemberian watermark:** Video yang dibuat oleh Veo diberi watermark menggunakan [SynthID](https://deepmind.google/technologies/synthid/?hl=id) , alat kami untuk memberi watermark dan mengidentifikasi konten buatan AI. Video dapat diverifikasi menggunakan platform verifikasi [SynthID](https://deepmind.google/science/synthid/?hl=id) . * **Keamanan:** Video yang dibuat akan melewati filter keamanan dan proses pemeriksaan memori yang membantu mengurangi risiko privasi, hak cipta, dan bias. * **Error audio:** Terkadang Veo 3.1 akan mencegah pembuatan video karena filter keamanan atau masalah pemrosesan lainnya dengan audio. Anda tidak akan dikenai biaya jika video Anda diblokir agar tidak dibuat. Fitur model ----------- | Fitur | Deskripsi | Veo 3.1 & Veo 3.1 Fast | Veo 3 & Veo 3 Fast | Veo 2 | | --- | --- | --- | --- | --- | | **Audio** | Membuat audio dengan video secara native. | Membuat audio dengan video secara native. | ✔️ Selalu aktif | ❌ Hanya senyap | | **Modalitas Input** | Jenis input yang digunakan untuk pembuatan. | Teks ke Video, Gambar ke Video, Video ke Video | Teks ke Video, Gambar ke Video | Teks ke Video, Gambar ke Video | | **Resolusi** | Resolusi output video. | 720p & 1080p (khusus durasi 8 detik)

Khusus 720p saat menggunakan ekstensi video. | 720p & 1080p (khusus 16:9) | 720p | | **Frekuensi Gambar** | Frekuensi gambar output video. | 24 fps | 24 fps | 24 fps | | **Durasi Video** | Durasi video yang dihasilkan. | 8 detik, 6 detik, 4 detik
8 detik hanya saat menggunakan gambar referensi | 8 detik | 5-8 detik | | **Video per Permintaan** | Jumlah video yang dibuat per permintaan. | 1 | 1 | 1 atau 2 | | **Status & Detail** | Ketersediaan model dan detail selengkapnya. | [Pratinjau](https://ai.google.dev/gemini-api/docs/models?hl=id#preview) | [Stabil](https://ai.google.dev/gemini-api/docs/models?hl=id#veo-3) | [Stabil](https://ai.google.dev/gemini-api/docs/models?hl=id#latest-stable) | Versi model ----------- Lihat halaman [Harga](https://ai.google.dev/gemini-api/docs/pricing?hl=id#veo-3.1) dan [Batas kecepatan](https://ai.google.dev/gemini-api/docs/rate-limits?hl=id) untuk mengetahui detail penggunaan khusus model Veo selengkapnya. Versi Veo Fast memungkinkan developer membuat video dengan suara sekaligus mempertahankan kualitas tinggi dan mengoptimalkan kecepatan serta kasus penggunaan bisnis. API ini ideal untuk layanan backend yang membuat iklan secara terprogram, alat untuk pengujian A/B cepat konsep materi iklan, atau aplikasi yang perlu membuat konten media sosial dengan cepat. ### Pratinjau Veo 3.1 | Properti | Deskripsi | | --- | --- | | Kode model id\_card | **Gemini API**

`veo-3.1-generate-preview` | | saveJenis data yang didukung | **Input**

Teks, Gambar

**Output**

Video dengan audio | | Batas token\_auto | **Input teks**

1.024 token

**Video output**

1 | | calendar\_monthPembaruan terbaru | September 2025 | ### Pratinjau Veo 3.1 Fast | Properti | Deskripsi | | --- | --- | | Kode model id\_card | **Gemini API**

`veo-3.1-fast-generate-preview` | | saveJenis data yang didukung | **Input**

Teks, Gambar

**Output**

Video dengan audio | | Batas token\_auto | **Input teks**

1.024 token

**Video output**

1 | | calendar\_monthPembaruan terbaru | September 2025 | ### Veo 3 | Properti | Deskripsi | | --- | --- | | Kode model id\_card | **Gemini API**

`veo-3.0-generate-001` | | saveJenis data yang didukung | **Input**

Teks, Gambar

**Output**

Video dengan audio | | Batas token\_auto | **Input teks**

1.024 token

**Video output**

1 | | calendar\_monthPembaruan terbaru | Juli 2025 | ### Veo 3 Fast | Properti | Deskripsi | | --- | --- | | Kode model id\_card | **Gemini API**

`veo-3.0-fast-generate-001` | | saveJenis data yang didukung | **Input**

Teks, Gambar

**Output**

Video dengan audio | | Batas token\_auto | **Input teks**

1.024 token

**Video output**

1 | | calendar\_monthPembaruan terbaru | Juli 2025 | ### Veo 2 | Properti | Deskripsi | | --- | --- | | Kode model id\_card | **Gemini API**

`veo-2.0-generate-001` | | saveJenis data yang didukung | **Input**

Teks, gambar

**Output**

Video | | Batas token\_auto | **Input teks**

T/A

**Input gambar**

Resolusi dan rasio aspek gambar apa pun hingga ukuran file 20 MB

**Video output**

Maksimal 2 | | calendar\_monthPembaruan terbaru | April 2025 | Langkah berikutnya ------------------ * Mulai menggunakan Veo 3.1 API dengan bereksperimen di [Veo Quickstart Colab](https://colab.research.google.com/github/google-gemini/cookbook/blob/main/quickstarts/Get_started_Veo.ipynb?hl=id) dan [applet Veo 3.1](https://aistudio.google.com/apps/bundled/veo_studio?hl=id) . * Pelajari cara menulis perintah yang lebih baik lagi dengan [Pengantar desain perintah](https://ai.google.dev/gemini-api/docs/prompting-intro?hl=id) kami. Kirim masukan Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan [Lisensi Creative Commons Attribution 4.0](https://creativecommons.org/licenses/by/4.0/) , sedangkan contoh kode dilisensikan berdasarkan [Lisensi Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0) . Untuk mengetahui informasi selengkapnya, lihat [Kebijakan Situs Google Developers](https://developers.google.com/site-policies?hl=id) . Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya. Terakhir diperbarui pada 2026-01-12 UTC. ---