TH ▾

API ข้อความแบบไม่เซ็นเซอร์สำหรับสายการผลิตของคุณ

เชื่อมต่อ API Nanobanana: SillyTavern, LangChain, Cursor

การเชื่อมต่อ API nanobanana ในที่นี้หมายถึงการเชื่อมต่อ endpoint ข้อความที่เข้ากันได้กับ OpenAI เข้ากับเครื่องมือที่คุณใช้อยู่แล้ว ทุกอย่างต้องการค่าสามค่าเดียวกัน: base URL, คีย์ และ model ID

อัปเดต

ภาพประกอบไอโซเมตริกของจุดเชื่อมต่อหนึ่งจุดที่เชื่อมต่อกับแผงแชท ตัวแก้ไขโค้ด และกราฟเวิร์กโฟลว์

จุดสำคัญ

  • ค่าสามค่าคือ base URL https://api.nanobananaapis.com/v1, คีย์ของคุณ และ model ID uncensored.
  • ทดสอบด้วย curl ก่อน แล้วจึงกำหนดค่า SillyTavern, LangChain, Cursor หรือ SDK ของ OpenAI ใดๆ
  • API นี้เป็นข้อความเท่านั้น; ไม่สร้างรูปภาพ, เสียง หรือ embeddings
  • จำกัดจำนวนคำขอพร้อมกันไว้ที่ 8 ต่อคีย์เต็มเพื่อหลีกเลี่ยงข้อผิดพลาด 429 จาก agents และ extensions

ค่าสามค่าที่ทุกการเชื่อมต่อต้องการ

คู่มือเกือบทุกฉบับเกี่ยวกับ การผสานรวม 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 ป้ายเมนูอาจเปลี่ยนไปในแต่ละเวอร์ชัน ดังนั้นให้ใช้ขั้นตอนเหล่านี้เป็นแผนที่มากกว่าคำพูดที่ตรงตัว

  1. เปิดแผงการเชื่อมต่อ API และเลือก Chat Completion เป็นประเภท API
  2. เลือกแหล่งข้อมูล กำหนดเอง (เข้ากันได้กับ OpenAI)
  3. วาง https://api.nanobananaapis.com/v1 เป็น URL เอนด์พอยต์
  4. วางคีย์ของคุณในฟิลด์คีย์
  5. ป้อน uncensored เป็นชื่อโมเดล หรือกดปุ่มเชื่อมต่อแล้วเลือกจากรายการที่ GET /v1/models ส่งกลับ
  6. กด 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 จากนั้นเพิ่มเฟรมเวิร์กเฉพาะเมื่อคุณรู้สึกต้องการ การย้ายในภายหลังทำได้ง่าย เนื่องจากค่าสามค่าไม่เคยเปลี่ยนแปลง สำหรับคำขอแรกและรายการพารามิเตอร์เต็ม โปรดอ่าน เอกสาร

ถาม-ตอบ

ฉันควรใช้ Base URL ใดสำหรับการผสานรวม nanobanana?

ใช้ https://api.nanobananaapis.com/v1 พร้อมคีย์ของคุณเป็นโทเคน Bearer และใช้ uncensored เป็น ID โมเดล

มันใช้งานกับ SillyTavern ได้หรือไม่?

ใช่ SillyTavern ยอมรับเอนด์พอยต์ที่เข้ากันได้กับ OpenAI แบบกำหนดเองภายใต้ Chat Completion ป้อน Base URL คีย์ และ ID โมเดล จากนั้นเชื่อมต่อ

ฉันสามารถใช้มันสำหรับ embeddings หรือการสร้างภาพใน LangChain ได้หรือไม่?

ไม่ได้ API รองรับเฉพาะ chat completions และรายการโมเดลเท่านั้น ใช้ผู้ให้บริการอื่นสำหรับ embeddings หรือภาพ

ทำไมเอเยนต์ของฉันจึงได้รับข้อผิดพลาด 429?

คีย์แบบเต็มอนุญาตให้ทำคำขอพร้อมกัน 8 คำขอและ 300 คำขอต่อนาที จำกัดการเรียกแบบขนาน และลองใหม่หลังจากรอช่วงเวลาสั้นๆ

ข้อมูลของฉันถูกนำไปฝึกโมเดลหรือไม่?

ไม่ พรอมต์ไม่ถูกนำไปใช้ฝึกโมเดล

คุณอยู่ห่างจากการรับคีย์เพียงขั้นตอนเดียว

สร้างบัญชี คัดลอกคีย์ และเปลี่ยน base URL นั่นคือการตั้งค่าทั้งหมด

รับคีย์ API