ค่าสามค่าที่ทุกการเชื่อมต่อต้องการ
คู่มือเกือบทุกฉบับเกี่ยวกับ การผสานรวม API nanobanana สรุปอยู่ที่การกรอกฟิลด์สามฟิลด์เดียวกันในตำแหน่งที่แตกต่างกัน บริการนี้ใช้โปรโตคอล chat-completions ของ OpenAI ดังนั้นเครื่องมือที่อนุญาตให้คุณกำหนดค่าเอนด์พอยต์ของ OpenAI ได้จึงสามารถเชื่อมต่อกับบริการนี้ได้
| ฟิลด์ | ค่า |
|---|---|
| URL พื้นฐาน | https://api.nanobananaapis.com/v1 |
| คีย์ API | คีย์ของคุณ ส่งเป็น Authorization: Bearer <key> |
| ID โมเดล | uncensored |
หมายเหตุขอบเขตเล็กน้อยก่อนเริ่ม นี่คือโมเดลภาษาข้อความ ดังนั้นจะไม่ทำงานในสถานที่ที่คาดหวังการสร้างภาพ, เสียง หรือการฝังตัว วิธีการที่รองรับคือ POST /v1/chat/completions และ GET /v1/models หากเครื่องมือขอโมเดลการฝังตัวสำหรับการค้นหา ให้ชี้ส่วนนั้นไปยังผู้ให้บริการอื่น
รับคีย์จาก หน้า API key บัญชีใหม่สามารถรับเครดิตทดลองใช้ฟรี $0.50 ได้ด้วยการคลิกหนึ่งครั้ง โดยไม่ต้องใช้บัตร และใช้ได้เป็นเวลา 7 วัน
ทดสอบเอนด์พอยต์ก่อนที่จะแตะต้องเครื่องมือใดๆ
เมื่อการเชื่อมต่อล้มเหลว ผู้คนมักโทษเครื่องมือ ส่วนใหญ่แล้วคีย์หรือ URL ผิดพลาด การทดสอบด้วย curl สั้นๆ ยาว 30 วินาทีจะขจัดข้อสงสัยนั้นออก ขั้นแรกให้แสดงรายการโมเดล:
curl https://api.nanobananaapis.com/v1/models -H "Authorization: Bearer YOUR_API_KEY"
จากนั้นส่งคำขอแชทสั้นๆ:
curl https://api.nanobananaapis.com/v1/chat/completions -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}],"max_tokens":10}'
หากทั้งสองอย่างทำงานได้ endpoint และคีย์ถูกต้อง และข้อผิดพลาดใดๆ ที่เกิดขึ้นภายหลังมาจากวิธีการกำหนดค่าเครื่องมือ หากการเรียกครั้งแรกส่งกลับ 401 คีย์อาจผิดหรือขาดคำว่า Bearer ใน header หากเป็น 404 มักหมายถึง URL ขาด /v1 หรือมี path เกินมา
SillyTavern
SillyTavern เป็นส่วนหน้าสำหรับ roleplay และการแชทกับตัวละคร และอนุญาตให้คุณเพิ่มเอนด์พอยต์ที่เข้ากันได้กับ OpenAI ป้ายเมนูอาจเปลี่ยนไปในแต่ละเวอร์ชัน ดังนั้นให้ใช้ขั้นตอนเหล่านี้เป็นแผนที่มากกว่าคำพูดที่ตรงตัว
- เปิดแผงการเชื่อมต่อ API และเลือก Chat Completion เป็นประเภท API
- เลือกแหล่งข้อมูล กำหนดเอง (เข้ากันได้กับ OpenAI)
- วาง
https://api.nanobananaapis.com/v1เป็น URL เอนด์พอยต์ - วางคีย์ของคุณในฟิลด์คีย์
- ป้อน
uncensoredเป็นชื่อโมเดล หรือกดปุ่มเชื่อมต่อแล้วเลือกจากรายการที่GET /v1/modelsส่งกลับ - กด connect และส่งข้อความทดสอบ
หมายเหตุการปรับแต่งสองข้อ SillyTavern ส่งประวัติการสนทนาที่ยาวพร้อม character card ดังนั้นโปรดระวังหน้าต่างบริบท 100,000-token ซึ่งใช้ร่วมกันระหว่างพรอมต์และการตอบกลับ และหากคุณใช้แชทกลุ่มที่ส่งคำขอหลายคำขอพร้อมกัน โปรดจำไว้ว่าขีดจำกัดคือ 8 คำขอพร้อมกันสำหรับคีย์แบบเต็ม (2 คำขอสำหรับคีย์ทดลอง) การตั้งค่าบทบาทสมมติและเพื่อนคู่ใจเหมาะสำหรับผู้ใหญ่ โมเดลจะไม่ผลิตเนื้อหาทางเพศที่เกี่ยวข้องกับผู้เยาว์ภายใต้พรอมต์ใดๆ
LangChain
ใน Python แพ็กเกจ langchain-openai มี ChatOpenAI ซึ่งรองรับการกำหนด Base URL แบบกำหนดเอง ติดตั้งด้วยคำสั่ง pip install langchain-openai
import os
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
base_url="https://api.nanobananaapis.com/v1",
api_key=os.environ["NANOBANANA_KEY"],
model="uncensored",
temperature=0.7,
)
print(llm.invoke("Give me three names for a fictional smuggler ship.").content)
โซ่ เทมเพลตพรอมต์ และตัวแยกวิเคราะห์เอาต์พุตทำงานเหมือนกันหลังจากนั้น เนื่องจากพวกเขาสนใจเฉพาะอินเทอร์เฟซแชท การเรียกใช้ฟังก์ชันจะผ่านเส้นทางมาตรฐาน ดังนั้น llm.bind_tools([...]) จะส่ง tools ในคำขอ ทดสอบการเรียกใช้ฟังก์ชันเดียวก่อนที่คุณจะสร้างเอเจนต์โดยรอบ และจำกัดความพร้อมกันของเอเจนต์ไว้ที่ 8 กราฟที่กระจายออกเป็นยี่สิบสาขาจะชนกับข้อผิดพลาด concurrency
แพ็กเกจ JavaScript @langchain/openai ใช้แนวคิดเดียวกันผ่านตัวเลือก configuration: { baseURL } บน ChatOpenAI
Cursor และโปรแกรมแก้ไขอื่นๆ
Cursor เช่นเดียวกับโปรแกรมแก้ไขโค้ดอื่นๆ อีกหลายตัว มีพื้นที่ตั้งค่าสำหรับโมเดล ซึ่งคุณสามารถระบุคีย์ API ของ OpenAI แบบกำหนดเองและแทนที่ Base URL ได้ โดยคร่าวๆ ให้เปิดการตั้งค่าโมเดล เปิดใช้งานตัวเลือกคีย์ OpenAI แบบกำหนดเอง ตั้งค่า Base URL ใหม่เป็น https://api.nanobananaapis.com/v1 วางคีย์ของคุณ และเพิ่ม uncensored เป็นชื่อโมเดลแบบกำหนดเอง
ประเมินสิ่งที่สิ่งนี้ให้คุณอย่างสมจริง โปรแกรมแก้ไขสร้างฟีเจอร์บางอย่าง เช่น การเติมข้อความแบบ inline ไว้รอบๆ เบ็คเอนด์ของตัวเองและชื่อโมเดลเฉพาะ ดังนั้นเอนด์พอยต์แบบกำหนดเองอาจใช้ได้เฉพาะกับแชทหรือชุดคำสั่งย่อยเท่านั้น ตัวเลือกที่แน่นอนจะเปลี่ยนแปลงไปตามเวอร์ชัน ดังนั้นควรตรวจสอบเอกสารปัจจุบันของโปรแกรมแก้ไข หากฟีเจอร์ใดต้องการสิ่งที่ API นี้ไม่มี เช่น embeddings หรือการป้อนภาพ ฟีเจอร์นั้นจะไม่ทำงานผ่านเอนด์พอยต์นี้
รูปแบบเดียวกันนี้ใช้กับไคลเอนต์ที่เข้ากันได้กับ OpenAI อื่นๆ เช่น Open WebUI, Continue และหน้าเว็บแชทอื่นๆ: ให้หาฟิลด์สำหรับเอนด์พอยต์ OpenAI แบบกำหนดเอง กรอกค่าทั้งสามค่า แล้วทดสอบ
SDK แบบธรรมดาและตัวแปรสภาพแวดล้อม
หากคุณเขียนโค้ดเอง SDK ทางการจะอ่านตัวแปรสภาพแวดล้อมมาตรฐาน ซึ่งช่วยให้คุณเปลี่ยนเอนด์พอยต์ได้โดยไม่ต้องแก้ไขไฟล์ต้นทาง ใน SDK ของ Python และ Node การตั้งค่า OPENAI_BASE_URL และ OPENAI_API_KEY ก็เพียงพอแล้ว
export OPENAI_BASE_URL="https://api.nanobananaapis.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"
python app.py # app.py calls client.chat.completions.create(model="uncensored", ...)
ไคลเอนต์ที่ระบุอย่างชัดเจนใน Node มีลักษณะดังนี้:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.nanobananaapis.com/v1",
apiKey: process.env.NANOBANANA_KEY,
});
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a short product description for a paper lantern." }],
stream: true,
});
for await (const part of stream) {
process.stdout.write(part.choices[0]?.delta?.content ?? "");
}
สตรีมมิงส่งผ่าน SSE พร้อมรายงานการใช้งานที่ส่วนท้าย รายละเอียดพารามิเตอร์เต็มรูปแบบอยู่ที่หน้า เอกสาร และ บทความเกี่ยวกับการสร้างพรอมต์ แสดงวิธีเชื่อมต่อขั้นตอนข้อความไปยังสายการผลิตภาพ
การแก้ไขความล้มเหลวที่พบบ่อย
| อาการ | สาเหตุที่เป็นไปได้ | การแก้ไข |
|---|---|---|
| 401 ไม่ได้รับอนุญาต | คีย์ไม่ถูกต้อง หรือส่วนหัว Bearer หายไป | คัดลอกคีย์อีกครั้งและทดสอบด้วย curl |
| 404 ไม่พบ | Base URL ขาด /v1 หรือมี path ซ้ำ | ใช้ https://api.nanobananaapis.com/v1 ให้ถูกต้อง |
| ไม่พบโมเดล | ค่าเริ่มต้นของฟังก์ชันเป็นชื่อโมเดลของผู้ขาย | ตั้งค่าโมเดลเป็น uncensored |
429 พร้อม rate_limited | เกิน 300 คำขอต่อนาที (60 ครั้งสำหรับแบบทดลอง) | ลดความเร็วลงแล้วลองใหม่ |
429 พร้อม concurrency | มากกว่า 8 คำขอพร้อมกัน (2 คำขอในเครดิตทดลองใช้) | ลดความพร้อมกัน |
| 429 พร้อม Retry-After: 5 | โอเวอร์โหลดชั่วคราว | รอห้าวินาทีแล้วลองใหม่ |
| คำขอมีขนาดใหญ่เกินไป | บอดี้มีขนาดเกิน 8 MB | ตัดทอนส่วนแนบหรือประวัติ |
โปรดทราบว่าคำขอแบบสตรีมจะยึดช่องความพร้อมกันไว้จนกว่าสตรีมจะสิ้นสุด ดังนั้นโปรแกรมแก้ไขที่ละทิ้งสตรีมอาจดูเหมือนกำลังชนขีดจำกัดแม้ว่าจะไม่มีการใช้งานก็ตาม ให้บันทึก header X-Request-Id จากคำขอที่ล้มเหลว ซึ่งเป็นสิ่งแรกฝ่ายสนับสนุนจะถามหา
ด้านค่าใช้จ่าย ข้อความแชททั่วไปที่มี 2,000 โทเคนในและ 500 โทเคนออก มีค่าใช้จ่าย $0.00055 ที่อัตรา $0.15 และ $0.50 ต่อ 1M โทเคน และคำขอที่ล้มเหลวจะไม่ถูกเรียกเก็บเงิน หน้าราคา ครอบคลุมการเติมเงินตั้งแต่ $20 ถึง $500 และระดับโบนัส
คีย์ ความปลอดภัย และใครเห็นอะไร
แต่ละการเชื่อมต่อจะเก็บคีย์ของคุณไว้ที่ใดที่หนึ่ง และบางที่เก็บได้ดีกว่าที่อื่น ในแอปพลิเคชันเดสก์ท็อป คีย์จะอยู่ในไฟล์ตั้งค่าท้องถิ่น ในเครื่องมือที่ทำงานบนเบราว์เซอร์ อาจบันทึกไว้ในเบราว์เซอร์ ในโปรแกรมแก้ไข คีย์จะอยู่ในค่ากำหนดของแอปพลิเคชัน รู้ว่ากำลังใช้สิ่งใดอยู่ก่อนแชร์หน้าจอ commit ไฟล์ dotfile หรือมอบแล็ปท็อปให้ผู้อื่น
กฎไม่กี่ข้อทำให้การจัดการง่ายขึ้น ใช้คีย์เดียวต่อเครื่องมือเมื่อทำได้ เพื่อให้คุณสามารถแทนที่คีย์เดียวโดยไม่ทำลายส่วนอื่น อย่าวางคีย์ลงในตัวติดตามปัญหาสาธารณะเมื่อขอความช่วยเหลือ ให้แชร์ ID คำขอแทน หากคีย์รั่วไหล ให้แทนที่จากหน้าคีย์และอัปเดตเครื่องมือของคุณ พรอมต์ที่ส่งผ่าน API ไม่ถูกใช้ในการฝึก และ หน้าความเป็นส่วนตัว อธิบายการจัดการข้อมูลที่เหลือ
หากคุณโฮสต์หน้าเว็บสำหรับผู้ใช้รายอื่น อย่าส่งคีย์ API ไปยังเบราว์เซอร์ ให้วางเซิร์ฟเวอร์ขนาดเล็กไว้ระหว่างผู้ใช้ของคุณกับ API เพิ่มขีดจำกัดของคุณเองที่นั่น และเก็บคีย์ไว้บนเซิร์ฟเวอร์ จากนั้นผู้ใช้ของคุณจะแชร์คำขอพร้อมกัน 8 คำขอของคุณ ดังนั้นจึงควรวางแผนจำนวนคนที่สามารถแชทได้พร้อมกัน
เครื่องมือใดเหมาะกับงานใด
เนื่องจากการผสานรวมเหมือนกันทุกที่ การเลือกเครื่องมือจึงขึ้นอยู่กับสิ่งที่คุณกำลังสร้าง
- SillyTavern หรือหน้าแชทแบบคล้ายกัน เหมาะสำหรับการแชทตัวละคร นิยาย และบทบาทสมมติสำหรับผู้ใหญ่ ที่ซึ่งคุณต้องการอินเทอร์เฟซที่ประณีตและการ์ดตัวละครโดยไม่ต้องเขียนโค้ด
- LangChain เหมาะกับสายงานในโค้ด: ตัวโหลดข้อมูล เทมเพลตพรอมต์ ตัวแยกวิเคราะห์ และโซ่หลายขั้นตอน มันเพิ่มโครงสร้างโดยแลกกับ dependency เพิ่มเติมหนึ่งตัว
- การเรียกใช้ SDK แบบธรรมดา เหมาะกับสคริปต์และบริการขนาดเล็ก หากงานของคุณคือการส่งพรอมต์หนึ่งครั้งและรับคำตอบหนึ่งครั้ง แพ็กเกจ OpenAI อย่างเดียวจะดูแลรักษาง่ายกว่าเฟรมเวิร์ก
- โปรแกรมแก้ไขเช่น Cursor เหมาะกับการแชทเกี่ยวกับโค้ด ตรวจสอบคุณสมบัติที่ยอมรับเอนด์พอยต์ที่กำหนดเองก่อนที่คุณจะพึ่งพาเครื่องมือนี้
เริ่มด้วยการทดสอบ curl ธรรมดา จากนั้น SDK จากนั้นเพิ่มเฟรมเวิร์กเฉพาะเมื่อคุณรู้สึกต้องการ การย้ายในภายหลังทำได้ง่าย เนื่องจากค่าสามค่าไม่เคยเปลี่ยนแปลง สำหรับคำขอแรกและรายการพารามิเตอร์เต็ม โปรดอ่าน เอกสาร
