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

Base URL và Xác thực

Khóa API của bạn xác thực mọi yêu cầu đến endpoint của chúng tôi. Sử dụng URL cơ sở HTTPS://api.apidolphin.com/v1 với bất kỳ SDK tương thích OpenAI nào. Định danh mô hình là "uncensored" cho tất cả các phần hoàn thành. Cấu hình này đảm bảo mã của bạn hoạt động với cơ sở hạ tầng của chúng tôi mà không cần sửa đổi.

Chúng tôi hỗ trợ các tham số tiêu chuẩn như temperature và top_p. Bạn có thể bật chế độ JSON hoặc gọi hàm khi cần. Lỗi và từ chối không tiêu thụ tín dụng trả trước của bạn. Chỉ có mức sử dụng token thực tế mới được tính phí theo tỷ lệ minh bạch của chúng tôi.

Gửi Yêu cầu đầu tiên của bạn

Gửi yêu cầu hoàn tất trò chuyện cơ bản để xác minh kết nối của bạn. Sử dụng lệnh curl bên dưới để kiểm tra điểm cuối. Thay thế YOUR_API_KEY bằng khóa thực tế của bạn từ bảng điều khiển. Phản hồi trả về đầu ra văn bản của mô hình.

Yêu cầu này sử dụng định dạng OpenAI tiêu chuẩn. Bạn có thể điều chỉnh system prompt hoặc tin nhắn của người dùng theo yêu cầu. API trả về một đối tượng phản hồi chứa văn bản được tạo. Hãy xác minh đầu ra khớp với kỳ vọng của bạn trước khi mở rộng quy mô.

Cách sử dụng ví dụ:

Copycurl https://api.apidolphin.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Convert the attached JSON payload to YAML format"}]
  }'

Tích hợp SDK Python

Sử dụng thư viện Python chính thức của OpenAI để tương tác với API của chúng tôi. Đặt URL cơ sở và khóa API trong cấu hình máy khách của bạn. Đoạn mã bên dưới minh họa một lệnh tạo văn bản đơn giản.

Cài đặt thư viện qua pip. Sau đó, khởi tạo client với thông tin xác thực của bạn. Gọi chat.completions.create với tên model "uncensored". Cách tiếp cận này giữ cho mã của bạn di động giữa các nhà cung cấp LLM khác nhau.

Ví dụ mã:

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apidolphin.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 SDK Node

SDK Node tuân theo cùng mẫu cấu hình. Khởi tạo khách hàng OpenAI với URL cơ sở và khóa của bạn. Gửi yêu cầu hoàn tất bằng mô hình "uncensored". Phương pháp này lý tưởng cho các ứng dụng phía máy chủ.

Đảm bảo bạn xử lý dữ liệu phản hồi đúng cách. API trả về một đối tượng hoàn tất tiêu chuẩn. Bạn có thể truy cập văn bản được tạo từ đối tượng phản hồi. Cấu hình này hoạt động với Express, Fastify hoặc bất kỳ framework Node.js nào.

Ví dụ triển khai:

Copyimport OpenAI from "openai";

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

Xử lý Phản hồi Luồng

Bật chế độ streaming để phân phối token theo thời gian thực. Đặt tham số stream thành true trong yêu cầu của bạn. API trả về các chunk dữ liệu ngay khi chúng được tạo ra. Điều này giảm độ trễ cảm nhận cho người dùng cuối.

Xử lý từng đoạn trong logic ứng dụng của bạn. Đoạn cuối cùng chứa chi tiết sử dụng token cuối cùng. Streaming hoạt động với tất cả các tham số được hỗ trợ. Nó lý tưởng cho giao diện trò chuyện và tạo văn bản trực tiếp.

Ví dụ về streaming:

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

Tài khoản của bạn có cửa sổ ngữ cảnh 100.000 token. Điều này bao gồm cả token đầu vào và đầu ra. Số lượng token tối đa cho mỗi yêu cầu là 16.000 token. Nếu bạn không đặt max_tokens, giới hạn là 2.048 token.

Giới hạn tốc độ cho phép 300 yêu cầu mỗi phút cho mỗi khóa. Bạn có thể có 8 yêu cầu đồng thời. Giới hạn kích thước thân yêu cầu là 8 MB. Xử lý HTTP 401 cho khóa không hợp lệ, 402 cho không đủ tín dụng và 429 cho giới hạn tốc độ. Lỗi là miễn phí, vì vậy bạn có thể thử lại mà không tốn chi phí.