Xác thực và URL cơ sở
Truy cập nano banana api bằng cách trỏ máy khách của bạn vào https://api.nanobananaapis.com/v1. Bạn cần một khóa API hợp lệ trong tiêu đề Authorization. Đăng ký trên trang Lấy khóa API chỉ bằng email và mật khẩu để nhận khóa ngay lập tức. Khóa sẽ hiển thị ngay sau khi đăng ký. Nếu bạn làm mất khóa, hãy tạo lại một khóa mới từ bảng điều khiển; khóa cũ sẽ ngừng hoạt động ngay lập tức.
Sử dụng Bearer YOUR_API_KEY cho mọi yêu cầu. ID mô hình luôn là uncensored. Endpoint này xử lý đầu vào và đầu ra văn bản. Nó không tạo ảnh, âm thanh hoặc video. Đối với các quy trình đa phương tiện, hãy sử dụng API này để viết prompt, tạo kịch bản và xử lý hậu kỳ.
Yêu cầu đầu tiên
Gửi một yêu cầu hoàn thành trò chuyện tiêu chuẩn. API hỗ trợ định dạng OpenAI. Thay thế YOUR_API_KEY bằng khóa thực tế của bạn. Ví dụ này gửi một tin nhắn đơn giản đến mô hình không kiểm duyệt.
curl https://api.nanobananaapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'Phản hồi chứa văn bản đã tạo. Bạn có thể kiểm tra số lượng token sử dụng trong thân phản hồi. Cửa sổ ngữ cảnh là 100.000 token tổng cộng cho prompt và phần hoàn thành. Giữ trọng tải của bạn dưới 8 MB.
Ví dụ SDK Python
Sử dụng SDK Python chính thức của OpenAI. Đặt URL cơ sở thành endpoint nanobananaapis. Truyền khóa API của bạn dưới dạng api_key. Máy khách sẽ tự động định dạng các yêu cầu đúng cách. Phương pháp này lý tưởng cho các kịch bản backend cần xử lý văn bản trước khi gửi đến dịch vụ tạo ảnh hoặc video.
from openai import OpenAI
client = OpenAI(base_url="https://api.nanobananaapis.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)SDK xử lý truyền phát và phân tích cú pháp cho bạn. Bạn có thể lặp qua các chunk nếu bạn bật chế độ truyền phát (streaming). Cách tiếp cận này giữ cho mã của bạn sạch sẽ và tương thích với các dịch vụ OpenAI khác nếu bạn chuyển nhà cung cấp sau này.
Ví dụ SDK Node.js
SDK Node.js hoạt động tương tự. Khởi tạo máy khách với URL cơ sở và khóa của bạn. Gọi phương thức chat.completions.create. Điều này hữu ích cho các hàm không máy chủ hoặc máy chủ web cần tạo kịch bản động.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.nanobananaapis.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);Đảm bảo xử lý lỗi đúng cách. Các lỗi phổ biến bao gồm lỗi xác thực (401) nếu khóa không hợp lệ hoặc hết hạn, và giới hạn tốc độ (429) nếu bạn vượt quá 300 yêu cầu mỗi phút. Khóa API được liên kết với tài khoản của bạn, vì vậy hãy bảo vệ nó trong các biến môi trường của bạn.
Phản hồi truyền phát (streaming)
Bật truyền phát bằng cách đặt stream: true trong yêu cầu của bạn. API trả về luồng Sự kiện gửi bởi máy chủ (SSE). Mỗi chunk chứa một phần của văn bản được tạo. Điều này rất cần thiết cho các ứng dụng thời gian thực hoặc khi tạo các kịch bản dài.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)Phân tích cú pháp các sự kiện SSE ở phía máy khách của bạn. Luồng kết thúc khi mô hình hoàn tất việc tạo hoặc đạt giới hạn ngữ cảnh. Truyền phát giảm độ trễ cảm nhận đối với người dùng. Nó không thay đổi giá; bạn vẫn phải trả tiền mỗi token.
Giới hạn, Lỗi và Mô hình
Kiểm tra các mô hình khả dụng qua GET /v1/models. Mô hình duy nhất là uncensored. Giới hạn tốc độ là 300 yêu cầu mỗi phút trên mỗi khóa. Thân yêu cầu phải dưới 8 MB. Giá là $0.25 cho mỗi 1 triệu token đầu vào và $1.00 cho mỗi 1 triệu token đầu ra. Tín dụng không bao giờ hết hạn. Nếu bạn hết, hãy nạp tiền từ $10. Lỗi: 401 cho khóa không hợp lệ, 402 cho tín dụng không đủ, 429 cho giới hạn tốc độ. Không có SLA hoặc cam kết thời gian hoạt động nào được cung cấp. Mô hình chặn nội dung tình dục liên quan đến trẻ vị thành niên. Nó không từ chối các chủ đề người trưởng thành hoặc gây tranh cãi hợp pháp khác.
