Hướng dẫn bắt đầu nhanh API Dolphin AI

Base URL và Xác thực

Xác thực yêu cầu một khóa API đơn lẻ được truyền trong Authorization header.

Mỗi yêu cầu phải nhắm vào URL cơ sở https://api.dolphinaisincensura.com/v1 và bao gồm khóa như Bearer YOUR_API_KEY.

Cấu hình này hoạt động với bất kỳ SDK tương thích OpenAI nào bằng cách chỉ cần cập nhật base_url cấu hình.

Lỗi như 401 cho biết khóa không hợp lệ hoặc thiếu, trong khi 402 cho biết tín dụng trả trước không đủ.

Copycurl https://api.dolphinaisincensura.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the python imports for requests and json"}]
  }'

Gửi Hoàn thành Trò chuyện

Gửi yêu cầu POST đến /v1/chat/completions với một model field được đặt thành uncensored.

Bao gồm một messages mảng chứa lịch sử prompt của bạn để duy trì ngữ cảnh hội thoại.

API trả về phản hồi văn bản trực tiếp trong content field của lựa chọn đầu tiên.

Cách tiếp cận mô hình đơn lẻ này loại bỏ phí proxy và đảm bảo giá dự đoán được ở mức $0.15 cho mỗi 1M token đầu vào.

Copyfrom openai import OpenAI

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

Xử lý phát trực tiếp (SSE)

Bật phát trực tiếp bằng cách đặt stream để true trong phần tải trọng yêu cầu.

Máy chủ phản hồi bằng các Sự kiện được gửi qua máy chủ (SSE) để cung cấp từng token một cách gia tăng.

Phân tích từng chunk SSE để trích xuất văn bản được tạo mà không cần chờ phản hồi đầy đủ.

Thống kê sử dụng token được cung cấp trong chunk cuối cùng của luồng để tính phí chính xác.

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)

Function Calling và chế độ JSON

Sử dụng tools tham số để xác định lược đồ hàm cho việc trích xuất dữ liệu có cấu trúc.

Đặt response_format để {"type": "json_object"} để bắt buộc đầu ra JSON nghiêm ngặt cho việc phân tích cú pháp đáng tin cậy.

Chỉ định temperature và top_p để kiểm soát sự sáng tạo so với tính xác định trong kết quả của bạn.

Những tính năng này cho phép bạn xây dựng các tác nhân tự trị tương tác với API hoặc cơ sở dữ liệu bên ngoài.

Copyimport OpenAI from "openai";

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

Hiểu về Giới hạn Token và Ngữ cảnh

Cửa sổ ngữ cảnh hỗ trợ 100.000 token cho tổng cộng cả prompt và completion.

Tối đa 16.000 token đầu ra cho mỗi yêu cầu, hoặc 2.048 nếu max_tokens chưa được đặt.

Giới hạn tốc độ cho phép 300 yêu cầu mỗi phút và 8 yêu cầu đồng thời cho mỗi khóa API.

Yêu cầu vượt quá giới hạn kích thước phần thân 8 MB hoặc chạm vào giới hạn đồng thời trả về lỗi 429.

Các phản hồi lỗi và từ chối không tiêu tốn tín dụng trả trước của bạn.

Giới hạn tốc độ và Độ đồng thời

Mỗi khóa API được giới hạn ở 300 yêu cầu mỗi phút và 8 kết nối đồng thời.

Mã trạng thái 429 cho biết bạn đã vượt quá các ngưỡng về độ đồng thời hoặc giới hạn tốc độ này.

Bạn có thể tạo khóa mới để thay thế khóa hiện có, nhưng mỗi tài khoản chỉ được phép một khóa hoạt động.

Theo dõi mức sử dụng qua các tiêu đề phản hồi để đảm bảo nằm trong giới hạn 8 MB cho phần thân yêu cầu.