Hướng dẫn nhanh API Embeddings

Xác thực

Truy cập API bằng khóa API duy nhất được tạo từ bảng điều khiển tài khoản của bạn. Bao gồm khóa này trong tiêu đề Authorization của mọi yêu cầu bằng lược đồ Bearer. URL gốc cho tất cả các endpoint là https://api.embeddingapis.com/v1. URL này hoạt động với các SDK chính thức của OpenAI và bất kỳ client nào được cấu hình cho các dịch vụ tương thích OpenAI. Đảm bảo giữ khóa của bạn an toàn vì nó cấp quyền truy cập vào tín dụng trả trước của bạn.

Mỗi tài khoản chỉ giới hạn một khóa hoạt động, khóa này có thể được tạo lại bất cứ lúc nào. Việc tạo lại khóa sẽ thu hồi ngay lập tức khóa trước đó, vì vậy hãy cập nhật cấu hình của bạn kịp thời.

Endpoint Chat Completions

Gửi prompt văn bản đến endpoint POST /v1/chat/completions. API cung cấp một mô hình không kiểm duyệt duy nhất được xác định bởi ID uncensored. Mô hình này là một LLM trọng số mở được tinh chỉnh để trả lời mà không từ chối nội dung đối với các chủ đề hợp pháp dành cho người trưởng thành, hư cấu hoặc nghiên cứu bảo mật. Mô hình xử lý văn bản đầu vào và xuất ra văn bản, khiến nó lý tưởng cho các bước xử lý sau, tóm tắt hoặc trích xuất trong pipeline của bạn.

Cấu trúc yêu cầu của bạn với mảng messages chứa các prompt hệ thống và người dùng của bạn. API trả về phản hồi JSON chứa văn bản được tạo.

Copycurl https://api.embeddingapis.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."}]
  }'

Tích hợp Python SDK

Sử dụng thư viện Python chính thức của OpenAI để tương tác với API. Đặt base_url thành endpoint của chúng tôi và cung cấp khóa API của bạn. Cách tiếp cận này cho phép bạn tận dụng mã client hiện có với ít thay đổi nhất. Client xử lý việc tuần tự hóa và các yêu cầu mạng, trả về các phản hồi có cấu trúc mà bạn có thể phân tích cú pháp cho logic ứng dụng của mình.

Đảm bảo bạn đang sử dụng phiên bản SDK mới nhất để hỗ trợ tất cả các tính năng, bao gồm truyền phát (streaming) và gọi hàm (tool calling). ID mô hình vẫn là uncensored khi gọi completions.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.embeddingapis.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ích hợp Node SDK

Đối với môi trường JavaScript hoặc TypeScript, hãy sử dụng SDK Node.js của OpenAI. Cấu hình client với URL gốc và khóa API chính xác. Cấu hình này đảm bảo tương thích với các pipeline dựa trên Node hiện có của bạn. SDK quản lý kết nối với endpoint POST /v1/chat/completions, cho phép bạn gửi prompt và nhận các phần hoàn tất văn bản một cách hiệu quả.

Tích hợp này phù hợp cho việc xử lý văn bản phía máy chủ, chẳng hạn như tạo chú thích, kịch bản hoặc trích xuất dữ liệu từ các khối văn bản lớn.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.embeddingapis.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ản hồi truyền phát (Streaming)

Đối với các ứng dụng độ trễ thấp, hãy 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 được gửi bởi máy chủ (SSE), cung cấp token khi chúng được tạo. Điều này đặc biệt hữu ích cho các giao diện người dùng thời gian thực hoặc khi xử lý văn bản dài nơi phản hồi ngay lập tức có giá trị.

Phân tích cú pháp luồng SSE để xử lý các phản hồi từng phần. Mô hình không kiểm duyệt hỗ trợ chế độ này, cho phép bạn phản ứng với nội dung khi nó được tạo mà không cần chờ phần hoàn tất toàn bộ.

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)

Giới hạn, Lỗi và Cửa sổ ngữ cảnh

Cửa sổ ngữ cảnh hỗ trợ 100.000 token cho cả prompt và completion kết hợp. Các yêu cầu vượt quá giới hạn thân 8 MB hoặc giới hạn tốc độ 300 yêu cầu mỗi phút sẽ bị lỗi. Lỗi xác thực trả về mã trạng thái 401 nếu khóa không hợp lệ. Khi tín dụng trả trước cạn kiệt, các yêu cầu sẽ bị lỗi vì không còn tín dụng nào để trang trải việc sử dụng token. Mã trạng thái 429 cho biết đã đạt giới hạn tốc độ.

Luôn áp dụng một giới hạn nội dung cứng: các yêu cầu chứa nội dung khiêu dâm liên quan đến trẻ vị thành niên sẽ bị chặn, bất kể các cài đặt khác. Tất cả các nội dung người trưởng thành hợp pháp khác đều được xử lý mà không từ chối.