Source: https://ailoot.ai/models/th/google-gemini-2-5-flash-image/ Canonical: https://ailoot.ai/models/th/google-gemini-2-5-flash-image/ Language: th # Google: Nano Banana (Gemini 2.5 Flash Image) [Markdown](https://ailoot.ai/models/th/google-gemini-2-5-flash-image/index.md) · [JSON](https://ailoot.ai/models/th/google-gemini-2-5-flash-image/facts.json) ## [Google: Nano Banana (Gemini 2.5 Flash Image)](https://ailoot.ai/models/th/google-gemini-2-5-flash-image/) Nano Banana (Gemini 2.5 Flash Image) สร้างและแก้ภาพจากข้อความและภาพ ใช้เวิร์กโฟลว์บทสนทนาจัดฉาก เปลี่ยนองค์ประกอบที่เลือก รวมภาพอ้างอิง หรือปรับภาพสินค้า โดยระบุรายละเอียดที่ควรคงไว้ - [**Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-2.5-flash-image`](https://ailoot.ai/models/th/google-gemini-2-5-flash-image/#method-0) - [**Ailoot Ultra · รูปภาพ** `POST /v1/images/generations` `google/gemini-2.5-flash-image`](https://ailoot.ai/models/th/google-gemini-2-5-flash-image/#method-1) - [**Ailoot Ultra · Anthropic Messages** `POST /v1/messages` `google/gemini-2.5-flash-image`](https://ailoot.ai/models/th/google-gemini-2-5-flash-image/#method-2) เกี่ยวกับโมเดล คำอธิบายนี้ครอบคลุมความสามารถของโมเดล อินพุต เอาต์พุต และตัวเลือกที่ใช้ได้ใน Ailoot แสดงด้านล่างตามเมธอดที่เลือก Gemini 2.5 Flash Image หรือ Nano Banana เป็นโมเดลข้อความและภาพของ Google สำหรับสร้างภาพและแก้ภาพผ่านบทสนทนา รับคำสั่งพร้อมภาพอ้างอิงที่เลือกใส่ได้ และคืนภาพพร้อมข้อความประกอบ รุ่น 2.5 Flash Image ตรงตัวนี้แยกจาก Nano Banana 2, Nano Banana Pro และโมเดลภาพ Lite ภายหลัง ผลที่มีประโยชน์คือชิ้นงานภาพที่สร้างหรือแก้ ไม่ใช่คำตอบจากโมเดลข้อความ Gemini 2.5 ทั่วไป ข้อมูลรุ่นตรงตัวระบุอินพุต 65,536 และเอาต์พุต 32,768 โทเคน ภาพและคำสั่งเป็นส่วนอินพุต ภาพหรือข้อความที่คืนเป็นส่วนผล ตารางความละเอียดคู่มือระบุเอาต์พุต 1:1 ที่ 1024×1024, 3:4 ที่ 864×1184 และ 16:9 ที่ 1344×768 ในอัตราส่วนที่รองรับ เลือกรูปทรงแสดงที่ต้องการก่อนออกแบบฉาก ไม่ควรถือว่าตัวเลือกความละเอียดสูงของรุ่นภาพ Gemini ภายหลังเป็นตัวควบคุมที่ระบุสำหรับโมเดลนี้ สำหรับสร้างจากข้อความเป็นภาพ ระบุตัวแบบ การกระทำ สภาพแวดล้อม สไตล์ แสง และมุมมอง ภาพประกอบสินค้าอาจใช้เอกลักษณ์ภาพที่ให้และขอรายละเอียดวัสดุที่เห็นชัดในฉากเหมาะ อธิบายจุดประสงค์ภาพเพื่อให้โมเดลจัดพื้นที่ตัวแบบและข้อความ คำบรรยายเชิงภาพถ่าย เช่น มุมใกล้ องค์ประกอบจากด้านบน หรือมุมต่ำ ช่วยกำหนดกรอบชัดกว่ารายการคำสไตล์ไม่เกี่ยวกัน สำหรับแก้ ให้ภาพเดิมและระบุส่วนเปลี่ยน คู่มือผู้พัฒนาอธิบายเพิ่มหรือลบองค์ประกอบ semantic masking ถ่ายโอนสไตล์ และจัดองค์ประกอบด้วยภาพอ้างอิง คำขอมีประโยชน์ระบุทั้งการแก้และเงื่อนไขคงไว้ เช่น เปลี่ยนพื้นหลังแต่คงรูปทรง พื้นผิว และฉลากสินค้า ติดป้ายบทบาทแต่ละอินพุตเมื่อรวมอ้างอิง เช่น รูปลักษณ์ตัวแบบ ฉาก หรือสไตล์ คู่มือระบุว่ารุ่นนี้ทำงานดีที่สุดกับภาพอินพุตสูงสุดสามภาพ เป็นแนวทางใช้จริง ไม่ใช่เหตุให้รวมภาพอ้างอิงขัดกันไม่จำกัด การปรับผ่านบทสนทนารักษาตัวแบบเดียวขณะเปลี่ยนการตัดสินใจภาพเฉพาะได้ ขอการแก้ที่เชื่อมกันทีละอย่างและเก็บภาพต้นทางกับผลที่ยอมรับสำหรับเทิร์นนั้น อธิบายสิ่งที่ควรสอดคล้องและสิ่งที่ต่างได้ สำหรับชุดชิ้นงาน ระบุตัวแบบ สี และกฎภาพร่วมชัด แทนสมมติว่าพรอมป์ต์ใหม่แยกจะกู้กลับได้ เทียบภาพแก้กับอ้างอิงก่อนถือว่าทำตามคำสั่งรักษาสำเร็จ สำหรับข้อความในภาพ ให้ถ้อยคำตรงลงตัวก่อนแล้วขอภาพมีข้อความนั้นตามคู่มือ ระบุภาษา ลำดับอ่าน ตำแหน่ง และน้ำหนักสัมพันธ์ของป้าย คำขออินโฟกราฟิกควรระบุความสัมพันธ์ที่แต่ละป้ายอธิบายกับองค์ประกอบภาพรองรับ ตรวจสะกด วรรคตอน และความเชื่อมโยงภาพ ณ ขนาดแสดงจริง ป้ายที่สร้างดูอ่านได้ยังเปลี่ยนชื่อ ตัวเลข หรือความหมายที่ต้องการได้ ข้อมูลรุ่นไม่ได้ระบุ thinking อิงผลค้นหา เรียกฟังก์ชัน รันโค้ด หรือเอาต์พุตมีโครงสร้างแบบบังคับสำหรับรุ่นนี้ และไม่ได้ประกาศสร้างเสียงหรือ Live API อินพุตที่ระบุคือข้อความและภาพ จึงไม่ควรนำคุณสมบัติเสียง วิดีโอ และประมวลผลเอกสารของ Gemini อื่นมาใส่โปรไฟล์นี้ แอปควรจัดการส่วนเนื้อหาที่คืนอย่างชัด แทนสมมติว่าคำตอบร้อยแก้วทั่วไปมีชิ้นงานภาพเสร็จแล้ว คู่มือระบุว่าจำนวนภาพที่ขออาจไม่ถูกทำตามเสมอ และภาพที่สร้างมีเครื่องหมาย SynthID ตรวจทุกภาพที่คืนเรื่ององค์ประกอบ ความตรงตัวแบบ จำนวนวัตถุ และถ้อยคำตรง หากฉากมีหลายส่วน ให้บรรยายการจัดวางที่ตั้งใจตามลำดับชัดและแสดงรูปลักษณ์ที่ต้องการเชิงบวก เก็บเอกลักษณ์โมเดลตรง พรอมป์ต์ และภาพอ้างอิงกับผล ทำให้งานสร้างหรือแก้ภาพตรวจได้และมีจุดเริ่มชัดสำหรับการแก้ภายหลัง งานตัวอย่างจริง ### งานตัวอย่างจริง ตัวอย่างทางเทคนิคภาษาอังกฤษ ``` Change a product photo background Using the supplied product photograph, preserve the ceramic mug's shape, handle, glaze and existing logo exactly. Replace only the background with a pale stone tabletop and soft morning side light. Keep the camera angle and mug position. Remove unrelated background clutter and add no new lettering, props or decorative marks. ``` #### ผลลัพธ์ที่คาดหวัง ``` An edited image retaining the reference mug while changing its setting and light as requested. ``` #### ตรวจสอบผลลัพธ์ ``` Compare the result with the reference for mug geometry, logo fidelity, camera angle and removal of clutter. ``` **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-2.5-flash-image` [`google/gemini-2.5-flash-image`](https://ailoot.ai/models/th/#m=google%2Fgemini-2.5-flash-image&route=Ultra&caller=google%2Fgemini-2.5-flash-image&fmt=chat) Google /`google/gemini-2.5-flash-image` ### เริ่มต้น Nano Banana (Gemini 2.5 Flash Image) สร้างและแก้ภาพจากข้อความและภาพ ใช้เวิร์กโฟลว์บทสนทนาจัดฉาก เปลี่ยนองค์ประกอบที่เลือก รวมภาพอ้างอิง หรือปรับภาพสินค้า โดยระบุรายละเอียดที่ควรคงไว้ อินพุตที่รองรับ ข้อความ ผลลัพธ์ ข้อความ ### ใช้งานได้ใน Ailoot · อินพุตและเมธอด **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` ขาเข้า `text` ขาออก `text` รูปแบบเอาต์พุต json หรือ SSE | ฟิลด์ | ประเภท | ข้อกำหนด | ค่าและข้อจำกัด | ค่าเริ่มต้น | | --- | --- | --- | --- | --- | | ฟิลด์`model` | ประเภท`string` | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด google/gemini-2.5-flash-image | ค่าเริ่มต้น— | | ฟิลด์`messages` | ประเภท`message[]` | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด จำนวนรายการขั้นต่ำ: 1 | ค่าเริ่มต้น— | | ฟิลด์`messages[].role` | ประเภท`string` | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด ตัวอย่าง: system, user, assistant, tool, function เงื่อนไข: บทบาทเหล่านี้แทนอย่างชัดเจนด้วยชนิดข้อมูลเพื่อความเข้ากันได้ในซอร์สโค้ด แต่ชุดบทบาทที่แน่นอนยังขึ้นกับแต่ละโมเดล ขึ้นอยู่กับโมเดล | ค่าเริ่มต้น— | | ฟิลด์`messages[].content` | ประเภท`string\|content_part[]\|null` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด | ค่าเริ่มต้น— | | ฟิลด์`messages[].tool_calls` | ประเภท`tool_call[]` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด | ค่าเริ่มต้น— | | ฟิลด์`messages[].tool_call_id` | ประเภท`string` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด ใช้เมื่อ: role=tool โดยใช้ ID ที่ส่งกลับจริง | ค่าเริ่มต้น— | | ฟิลด์`messages[].name` | ประเภท`string` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด | ค่าเริ่มต้น— | | ฟิลด์`messages[].reasoning_content` | ประเภท`string` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด ใช้เมื่อ: ส่งเนื้อหาการใช้เหตุผลที่คืนจริงกลับในคำขอถัดไป เมื่อโมเดลนี้ใช้เนื้อหานั้น | ค่าเริ่มต้น— | | ฟิลด์`messages[].reasoning_details` | ประเภท`object\|array` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด ขึ้นอยู่กับโมเดล | ค่าเริ่มต้น— | | ฟิลด์`max_tokens` | ประเภท`integer` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด ขั้นต่ำ: 1 ขึ้นอยู่กับโมเดล | ค่าเริ่มต้น— | | ฟิลด์`max_completion_tokens` | ประเภท`integer` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด ขั้นต่ำ: 1 ขึ้นอยู่กับโมเดล | ค่าเริ่มต้น— | | ฟิลด์`stream` | ประเภท`boolean` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด | ค่าเริ่มต้นfalse | | ฟิลด์`stream_options.include_usage` | ประเภท`boolean` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด ขึ้นอยู่กับโมเดล | ค่าเริ่มต้น— | | ฟิลด์`temperature` | ประเภท`number` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด ขึ้นอยู่กับโมเดล | ค่าเริ่มต้น— | | ฟิลด์`top_p` | ประเภท`number` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด ขึ้นอยู่กับโมเดล | ค่าเริ่มต้น— | | ฟิลด์`stop` | ประเภท`string\|string[]` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด ขึ้นอยู่กับโมเดล | ค่าเริ่มต้น— | | ฟิลด์`tools` | ประเภท`function_tool[]` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด ขึ้นอยู่กับโมเดล | ค่าเริ่มต้น— | | ฟิลด์`tools[].type` | ประเภท`string` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด function ขึ้นอยู่กับโมเดล | ค่าเริ่มต้น— | | ฟิลด์`tools[].function.name` | ประเภท`string` | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด ใช้เมื่อ: มีเครื่องมือฟังก์ชันให้ใช้ | ค่าเริ่มต้น— | | ฟิลด์`tools[].function.description` | ประเภท`string` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด | ค่าเริ่มต้น— | | ฟิลด์`tools[].function.parameters` | ประเภท`JSON_schema` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด | ค่าเริ่มต้น— | | ฟิลด์`tool_choice` | ประเภท`string\|object` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด ขึ้นอยู่กับโมเดล | ค่าเริ่มต้น— | | ฟิลด์`parallel_tool_calls` | ประเภท`boolean` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด ขึ้นอยู่กับโมเดล | ค่าเริ่มต้น— | | ฟิลด์`response_format` | ประเภท`object` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด ขึ้นอยู่กับโมเดล | ค่าเริ่มต้น— | | ฟิลด์`reasoning_effort` | ประเภท`string` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด ขึ้นอยู่กับโมเดล | ค่าเริ่มต้น— | | ฟิลด์`reasoning` | ประเภท`object` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด ขึ้นอยู่กับโมเดล | ค่าเริ่มต้น— | | ฟิลด์`service_tier` | ประเภท`string` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด ขึ้นอยู่กับโมเดล | ค่าเริ่มต้น— | | ฟิลด์`instructions` | ประเภท`string` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด ฟิลด์เพื่อความเข้ากันได้ | ค่าเริ่มต้น— | | ฟิลด์`functions` | ประเภท`function[]` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด ขึ้นอยู่กับโมเดล | ค่าเริ่มต้น— | | ฟิลด์`function_call` | ประเภท`string\|object` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด ขึ้นอยู่กับโมเดล | ค่าเริ่มต้น— | | ฟิลด์`prompt_cache_options` | ประเภท`object` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด ขึ้นอยู่กับโมเดล | ค่าเริ่มต้น— | | ฟิลด์`modalities` | ประเภท`string[]` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด text | ค่าเริ่มต้น— | | ฟิลด์`provider` | ประเภท`object` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด เงื่อนไข: เส้นทางข้อความ Ultra นี้ปฏิเสธ provider.options | ค่าเริ่มต้น— | | ฟิลด์`cache_control.ttl` | ประเภท`string` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด เงื่อนไข: ตำแหน่งแคชพรอมป์ต์จริงปฏิเสธ 1h | ค่าเริ่มต้น— | ชุดผสมของสื่ออินพุต **ข้อความ** · ข้อความ UTF8 `messages[].content` พารามิเตอร์และวงจรการทำงานของเมธอด | พารามิเตอร์ | ข้อกำหนด | | --- | --- | | พารามิเตอร์`content_type` | ข้อกำหนดapplication/json | | พารามิเตอร์`required` | ข้อกำหนดmodel, messages | | พารามิเตอร์`material_types` | ข้อกำหนดtext | | พารามิเตอร์`messages` | ข้อกำหนดอาร์เรย์ข้อความที่มีโครงสร้าง role/content | | พารามิเตอร์`file_material` | ข้อกำหนดแทรกเอกสาร UTF-8 จริงเป็นข้อความตามต้นฉบับ โดยไม่อนุมาน ID ไฟล์ | | พารามิเตอร์`optional_controls` | ข้อกำหนดstream, temperature, top\_p, stop, max\_tokens, max\_completion\_tokens, reasoning, response\_format, tools, tool\_choice | | พารามิเตอร์`control_scope` | ข้อกำหนดขึ้นกับโมเดล เครื่องมือฟังก์ชันของผู้ใช้ต่างจากเครื่องมือที่โฮสต์จัดให้ | | พารามิเตอร์`output_modalities` | ข้อกำหนดtext | | พารามิเตอร์`hosted_operations` | ข้อกำหนดfalse | | พารามิเตอร์`multimodal_input_binding` | ข้อกำหนดnull | วงจรการทำงาน: `synchronous_or_streamed` ส่ง ID โมเดลที่ตรงทุกตัวพร้อม messages ความยาวบริบทไม่ใช่เพดานผลลัพธ์ ไฟล์ข้อความให้ข้อความตามต้นฉบับได้ ส่วนข้อมูลเข้าภาพ/เสียง/ออบเจ็กต์ไฟล์ต้องมีการผูกที่ตรงตามจริง ### ราคา ข้อมูลอัตราราคาไม่ได้เพิ่มตัวเลือกคำขอ พารามิเตอร์ที่รองรับระบุไว้สำหรับเมธอดที่เลือก โหมดรวดเร็ว อัตรามาตรฐาน เมื่อเลือกโหมดรวดเร็ว โหมดยืดหยุ่น อัตรามาตรฐาน เมื่อเลือกโหมด flex ระดับการใช้เหตุผลสูงสุด อัตรามาตรฐาน เมื่อใช้การปรับตามค่าเริ่มต้น (default) สำหรับระดับการใช้เหตุผลสูงสุด การคิดราคาแคชแบบระบุชัด ไม่ได้เปิดใช้ เมื่อร้องขอแคชแบบระบุชัด #### อัตราค่าบริการ Ailoot #### ราคาตามการตั้งค่า เทียบค่าบริการแต่ละรายการกับเงื่อนไขที่แสดง เลือกใช้อัตราเดียวสำหรับแต่ละชุดการตั้งค่าที่เป็นตัวเลือกทดแทนกัน | การตั้งค่า | ตารางอัตราค่าบริการ | โทเค็นบริบท มากกว่า | โทเค็นบริบท ไม่เกินและรวมค่า | ค่าบริการ | | --- | --- | --- | --- | --- | | การตั้งค่าอัตราราคาพื้นฐานของโทเคน | ตารางอัตราค่าบริการอัตราพื้นฐาน | โทเค็นบริบท มากกว่า— | โทเค็นบริบท ไม่เกินและรวมค่าไม่มีขีดจำกัดสูงสุด | ค่าบริการ ขาเข้า · โทเค็นอินพุต **$0.0006** / 1K โทเค็น ขาออก · โทเค็นเอาต์พุต **$0.005** / 1K โทเค็น ขาเข้า · การอ่านแคช **$0.00006** / 1K โทเค็น ขาเข้า · การเขียนแคช **$0.0001666666666666666** / 1K โทเค็น ขาเข้า · การเขียนแคช, 1 ชั่วโมง **—** / 1K โทเค็น ขาออก · โทเคนภาพขาออก **$0.06** / 1K โทเค็นภาพ | | การตั้งค่าระดับความยาวคำขอ 1 | ตารางอัตราค่าบริการ— | โทเค็นบริบท มากกว่า0 | โทเค็นบริบท ไม่เกินและรวมค่าไม่มีขีดจำกัดสูงสุด | ค่าบริการ ขาเข้า · โทเค็นอินพุต **$0.0006** / 1K โทเค็น ขาออก · โทเค็นเอาต์พุต **$0.005** / 1K โทเค็น ขาเข้า · การอ่านแคช **$0.00006** / 1K โทเค็น ขาเข้า · การเขียนแคช **$0.0001666666666666666** / 1K โทเค็น ขาเข้า · การเขียนแคช, 1 ชั่วโมง **—** / 1K โทเค็น | #### รายละเอียดอัตราอ้างอิง ตารางอัตราอ้างอิงระดับโมเดลไม่เปลี่ยนเมธอดที่เลือก ยอดประมาณการ หรือค่าบริการ การคิดค่าบริการจริงใช้อัตราของเมธอด Ailoot ที่เลือก google/gemini-2.5-flash-image #### ราคาตามการตั้งค่า | การตั้งค่า | เงื่อนไขคิดค่าบริการ | ค่าบริการ | | --- | --- | --- | | การตั้งค่าgoogle/gemini-2.5-flash-image · การตั้งค่าเริ่มต้น | เงื่อนไขคิดค่าบริการการตั้งค่าเริ่มต้น | ค่าบริการ ขาเข้า · ขาเข้า **US$0.0006** / 1K โทเค็น ขาออก · ขาออก **US$0.06** / 1K โทเค็น | Google: Nano Banana (Gemini 2.5 Flash Image) #### ราคาตามการตั้งค่า | การตั้งค่า | เงื่อนไขคิดค่าบริการ | ค่าบริการ | | --- | --- | --- | | การตั้งค่าGoogle: Nano Banana (Gemini 2.5 Flash Image) · การตั้งค่าเริ่มต้น | เงื่อนไขคิดค่าบริการการตั้งค่าเริ่มต้น | ค่าบริการ ขาเข้า · โทเค็นอินพุต **US$0.0006** / 1K โทเค็น ขาออก · โทเค็นเอาต์พุต **US$0.005** / 1K โทเค็น ขาเข้า · ภาพขาเข้า **US$0.0006** / 1K โทเค็น ขาออก · ภาพขาออก **US$0.06** / 1K โทเค็น ขาเข้า · เสียงขาเข้า **US$0.002** / 1K โทเค็น ขาเข้า · การอ่านแคชเสียง **US$0.0002** / 1K โทเค็น ขาออก · การค้นหาบนเว็บ **US$0.028** ต่อการค้นหา ขาออก · โทเคนการให้เหตุผล **US$0.005** / 1K โทเค็น ขาเข้า · การอ่านแคช **US$0.00006** / 1K โทเค็น ขาเข้า · การเขียนแคช · 5 นาที **≈US$0.000167** / 1K โทเค็น | Ailoot กันยอดเงินประมาณการไว้ก่อนส่งคำขอ หลังได้ผลลัพธ์ จะคิดค่าบริการสุดท้ายตามการใช้งานที่วัดได้ การคิดค่าบริการแบบสตรีมใช้บันทึกการใช้งานสุดท้าย [วิธีกันยอดเงินและคิดค่าบริการสุดท้าย →](https://ailoot.ai/docs/th/billing/reserve/) ### ตัวอย่างคำขอ #### Ailoot Ultra · OpenAI Chat curlPython SDKสตรีมด้วย Python ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" python3 - <<'PY_REQUEST' import json,os from pathlib import Path p=json.loads('{"model": "google/gemini-2.5-flash-image", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}') Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import json from pathlib import Path r=json.loads(Path("result.json").read_text()) for x in r.get("choices",[]): if x.get("message",{}).get("content"): print(x["message"]["content"]) PY_RESULT ``` ```python from openai import OpenAI import os if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request") client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0) result=client.chat.completions.create(model='google/gemini-2.5-flash-image',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) import base64, json from pathlib import Path def save_result(data, stem="result"): # Keep every field, including usage, IDs, reasoning and tool requests. Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") print(json.dumps(data, ensure_ascii=False, indent=2)) def save_blob(encoded, suffix, label): raw = base64.b64decode(encoded, altchars=b"-_", validate=True) ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix file = Path(stem + "-" + label + "." + ext) file.write_bytes(raw) print("Saved", file) for index, block in enumerate(data.get("content") or []): print("Content", index, json.dumps(block, ensure_ascii=False)) for choice in data.get("choices") or []: print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False)) for index, item in enumerate(data.get("output") or []): print("Output", index, json.dumps(item, ensure_ascii=False)) if item.get("type") == "image_generation_call" and item.get("result"): save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index)) for ci, candidate in enumerate(data.get("candidates") or []): for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []): print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False)) blob = part.get("inlineData") or part.get("inline_data") if blob and blob.get("data"): mime = blob.get("mimeType") or blob.get("mime_type") suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin") save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi)) save_result(result.to_dict(mode="json")) ``` ```python from openai import OpenAI import os from pathlib import Path if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request") client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0) import base64, json from pathlib import Path def save_result(data, stem="result"): # Keep every field, including usage, IDs, reasoning and tool requests. Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") print(json.dumps(data, ensure_ascii=False, indent=2)) def save_blob(encoded, suffix, label): raw = base64.b64decode(encoded, altchars=b"-_", validate=True) ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix file = Path(stem + "-" + label + "." + ext) file.write_bytes(raw) print("Saved", file) for index, block in enumerate(data.get("content") or []): print("Content", index, json.dumps(block, ensure_ascii=False)) for choice in data.get("choices") or []: print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False)) for index, item in enumerate(data.get("output") or []): print("Output", index, json.dumps(item, ensure_ascii=False)) if item.get("type") == "image_generation_call" and item.get("result"): save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index)) for ci, candidate in enumerate(data.get("candidates") or []): for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []): print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False)) blob = part.get("inlineData") or part.get("inline_data") if blob and blob.get("data"): mime = blob.get("mimeType") or blob.get("mime_type") suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin") save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi)) with client.chat.completions.stream(model='google/gemini-2.5-flash-image',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream: with Path("stream-events.jsonl").open("w",encoding="utf-8") as log: for event in stream: payload=event.to_dict(mode="json") log.write(json.dumps(payload,ensure_ascii=False)+"\n"); log.flush() print(json.dumps(payload,ensure_ascii=False)) final=stream.get_final_completion() save_result(final.to_dict(mode="json"),"stream-result") ``` ### รับและบันทึกผลลัพธ์ #### Ailoot Ultra · OpenAI Chat json หรือ SSE ##### เก็บผลลัพธ์ที่เสร็จสมบูรณ์ทั้งหมด เก็บทุกการตอบกลับ ไฟล์ และส่วนเนื้อหาที่ส่งกลับมาอย่างครบถ้วน เก็บทุกตัวเลือกพร้อมเนื้อหา/การเรียกเครื่องมือ/การใช้เหตุผล ใน SSE ให้ประกอบส่วนเพิ่มตามดัชนีตัวเลือก/เครื่องมือ และเก็บเหตุผลสิ้นสุดกับข้อมูลการใช้งานสุดท้าย ##### เมื่อต้องตรวจสอบการตอบกลับต้นฉบับ เก็บ ID และส่วนหัวของคำขอ/คำตอบ ไม่มี URL ทั่วไปสำหรับดึงงานข้อความให้ใช้ ฟิลด์การตอบกลับ | ฟิลด์ | ประเภท | | --- | --- | | ฟิลด์`choices[].index` | ประเภทinteger | | ฟิลด์`choices[].message.content` | ประเภทstring\|null | | ฟิลด์`choices[].message.tool_calls` | ประเภทtool\_call\[\] | | ฟิลด์`choices[].message.reasoning_content` | ประเภทstring | | ฟิลด์`choices[].message.reasoning_details` | ประเภทobject\|array | | ฟิลด์`choices[].finish_reason` | ประเภทstring\|null | | ฟิลด์`usage` | ประเภทobject | ข้อผิดพลาดและขั้นตอนถัดไป | การตอบกลับ | เงื่อนไข | ขั้นตอนถัดไป | | --- | --- | --- | | การตอบกลับ400 · `invalid_request_error` | เงื่อนไขฟิลด์จำเป็น รูปแบบการแทนข้อมูล หรือค่าพารามิเตอร์ไม่ถูกต้อง | ขั้นตอนถัดไปแก้ฟิลด์ที่ระบุก่อนส่งคำขอสร้างครั้งใหม่ | ### ชื่ออื่น #### ชื่ออื่นของโมเดล **Ailoot Ultra** [`google/gemini-2.5-flash-image`](https://ailoot.ai/models/th/#m=google%2Fgemini-2.5-flash-image&route=Ultra&caller=google%2Fgemini-2.5-flash-image&fmt=chat) #### ชื่อพาธเมธอดอื่น `/v1/images` #### ID ที่เกี่ยวข้องสำหรับเรียกใช้โมเดล [`google/gemini-2.5-flash-image`](https://ailoot.ai/models/th/#m=google%2Fgemini-2.5-flash-image&route=Ultra&caller=google%2Fgemini-2.5-flash-image&fmt=chat) **Ailoot Ultra · รูปภาพ** `POST /v1/images/generations` `google/gemini-2.5-flash-image` [`google/gemini-2.5-flash-image`](https://ailoot.ai/models/th/#m=google%2Fgemini-2.5-flash-image&route=Ultra&caller=google%2Fgemini-2.5-flash-image&fmt=images) Google /`google/gemini-2.5-flash-image` ### เริ่มต้น Nano Banana (Gemini 2.5 Flash Image) สร้างและแก้ภาพจากข้อความและภาพ ใช้เวิร์กโฟลว์บทสนทนาจัดฉาก เปลี่ยนองค์ประกอบที่เลือก รวมภาพอ้างอิง หรือปรับภาพสินค้า โดยระบุรายละเอียดที่ควรคงไว้ อินพุตที่รองรับ ข้อความ · รูปภาพ ผลลัพธ์ รูปภาพ ### ใช้งานได้ใน Ailoot · อินพุตและเมธอด **Ailoot Ultra · รูปภาพ** `POST /v1/images/generations` ขาเข้า `text`, `image` ขาออก `image` | ฟิลด์ | ประเภท | ข้อกำหนด | ค่าและข้อจำกัด | ค่าเริ่มต้น | | --- | --- | --- | --- | --- | | ฟิลด์`model` | ประเภท`string` | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด google/gemini-2.5-flash-image | ค่าเริ่มต้น— | | ฟิลด์`prompt` | ประเภท`string` | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด ความยาวขั้นต่ำ: 1 | ค่าเริ่มต้น— | | ฟิลด์`aspect_ratio` | ประเภท`string` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 | ค่าเริ่มต้น— | | ฟิลด์`n` | ประเภท`integer` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด ขั้นต่ำ: 1 สูงสุด: 1 | ค่าเริ่มต้น— | | ฟิลด์`input_references` | ประเภท`array` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด จำนวนรายการขั้นต่ำ: 0 จำนวนรายการสูงสุด: 3 | ค่าเริ่มต้น— | | ฟิลด์`provider` | ประเภท`object` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด | ค่าเริ่มต้น— | พารามิเตอร์และวงจรการทำงานของเมธอด | พารามิเตอร์ | ข้อกำหนด | | --- | --- | | พารามิเตอร์`content_type` | ข้อกำหนดapplication/json | | พารามิเตอร์`required` | ข้อกำหนดmodel, prompt | | พารามิเตอร์`material_types` | ข้อกำหนดtext, image | วงจรการทำงาน: `synchronous_result_then_owned_library` `GET /v1/media/tasks/{task_id}` · ค่า task\_id ที่ส่งกลับมาจริง หรือระเบียนในคลังสื่อ `GET /v1/media/assets/{asset_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### ราคา ##### วิธีคำนวณค่าบริการสุดท้าย อัตราที่แสดงใช้ประมาณการค่าใช้จ่ายก่อนการสร้างผลลัพธ์ ยอดเรียกเก็บสุดท้ายคำนวณจากค่าใช้จ่ายที่บันทึกไว้สำหรับการสร้างผลลัพธ์ครั้งเดิม ระยะเวลาของผลลัพธ์ที่วัดได้และปริมาณที่คาดการณ์ไว้ไม่ใช่ปริมาณสุดท้ายที่ใช้คิดค่าบริการ ข้อมูลอัตราราคาไม่ได้เพิ่มตัวเลือกคำขอ พารามิเตอร์ที่รองรับระบุไว้สำหรับเมธอดที่เลือก โหมดรวดเร็ว ไม่ได้ระบุ เมื่อเลือกโหมดรวดเร็ว โหมดยืดหยุ่น ไม่ได้ระบุ เมื่อเลือกโหมด flex ระดับการใช้เหตุผลสูงสุด ไม่ได้ระบุ เมื่อใช้การปรับตามค่าเริ่มต้น (default) สำหรับระดับการใช้เหตุผลสูงสุด #### อัตราประมาณการเพื่อเปรียบเทียบ #### ราคาตามการตั้งค่า เทียบค่าบริการแต่ละรายการกับเงื่อนไขที่แสดง เลือกใช้อัตราเดียวสำหรับแต่ละชุดการตั้งค่าที่เป็นตัวเลือกทดแทนกัน | การตั้งค่า | ตารางอัตราค่าบริการ | ปริมาณคาดการณ์ | ค่าบริการ | | --- | --- | --- | --- | | การตั้งค่าอัตราค่าบริการโทเคนพื้นฐาน | ตารางอัตราค่าบริการอัตราพื้นฐาน | ปริมาณคาดการณ์— | ค่าบริการ ขาเข้า · โทเค็นอินพุต · ประมาณการเพื่อเปรียบเทียบเท่านั้น **—** / 1K โทเค็น ขาออก · โทเค็นเอาต์พุต · ประมาณการเพื่อเปรียบเทียบเท่านั้น **—** / 1K โทเค็น ขาเข้า · การอ่านแคช · ประมาณการเพื่อเปรียบเทียบเท่านั้น **—** / 1K โทเค็น ขาเข้า · การเขียนแคช · ประมาณการเพื่อเปรียบเทียบเท่านั้น **—** / 1K โทเค็น ขาเข้า · การเขียนแคช, 1 ชั่วโมง · ประมาณการเพื่อเปรียบเทียบเท่านั้น **—** / 1K โทเค็น | | การตั้งค่าต้นทุนการสร้างโดยประมาณ | ตารางอัตราค่าบริการ— | ปริมาณคาดการณ์ค่าประมาณสำหรับการสร้างหนึ่งครั้ง | ค่าบริการ ขาออก · ค่าใช้จ่ายในการสร้างโดยประมาณ · ประมาณการเพื่อเปรียบเทียบเท่านั้น **$0.24576** ประมาณการก่อนสร้าง ค่าประมาณนี้ไม่ใช่ค่าใช้จ่ายเพิ่มเติมหรืออัตราคงที่สำหรับการสร้างผลลัพธ์ที่เสร็จสมบูรณ์แล้ว | Ailoot กันยอดเงินประมาณการไว้ก่อนส่งคำขอ หลังได้ผลลัพธ์ จะคิดค่าบริการสุดท้ายตามการใช้งานที่วัดได้ การคิดค่าบริการแบบสตรีมใช้บันทึกการใช้งานสุดท้าย [วิธีกันยอดเงินและคิดค่าบริการสุดท้าย →](https://ailoot.ai/docs/th/billing/reserve/) ### ตัวอย่างคำขอ #### Ailoot Ultra · รูปภาพ curl ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_REQUEST' import json,os from pathlib import Path p={'model': 'google/gemini-2.5-flash-image', 'prompt': 'a red panda astronaut floating in space, studio lighting'} Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import base64, json, os, subprocess from pathlib import Path from urllib.parse import urlsplit, urljoin def save_images(items): if not items: raise SystemExit("No completed images; retain the full response") for index, item in enumerate(items): encoded=item.get("b64_json") uri=item.get("url", "") if not encoded and uri.startswith("data:image/"): header, separator, encoded=uri.partition(",") if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI") if encoded: raw=base64.b64decode(encoded,validate=True) elif uri: uri=urljoin("https://api.ailoot.ai",uri) parsed=urlsplit(uri) if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password: raise SystemExit("Invalid returned image URL") owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content") args=["curl","--fail-with-body","--silent","--show-error",uri] if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]] temporary=Path(f"image-{index}.bin") subprocess.run(args+["-o",str(temporary)],check=True) raw=temporary.read_bytes() temporary.unlink() else: raise SystemExit("Image has neither bytes nor URL") if not raw: raise SystemExit("Empty image result") ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"