Gemma api key documentation

Xác thực và Base URL

Sử dụng khóa API độc nhất của bạn để xác thực mọi yêu cầu. URL cơ sở là HTTPS://api.gemmaapikey.com/v1 và bạn gửi khóa trong tiêu đề Authorization. Điều này hoạt động với bất kỳ khách hàng tương thích OpenAI nào bằng cách thay đổi base_url và khóa API. Nếu bạn mất nó, hãy tạo 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. Lỗi và từ chối không tiêu thụ tín dụng trả trước của bạn.

Yêu cầu đầu tiên

Gửi yêu cầu POST đến /v1/chat/completions với model id "uncensored". Bao gồm system prompt và tin nhắn người dùng của bạn trong mảng messages. Mô hình phản hồi với văn bản được tạo mà không từ chối nội dung đối với mục đích người trưởng thành hợp pháp.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.gemmaapikey.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)

Đặt temperature và top_p để kiểm soát tính ngẫu nhiên. Sử dụng các chuỗi dừng để dừng quá trình tạo sớm. Phản hồi bao gồm việc sử dụng token trong chunk cuối cùng nếu streaming được bật.

Tích hợp SDK Node

Cài đặt SDK chính thức của OpenAI cho Node.js. Cấu hình nó với khóa API và URL cơ sở từ hướng dẫn này. Gọi phương thức chat.completions.create với prompt của bạn.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.gemmaapikey.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);

Phương pháp này giữ chi phí có thể dự đoán vì bạn chỉ trả tiền cho token đã sử dụng. Tín dụng trả trước được tính phí theo mức sử dụng thực tế. Không áp dụng phí hàng tháng. Bạn có thể nạp tiền bằng tiền điện tử bất cứ lúc nào.

Phản hồi luồng

Bật phát trực tiếp bằng cách đặt stream thành true trong yêu cầu. API trả về các chunk Sự kiện được gửi bởi máy chủ (SSE). Mỗi chunk chứa văn bản từng phần cho đến khi chunk cuối cùng bao gồm thông tin sử dụng token.

Copystream = 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)

Streaming làm giảm độ trễ cảm nhận cho các phản hồi dài. Nó cũng cho phép bạn hiển thị tiến trình cho người dùng theo thời gian thực. Cửa sổ ngữ cảnh hỗ trợ 100.000 token cho prompt và phần hoàn thành cùng nhau.

Giới hạn tốc độ và Ngữ cảnh

Bạn bị giới hạn 300 yêu cầu mỗi phút cho mỗi khóa. Chỉ 8 yêu cầu có thể chạy đồng thời. Thân yêu cầu không được vượt quá 8 MB. Các giới hạn này đảm bảo hiệu suất ổn định cho tất cả người dùng.

Mô hình hỗ trợ gọi hàm, chế độ JSON và các tham số tiêu chuẩn như seed và presence_penalty. Số lượng token đầu ra tối đa là 16,000 token mỗi yêu cầu. Nếu bạn không đặt max_tokens, nó sẽ mặc định là 2,048.

Lỗi và Khắc phục sự cố

Lỗi 401 có nghĩa là khóa API của bạn không hợp lệ hoặc đã hết hạn. Hãy kiểm tra bảng điều khiển để lấy khóa hoạt động của bạn. Lỗi 402 cho biết số dư trả trước không đủ. Nạp tiền qua tiền điện tử để tiếp tục. Lỗi 429 có nghĩa là bạn đã đạt giới hạn tốc độ. Hãy đợi vài giây và thử lại.

Lỗi không tiêu tốn tín dụng của bạn. Nếu xảy ra lỗi tính phí kép, hãy sử dụng trang Hỗ trợ để khắc phục. Tín dụng không bao giờ hết hạn, vì vậy bạn có thể nạp thêm sau.

cURL

Copycurl https://api.gemmaapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return the current system status"}]
  }'